chiark - git - mdw - sod/blob - doc/module.tex

   1 %%% -*-latex-*-
   2 %%%
   3 %%% Modules
   4 %%%
   5 %%% (c) 2015 Straylight/Edgeware
   6 %%%
   7
   8 %%%----- Licensing notice ---------------------------------------------------
   9 %%%
  10 %%% This file is part of the Sensible Object Design, an object system for C.
  11 %%%
  12 %%% SOD is free software; you can redistribute it and/or modify
  13 %%% it under the terms of the GNU General Public License as published by
  14 %%% the Free Software Foundation; either version 2 of the License, or
  15 %%% (at your option) any later version.
  16 %%%
  17 %%% SOD is distributed in the hope that it will be useful,
  18 %%% but WITHOUT ANY WARRANTY; without even the implied warranty of
  19 %%% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  20 %%% GNU General Public License for more details.
  21 %%%
  22 %%% You should have received a copy of the GNU General Public License
  23 %%% along with SOD; if not, write to the Free Software Foundation,
  24 %%% Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  25
  26 \chapter{Modules} \label{ch:module}
  27
  28 %%%--------------------------------------------------------------------------
  29
  30 \begin{describe}{fun}{add-module-binding @<symbol> @<thunk>}
  31 \end{describe}
  32
  33 \begin{describe}{mac}{define-module-var @<name> @<value-form> @<doc-string>}
  34 \end{describe}
  35
  36 \begin{describe}{mac}
  37     {with-module-environment (@[@<module>@]) @<declaration>^* @<form>^*}
  38 \end{describe}
  39
  40 \begin{describe}{fun}{add-clear-the-decks-function @<symbol> @<thunk>}
  41 \end{describe}
  42
  43 \begin{describe}{mac}
  44   {define-clear-the-decks @<symbol>
  45     @[[ @<declaration>^* @! @<doc-string> @]]
  46     @<form>^*}
  47 \end{describe}
  48
  49 \begin{describe}{fun}{clear-the-decks}
  50 \end{describe}
  51
  52 \begin{describe}{cls}
  53     {module () \&key :name :pset :items :dependencies :variables :state}
  54 \end{describe}
  55
  56 \begin{describe*}
  57     {\dhead{gf}{module-name @<module> @> @<pathname>}
  58      \dhead{gf}{module-pset @<module> @> @<pset>}
  59      \dhead{gf}{module-errors @<module> @> @<integer>}
  60      \dhead{gf}{module-items @<module> @> @<list>}
  61      \dhead{gf}{setf (module-items @<module>) @<list>}
  62      \dhead{gf}{module-dependencies @<module> @> @<list>}
  63      \dhead{gf}{setf (module-dependencies @<module>) @<list>}
  64      \dhead{gf}{module-state @<module> @> @<symbol>}
  65      \dhead{gf}{setf (module-state @<module>) @<keyword>}}
  66 \end{describe*}
  67
  68 \begin{describe}{var}{*module*}
  69 \end{describe}
  70
  71 \begin{describe}{gf}{module-import @<object>}
  72 \end{describe}
  73
  74 \begin{describe}{gf}{add-to-module @<module> @<item>}
  75 \end{describe}
  76
  77 \begin{describe}{gf}{finalize-module @<module>}
  78 \end{describe}
  79
  80 \begin{describe}{mac}
  81     {define-module
  82         (@<name> @[[ :truename @<pathname> @! :location @<floc> @]])
  83       @<declaration>^*
  84       @<form>^*
  85      \nlret @<module>}
  86 \end{describe}
  87
  88 \begin{describe}{mac}{with-temporary-module () @<declaration>^* @<body>^*}
  89 \end{describe}
  90
  91 \begin{describe}{cls}{type-item () \&key :name}
  92 \end{describe}
  93
  94 \begin{describe}{cls}
  95     {code-fragment-item () \&key :fragment :reason :name :constraints}
  96 \end{describe}
  97
  98 \begin{describe*}
  99     {\dhead{gf}{code-fragment @<fragment-item> @> @<fragment>}
 100      \dhead{gf}{code-fragment-name @<fragment-item> @> @<name>}
 101      \dhead{gf}{code-fragment-reason @<fragment-item> @> @<keyword>}
 102      \dhead{gf}{code-fragment-constraints @<fragment-item> @> @<list>}}
 103 \end{describe*}
 104
 105 \begin{describe}{var}{*module-dirs*}
 106 \end{describe}
 107
 108 \begin{describe}{fun}{find-file @<home> @<name> @<what> @<thunk>}
 109 \end{describe}
 110
 111 \begin{describe}{fun}
 112     {read-module @<pathname> \&key :truename :location @> @<module>}
 113 \end{describe}
 114
 115 \begin{describe}{plug}{module @<scanner> @<pset>}
 116 \end{describe}
 117
 118 \begin{describe}{plug}{class-item @<scanner> @<class> @<pset>}
 119 \end{describe}
 120
 121 \begin{describe}{var}{*builtin-module*}
 122 \end{describe}
 123
 124 \begin{describe}{fun}{make-builtin-module @> @<module>}
 125 \end{describe}
 126
 127 %%%----- That's all, folks --------------------------------------------------
 128
 129 %%% Local variables:
 130 %%% mode: LaTeX
 131 %%% TeX-master: "sod.tex"
 132 %%% TeX-PDF-mode: t
 133 %%% End: