From: <cli...@li...> - 2004-12-01 04:11:16
|
Send clisp-cvs mailing list submissions to cli...@li... To subscribe or unsubscribe via the World Wide Web, visit https://lists.sourceforge.net/lists/listinfo/clisp-cvs or, via email, send a message with subject or body 'help' to cli...@li... You can reach the person managing the list at cli...@li... When replying, please edit your Subject line so it is more specific than "Re: Contents of clisp-cvs digest..." CLISP CVS commits for today Today's Topics: 1. clisp/doc cl-ent.xml,1.73,1.74 (Sam Steingold) 2. clisp/doc unix-ent.xml,1.55,1.56 (Sam Steingold) 3. clisp/doc impnotes.xml.in,1.73,1.74 impext.xml,1.293,1.294 impent.xml,1.180,1.181 impbyte.xml,1.60,1.61 (Sam Steingold) --__--__-- Message: 1 From: Sam Steingold <sd...@us...> To: cli...@li... Subject: clisp/doc cl-ent.xml,1.73,1.74 Date: Tue, 30 Nov 2004 15:35:07 +0000 Reply-To: cli...@li... Update of /cvsroot/clisp/clisp/doc In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv10080 Modified Files: cl-ent.xml Log Message: (docbook, html, xml): new entities Index: cl-ent.xml =================================================================== RCS file: /cvsroot/clisp/clisp/doc/cl-ent.xml,v retrieving revision 1.73 retrieving revision 1.74 diff -u -d -r1.73 -r1.74 --- cl-ent.xml 29 Nov 2004 17:02:35 -0000 1.73 +++ cl-ent.xml 30 Nov 2004 15:35:03 -0000 1.74 @@ -155,6 +155,9 @@ <!ENTITY perl "<ulink url='http://www.perl.com'><command>Perl</command></ulink>"> <!ENTITY python "<ulink url='http://python.org/'><command>Python</command></ulink>"> <!ENTITY ieee-bfp "<ulink url='http://grouper.ieee.org/groups/754/'>IEEE 754</ulink>"> +<!ENTITY docbook "<ulink url='http://www.docbook.org/'>DocBook</ulink>"> +<!ENTITY html "<ulink url='http://www.w3.org/MarkUp/'>HTML</ulink>"> +<!ENTITY xml "<ulink url='http://www.w3.org/XML/'>XML</ulink>"> <!-- *** CLHS - Common Lisp HyperSpec *** --> --__--__-- Message: 2 From: Sam Steingold <sd...@us...> To: cli...@li... Subject: clisp/doc unix-ent.xml,1.55,1.56 Date: Tue, 30 Nov 2004 16:07:29 +0000 Reply-To: cli...@li... Update of /cvsroot/clisp/clisp/doc In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv18556 Modified Files: unix-ent.xml Log Message: (man): new entity Index: unix-ent.xml =================================================================== RCS file: /cvsroot/clisp/clisp/doc/unix-ent.xml,v retrieving revision 1.55 retrieving revision 1.56 diff -u -d -r1.55 -r1.56 --- unix-ent.xml 26 Oct 2004 00:21:47 -0000 1.55 +++ unix-ent.xml 30 Nov 2004 16:07:26 -0000 1.56 @@ -109,6 +109,7 @@ <!ENTITY iconv-u "<ulink url='&unix-u;/iconv.html'><command>iconv</command></ulink>"> <!ENTITY ls "<ulink url='&unix-u;/ls.html'><command>ls</command></ulink>"> <!ENTITY make "<ulink url='&unix-u;/make.html'><command>make</command></ulink>"> +<!ENTITY man "<ulink url='&unix-u;/man.html'><command>man</command></ulink>"> <!ENTITY sh "<ulink url='&unix-u;/sh.html'><command>/bin/sh</command></ulink>"> <!ENTITY uname-u "<ulink url='&unix-u;/uname.html'><command>uname</command></ulink>"> --__--__-- Message: 3 From: Sam Steingold <sd...@us...> To: cli...@li... Subject: clisp/doc impnotes.xml.in,1.73,1.74 impext.xml,1.293,1.294 impent.xml,1.180,1.181 impbyte.xml,1.60,1.61 Date: Tue, 30 Nov 2004 16:08:27 +0000 Reply-To: cli...@li... Update of /cvsroot/clisp/clisp/doc In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv18769/doc Modified Files: impnotes.xml.in impext.xml impent.xml impbyte.xml Log Message: use #P"" for abstract file names and just the name for real names Index: impnotes.xml.in =================================================================== RCS file: /cvsroot/clisp/clisp/doc/impnotes.xml.in,v retrieving revision 1.73 retrieving revision 1.74 diff -u -d -r1.73 -r1.74 --- impnotes.xml.in 18 Nov 2004 22:13:00 -0000 1.73 +++ impnotes.xml.in 30 Nov 2004 16:08:22 -0000 1.74 @@ -121,6 +121,8 @@ <row><entry>&lalist; keyword</entry><entry>&key-amp;</entry></row> <row><entry>Declaration</entry><entry>&ftype-dec;</entry></row> <row><entry>Package</entry><entry>&clu-pac;</entry></row> + <row><entry>Real file</entry><entry>&config-lisp;</entry></row> + <row><entry>Abstract file</entry><entry>&c-file;</entry></row> <row><entry>Code (you are likely to type it)</entry> <entry><code>(&cons; 1 2)</code></entry></row> <row><entry>Data (&clisp; is likely to print it)</entry> Index: impbyte.xml =================================================================== RCS file: /cvsroot/clisp/clisp/doc/impbyte.xml,v retrieving revision 1.60 retrieving revision 1.61 diff -u -d -r1.60 -r1.61 --- impbyte.xml 29 Nov 2004 19:36:00 -0000 1.60 +++ impbyte.xml 30 Nov 2004 16:08:24 -0000 1.61 @@ -7,19 +7,22 @@ <section id="scr-file-types"><title>File Types</title> <variablelist> -<varlistentry><term><filename>*.d</filename></term> +<varlistentry><term><filename>#P"*.d"</filename></term> <listitem><simpara>The source files for unpreprocessed &c-lang; code.</simpara></listitem></varlistentry> -<varlistentry><term><filename>*.c</filename></term> +<varlistentry><term>&c-file;</term> <listitem><simpara>The &c-lang; code after preprocessing by <command>comment5</command> and <command>varbrace</command>. </simpara></listitem></varlistentry> -<varlistentry><term><filename>*.lisp</filename></term> +<varlistentry><term>&lisp-file;</term> <listitem><simpara>The source files for Lisp code.</simpara></listitem></varlistentry> -<varlistentry><term><filename>*.fas</filename></term> +<varlistentry><term><filename>#P"*.fas"</filename></term> <listitem><simpara>Compiled lisp code (platform-independent). </simpara></listitem></varlistentry> +<varlistentry><term>&lib-file;</term> + <listitem><simpara>Lisp <quote>header</quote>, produced by + &compile-file; and used by &require;</simpara></listitem></varlistentry> </variablelist> </section> @@ -32,10 +35,10 @@ <variablelist> <varlistentry><term><filename>lispbibl.d</filename></term> <listitem><simpara>main include file</simpara></listitem></varlistentry> -<varlistentry><term><filename>fsubr.d</filename></term> +<varlistentry id="fsubr-d"><term>&fsubr-d;</term> <listitem><simpara>list of all built-in special forms </simpara></listitem></varlistentry> -<varlistentry><term><filename>subr.d</filename></term> +<varlistentry id="subr-d"><term>&subr-d;</term> <listitem><simpara>list of all built-in functions </simpara></listitem></varlistentry> <varlistentry><term><filename>pseudofun.d</filename></term> @@ -44,10 +47,10 @@ <varlistentry><term><filename>constpack.d</filename></term> <listitem><simpara>list of packages accessed by &c-lang; code </simpara></listitem></varlistentry> -<varlistentry><term><filename>constsym.d</filename></term> +<varlistentry id="constsym-d"><term>&constsym-d;</term> <listitem><simpara>list of symbols accessed by &c-lang; code </simpara></listitem></varlistentry> -<varlistentry><term><filename>constobj.d</filename></term> +<varlistentry id="constobj-d"><term>&constobj-d;</term> <listitem><simpara>list of miscellaneous objects accessed by &c-lang; code </simpara></listitem></varlistentry> <varlistentry><term><filename>unix.d</filename></term> @@ -68,14 +71,14 @@ <section id="src-modules"><title>Modules</title> <variablelist> -<varlistentry><term><filename>spvw.d</filename></term> +<varlistentry id="spvw-d"><term>&spvw-d;</term> <listitem><para>Memory management (&gc;ion), startup; some OS interface. <variablelist><varlistentry><term><filename>avl.d</filename></term> <listitem><simpara>An implementation of AVL (Adelson-Velskii and Landis) trees.</simpara></listitem></varlistentry> <varlistentry><term><filename>sort.d</filename></term> <listitem><simpara>A sorting routine.</simpara></listitem></varlistentry> - <varlistentry><term><filename>subrkw.d</filename></term> + <varlistentry id="subrkw-d"><term>&subrkw-d;</term> <listitem><simpara>The list of all built-in functions with keywords in &lalist;.</simpara></listitem></varlistentry></variablelist> </para></listitem></varlistentry> @@ -88,9 +91,9 @@ <varlistentry><term><filename>spvwtabo.d</filename></term> <listitem><simpara>The table of miscellaneous objects accessed by &c-lang; code.</simpara></listitem></varlistentry> -<varlistentry><term><filename>eval.d</filename></term> +<varlistentry id="eval-d"><term>&eval-d;</term> <listitem><para>Evaluator (form interpreter) and bytecode interpreter. - <variablelist><varlistentry><term><filename>bytecode.d</filename></term> + <variablelist><varlistentry id="bytecode-d"><term>&bytecode-d;</term> <listitem><simpara>List of bytecodes.</simpara></listitem></varlistentry> </variablelist></para></listitem></varlistentry> <varlistentry><term><filename>control.d</filename></term> @@ -337,7 +340,7 @@ <section id="src-lisp"><title>Lisp source files</title> <variablelist> -<varlistentry><term><filename>init.lisp</filename></term> +<varlistentry id="init-lisp"><term>&init-lisp;</term> <listitem><simpara>the first file to be loaded during bootstrapping, loads everything else</simpara></listitem></varlistentry> <varlistentry><term><filename>defseq.lisp</filename></term> @@ -406,10 +409,10 @@ <varlistentry><term><filename>trace.lisp</filename></term> <listitem><simpara><link linkend="trace">tracer</link> </simpara></listitem></varlistentry> -<varlistentry><term><filename>macros3.lisp</filename> (optional)</term> +<varlistentry id="macros3-lisp"><term>¯os3-lisp; (optional)</term> <listitem><simpara>the macros &letf;, &letf-star; and ðe; </simpara></listitem></varlistentry> -<varlistentry><term><filename>config.lisp</filename></term> +<varlistentry id="config-lisp"><term>&config-lisp;</term> <listitem><para>(user written) site-dependent configuration, may be a link to one of the following:<variablelist> <varlistentry><term><filename>cfgsunux.lisp</filename></term> @@ -567,6 +570,9 @@ <varlistentry><term><filename>edit.lisp</filename> (optional)</term> <listitem><simpara>the screen editor (&ed;), &uncompile; </simpara></listitem></varlistentry> +<varlistentry id="inspect-lisp"><term>&inspect-lisp;</term> + <listitem><simpara>implements &inspect; (tty and &http; frontends) +</simpara></listitem></varlistentry> <varlistentry><term><filename>threads.lisp</filename></term> <listitem><simpara>MT interface</simpara></listitem></varlistentry> <varlistentry><term><filename>spanish.lisp</filename></term> @@ -589,7 +595,7 @@ <section id="src-doc"><title>Documentation</title> <variablelist> -<varlistentry><term><filename>src/NEWS</filename></term> +<varlistentry id="src-news"><term>&news;</term> <listitem><simpara>the list of the user-visible changes </simpara></listitem></varlistentry> <varlistentry><term><filename>src/_README</filename></term> @@ -601,19 +607,19 @@ </simpara></listitem></varlistentry> </variablelist></para></listitem></varlistentry> <varlistentry><term><filename>doc/clisp.xml.in</filename></term> - <listitem><simpara>Docbook sources for the &clisp; manual page + <listitem><simpara>&docbook;/&xml; sources for the &clisp; manual page </simpara></listitem></varlistentry> <varlistentry><term><filename>src/_clisp.1</filename></term> - <listitem><simpara>the distribution's manual page, - generated from <filename>doc/clisp.xml.in</filename> at build time -</simpara></listitem></varlistentry> + <listitem><simpara>the platform-specific &man; manual page, + generated from <filename>doc/clisp.xml.in</filename> + at <emphasis>build</emphasis> time</simpara></listitem></varlistentry> <varlistentry><term><filename>src/_clisp.html</filename></term> - <listitem><simpara>the distribution's manual page in HTML format, - generated from <filename>doc/clisp.xml.in</filename> at build time -</simpara></listitem></varlistentry> + <listitem><simpara>the platform-specific &html; manual page, + generated from <filename>doc/clisp.xml.in</filename> + at <emphasis>build</emphasis> time</simpara></listitem></varlistentry> <varlistentry><term><filename>doc/impnotes.xml.in</filename></term> - <listitem><para>the master file for these implementation notes, - includes the following files<variablelist> + <listitem><para>the master &docbook;/&xml; file for these + implementation notes; includes the following files<variablelist> <varlistentry><term><filename>doc/cl-ent.xml</filename></term> <listitem><simpara>&clisp;-independent general &cl;-related entities </simpara></listitem></varlistentry> @@ -652,9 +658,9 @@ </simpara></listitem></varlistentry> </variablelist></para></listitem></varlistentry> <varlistentry><term><filename>doc/impnotes.html</filename></term> - <listitem><simpara>the implementation notes, - generated from <filename>doc/impnotes.xml.in</filename> at release time -</simpara></listitem></varlistentry> + <listitem><simpara>these &html; implementation notes, + generated from <filename>doc/impnotes.xml.in</filename> + at <emphasis>release</emphasis> time</simpara></listitem></varlistentry> </variablelist></section> <section id="src-i18n"><title>Internationalization</title> @@ -721,8 +727,8 @@ <para>Knowing that most &malloc; implementations are buggy and/or slow, and because &clisp; needs to perform &gc;ion, &clisp; has its -own memory management subsystem in -files <filename>#P"spvw*.d"</filename>.</para> +own memory management subsystem in files <filename>spvw*.d</filename>, +see <xref linkend="src-modules"/>.</para> </section> @@ -1100,23 +1106,23 @@ <itemizedlist><listitem><simpara>add the <function>LISPFUN</function> form and the implementation there;</simpara></listitem> <listitem><simpara>add the <function>LISPFUN</function> header to - file <filename>#P"subr.d"</filename>;</simpara></listitem> + file &subr-d;;</simpara></listitem> <listitem><simpara>declare the function name in file - <filename>#P"constsym.d"</filename> in the appropriate package + &constsym-d; in the appropriate package (probably &ext-pac;, if there is no specific package); </simpara></listitem> <listitem><simpara>if your function accepts keyword arguments, then an appropriate pair of forms must be added - to <filename>#P"subrkw.d"</filename> and you must make sure that the - keyword symbols are declared in <filename>#P"constsym.d"</filename>; + to &subrkw-d; and you must make sure that the + keyword symbols are declared in &constsym-d;; </simpara></listitem> <listitem><simpara>export your function name from the appropriate - package in file <filename>#P"init.lisp"</filename>;</simpara></listitem> + package in file &init-lisp;;</simpara></listitem> <listitem><simpara>when you are done, you should run <command>make check-sources</command> in your build directory: this will check that the definitions (source files) and the declarations - (<filename>#P"subr.d"</filename>, <filename>#P"subrkw.d"</filename> - and <filename>#P"fsubr.d"</filename>) are in sync.</simpara></listitem> + (&subr-d;, &subrkw-d; + and &fsubr-d;) are in sync.</simpara></listitem> </itemizedlist></para> <warning><para>Be very careful with the <emphasis>GC-unsafe</emphasis> @@ -1132,15 +1138,14 @@ <para>If you must be able to access the Lisp variable in the &c-lang; code, follow these steps: <itemizedlist><listitem><simpara>declare the variable name - in <filename>#P"constsym.d"</filename> in the appropriate package + in &constsym-d; in the appropriate package (probably &custom-pac;, if there is no specific package); </simpara></listitem> <listitem><simpara>add a <function>define_variable()</function> call in function <function>init_symbol_values()</function> - in file <filename>#P"spvw.d"</filename>;</simpara></listitem> + in file &spvw-d;;</simpara></listitem> <listitem><simpara>export your variable name from the appropriate - package in file <filename>#P"init.lisp"</filename>; -</simpara></listitem></itemizedlist></para> + package in file &init-lisp;;</simpara></listitem></itemizedlist></para> </section> <section id="recompile"><title>Recompilation.</title> @@ -1153,21 +1158,21 @@ <para>On the other hand, if you change any of the following files: <simplelist> - <member><filename>#P"constobj.d"</filename></member> - <member><filename>#P"constsym.d"</filename></member> - <member><filename>#P"fsubr.d"</filename></member> - <member><filename>#P"subr.d"</filename></member> - <member><filename>#P"subrkw.d"</filename></member></simplelist> + <member>&constobj-d;</member> + <member>&constsym-d;</member> + <member>&fsubr-d;</member> + <member>&subr-d;</member> + <member>&subrkw-d;</member></simplelist> your &lispinit; will <emphasis>have</emphasis> to be re-dumped.</para> <warning id="byte-version"><para>If you change the signature of any system function mentioned in the <varname>FUNTAB</varname> arrays in - file <filename>#P"eval.d"</filename>, all the &fasl-file; files will + file &eval-d;, all the &fasl-file; files will become obsolete and will need to be recompiled. You will need to add a note to that effect to - the <filename>#P"NEWS"</filename> file + the &news; file and augment the object <literal>version</literal> in - file <filename>#P"constsym.d"</filename>. + file &constsym-d;. Please try to avoid this as much as possible.</para></warning> </section> @@ -1439,8 +1444,7 @@ some number of operands.</para> <para>The conversion from a byte (in the range 0..255) to the opcode is -performed by lookup in the table contained in the file -<filename>#P"bytecode.d"</filename>.</para> +performed by lookup in the table contained in the file &bytecode-d;.</para> <para>There are the following types of operands, denoted by different letters: Index: impext.xml =================================================================== RCS file: /cvsroot/clisp/clisp/doc/impext.xml,v retrieving revision 1.293 retrieving revision 1.294 diff -u -d -r1.293 -r1.294 --- impext.xml 28 Nov 2004 01:00:56 -0000 1.293 +++ impext.xml 30 Nov 2004 16:08:22 -0000 1.294 @@ -1466,8 +1466,8 @@ <section id="macros3"><title>Additional Fancy Macros</title> <para>&clisp; comes with some extension macros, mostly defined in the - file <filename>macros3.lisp</filename> and loaded from the file - <filename>init.lisp</filename> during &make;:</para> + file ¯os3-lisp; and loaded from the file &init-lisp; during + &make;:</para> <formalpara id="ethe"><title>Macro ðe;</title> <para><code>(ðe; &val-type-r; &form-r;)</code> @@ -1563,7 +1563,7 @@ <formalpara id="html-http-output"> <title>Macros <function>EXT:WITH-HTML-OUTPUT</function> and <function>EXT:WITH-HTTP-OUTPUT</function></title> -<para>Defined in <filename>inspect.lisp</filename>, these macros are useful +<para>Defined in &inspect-lisp;, these macros are useful for the rudimentary &http; server defined there.</para></formalpara> </section> Index: impent.xml =================================================================== RCS file: /cvsroot/clisp/clisp/doc/impent.xml,v retrieving revision 1.180 retrieving revision 1.181 diff -u -d -r1.180 -r1.181 --- impent.xml 28 Nov 2004 01:01:10 -0000 1.180 +++ impent.xml 30 Nov 2004 16:08:24 -0000 1.181 @@ -703,11 +703,11 @@ <!ENTITY mem-file "<filename>#P".mem"</filename>"> <!ENTITY c-file "<filename>#P".c"</filename>"> <!ENTITY lib-file "<link linkend='require'><filename>#P".lib"</filename></link>"> -<!ENTITY config-file "<link linkend='customize'><filename>#P"config.lisp"</filename></link>"> -<!ENTITY make-file "<filename>#P"Makefile"</filename>"> -<!ENTITY lispinit "<link linkend='image'><filename>#P"lispinit.mem"</filename></link>"> +<!ENTITY config-file "<link linkend='customize'><filename>config.lisp</filename></link>"> +<!ENTITY make-file "<filename>Makefile</filename>"> +<!ENTITY lispinit "<link linkend='image'><filename>lispinit.mem</filename></link>"> <!ENTITY lisp-run "<filename>lisp.run</filename>"> -<!ENTITY clisp-h "<link linkend='clisp-h'><filename>#P"clisp.h"</filename></link>"> +<!ENTITY clisp-h "<link linkend='clisp-h'><filename>clisp.h</filename></link>"> <!-- *** pathnames *** --> <!ENTITY file-star "<filename>"*"</filename>"> @@ -755,7 +755,20 @@ <!ENTITY foo-f "<filename>#P"foo"</filename>"> <!ENTITY bar-f "<filename>#P"bar"</filename>"> <!ENTITY foolisp-f "<filename>#P"foo.lisp"</filename>"> - +<!-- *** clisp sources *** --> +<!ENTITY bytecode-d "<link linkend='bytecode-d'><filename>bytecode.d</filename></link>"> +<!ENTITY config-lisp "<link linkend='config-lisp'><filename>config.lisp</filename></link>"> +<!ENTITY constobj-d "<link linkend='constobj-d'><filename>constobj.d</filename></link>"> +<!ENTITY constsym-d "<link linkend='constsym-d'><filename>constsym.d</filename></link>"> +<!ENTITY eval-d "<link linkend='eval-d'><filename>eval.d</filename></link>"> +<!ENTITY fsubr-d "<link linkend='fsubr-d'><filename>fsubr.d</filename></link>"> +<!ENTITY init-lisp "<link linkend='init-lisp'><filename>init.lisp</filename></link>"> +<!ENTITY inspect-lisp "<link linkend='inspect-lisp'><filename>inspect.lisp</filename></link>"> +<!ENTITY macros3-lisp "<link linkend='macros3-lisp'><filename>macros3.lisp</filename></link>"> +<!ENTITY news "<link linkend='src-news'><filename>src/NEWS</filename></link>"> +<!ENTITY spvw-d "<link linkend='spvw-d'><filename>spvw.d</filename></link>"> +<!ENTITY subr-d "<link linkend='subr-d'><filename>subr.d</filename></link>"> +<!ENTITY subrkw-d "<link linkend='subrkw-d'><filename>subrkw.d</filename></link>"> <!-- *** shortcuts *** --> <!ENTITY signed-byte-16 "<literal role='type'>(&signed-byte-t; 16)</literal>"> --__--__-- _______________________________________________ clisp-cvs mailing list cli...@li... https://lists.sourceforge.net/lists/listinfo/clisp-cvs End of clisp-cvs Digest |