CLISP - an ANSI Common Lisp

Email Archive: clisp-devel (read-only)

2000:	_Jan (81)	_Feb (55)	_Mar (459)	_Apr (159)	_May (126)	_Jun (69)	_Jul (48)	_Aug (29)	_Sep (106)	_Oct (76)	_Nov (155)	_Dec (161)
2001:	_Jan (122)	_Feb (150)	_Mar (294)	_Apr (124)	_May (197)	_Jun (266)	_Jul (111)	_Aug (259)	_Sep (163)	_Oct (142)	_Nov (101)	_Dec (86)
2002:	_Jan (187)	_Feb (108)	_Mar (274)	_Apr (157)	_May (346)	_Jun (242)	_Jul (345)	_Aug (187)	_Sep (263)	_Oct (69)	_Nov (30)	_Dec (76)
2003:	_Jan (125)	_Feb (191)	_Mar (87)	_Apr (69)	_May (107)	_Jun (66)	_Jul (112)	_Aug (161)	_Sep (184)	_Oct (137)	_Nov (28)	_Dec (61)
2004:	_Jan (148)	_Feb (99)	_Mar (365)	_Apr (225)	_May (311)	_Jun (204)	_Jul (95)	_Aug (214)	_Sep (256)	_Oct (290)	_Nov (239)	_Dec (152)
2005:	_Jan (253)	_Feb (183)	_Mar (178)	_Apr (88)	_May (175)	_Jun (195)	_Jul (122)	_Aug (81)	_Sep (119)	_Oct (200)	_Nov (110)	_Dec (179)
2006:	_Jan (154)	_Feb (64)	_Mar (55)	_Apr (69)	_May (66)	_Jun (64)	_Jul (80)	_Aug (59)	_Sep (62)	_Oct (90)	_Nov (132)	_Dec (106)
2007:	_Jan (58)	_Feb (51)	_Mar (59)	_Apr (19)	_May (33)	_Jun (52)	_Jul (15)	_Aug (50)	_Sep (41)	_Oct (259)	_Nov (323)	_Dec (136)
2008:	_Jan (205)	_Feb (128)	_Mar (203)	_Apr (126)	_May (307)	_Jun (166)	_Jul (259)	_Aug (181)	_Sep (217)	_Oct (265)	_Nov (256)	_Dec (132)
2009:	_Jan (104)	_Feb (81)	_Mar (27)	_Apr (21)	_May (85)	_Jun (237)	_Jul (243)	_Aug (199)	_Sep (178)	_Oct (151)	_Nov (64)	_Dec (39)
2010:	_Jan (33)	_Feb (146)	_Mar (125)	_Apr (109)	_May (52)	_Jun (135)	_Jul (103)	_Aug (68)	_Sep (99)	_Oct (88)	_Nov (45)	_Dec (56)
2011:	_Jan (19)	_Feb (32)	_Mar (50)	_Apr (105)	_May (46)	_Jun (22)	_Jul (101)	_Aug (80)	_Sep (52)	_Oct (16)	_Nov (10)	_Dec (29)
2012:	_Jan (8)	_Feb (22)	_Mar (17)	_Apr (68)	_May (19)	_Jun (19)	_Jul (12)	_Aug (6)	_Sep (13)	_Oct (5)	_Nov (5)	_Dec (5)
2013:	_Jan (6)	_Feb (4)	_Mar (3)	_Apr (5)	_May	_Jun	_Jul	_Aug	_Sep	_Oct	_Nov	_Dec


S	M	T	W	T	F	S
			1	2	3	4
			(7)	(3)	(1)	(1)
5	6	7	8	9	10	11
(1)	(20)	(7)	(7)	(4)	(15)	(5)
12	13	14	15	16	17	18
(1)	(11)	(16)	(4)	(4)	(8)	(1)
19	20	21	22	23	24	25
(1)	(15)	(7)	(1)	(4)	(2)	(2)
26	27	28	29	30	31
(1)	(1)	(1)	(1)

ENOMEM

From: Sam Steingold <sds@gn...> - 2004-12-01 17:05

does this mean that I am out of physical RAM(16GB)?!

Cannot map memory to address 0x65a321000 . errno = ENOMEM: Not enough memory.
Trying to make room through a GC...

-- 
Sam Steingold (http://www.podval.org/~sds) running w2k
<http://www.camera.org> <http://www.iris.org.il> <http://www.memri.org/>
<http://www.mideasttruth.com/> <http://www.honestreporting.com>
Your mouse pad is incompatible with MS Windows - your HD will be reformatted.

Re: ENOMEM

From: Bruno Haible <bruno@cl...> - 2004-12-01 18:09

Sam wrote:
> Cannot map memory to address 0x65a321000 . errno = ENOMEM: Not enough
> memory. Trying to make room through a GC...
> does this mean that I am out of physical RAM(16GB)?!

Yes. The address 0x65a321000 does not look particularly out-of-range, therefore
I guess the kernel doesn't want your process to take more RAM.

Bruno

Re: ENOMEM

From: Sam Steingold <sds@gn...> - 2004-12-01 18:34

> * Bruno Haible <oehab@...> [2004-12-01 19:08:06 +0100]:
>
> Sam wrote:
>> Cannot map memory to address 0x65a321000 . errno = ENOMEM: Not enough
>> memory. Trying to make room through a GC...
>> does this mean that I am out of physical RAM(16GB)?!
>
> Yes. The address 0x65a321000 does not look particularly out-of-range,
> therefore I guess the kernel doesn't want your process to take more
> RAM.

it would be nice to have more postmortem information here, e.g.,
the current heap size, (ROOM T) &c.
this would help me deal with the problem on the "kernel level",
i.e., tell the admins that they have to teach the kernel to behave &c.

thanks.

-- 
Sam Steingold (http://www.podval.org/~sds) running w2k
<http://www.camera.org> <http://www.iris.org.il> <http://www.memri.org/>
<http://www.mideasttruth.com/> <http://www.honestreporting.com>
All extremists should be taken out and shot.

huge heap: global GC hold

From: <don-sourceforge-xx@is...> - 2004-12-01 07:04

Sam wrote:
 > proposal: user-settable variable *ALLOCATE-BEFORE-GLOBAL-GC*, containing
 > the number of bytes allocated before the next automatic global GC.

This seems to me not the most likely to be useful.

 Bruno replied
 > I'm against all user "hints" for the garbage collection. Rationale:
 > 
 >   - More often than not, the user is wrong about his guesses regarding
 >     allocation.

He doesn't have to "guess right" in order for this control to help
him.  He can measure and experiment.  If he guesses wrong he can
always return to the automatic solution.

 >   - Pushing complexity on the user is typically a sign that the implementor
 >     has not understood what he should do.

What is the best strategy depends on the usage, and that's something
that the clisp "user" (who is generally an "implementer" of a program
that will be "used" by others) is in a position to know much better
than the clisp implementer.

 > Instead I propose to improve clisp's GC *generically*.

Nobody can disagree with that.

 >   1) Change the thresholds (currently 25%) in the GC as a function of
 >      the memory size. The theory postulates different behaviour for memory
 >      sizes significantly smaller or significantly bigger than the square of
 >      the hardware memory page size. Maybe you are seeing its effects here?
 >      There are also cache size issues, which could be analyzed using
 >      cachegrind Linux/x86.

I notice huge degradation in GC when my lisp VM exceeds real memory.
I was always impressed that symbolics GC managed to avoid this.  
I've not paid much attention to Clisp GC (yet).  Could more be done
to localize reference?

Sam answers:
 > I have separate timings for allocation phases (36 datasets):
 > [run: 88.160 sec] [real: 91.844 sec]
 > [run: 96.970 sec] [real: 100.893 sec]
 > [run: 93.320 sec] [real: 97.033 sec]
 ...
I need some explanation of which lines refer to which phases.
And then I still don't know what conclusions to draw.

 > IIUC, ACL has ~10 generations, and one can specify the generation at
 > allocation time :-)

Symbolics had a way of specifying what "area" to use for particular
allocations.  I do think it's useful to be able to tell the
implementation what things are expected to have similar lifetimes,
what things are likely to be used together, how much space to allocate
to each area and when to collect each area.

Re: huge heap: global GC hold

From: Sam Steingold <sds@gn...> - 2004-12-01 14:59

> * Don Cohen <qba-fbheprsbetr-kk@...> [2004-11-30 22:55:41 -0800]:
>
> Sam answers:
>  > I have separate timings for allocation phases (36 datasets):
>  > [run: 88.160 sec] [real: 91.844 sec]
>  > [run: 96.970 sec] [real: 100.893 sec]
>  > [run: 93.320 sec] [real: 97.033 sec]
>  ...
> I need some explanation of which lines refer to which phases.

all lines are allocation phases, just as I said above.

> And then I still don't know what conclusions to draw.

12 hours total = 8 hours allocation + 4 hours processing
includes 4 hours GC.


-- 
Sam Steingold (http://www.podval.org/~sds) running w2k
<http://www.camera.org> <http://www.iris.org.il> <http://www.memri.org/>
<http://www.mideasttruth.com/> <http://www.honestreporting.com>
The program isn't debugged until the last user is dead.

Re: huge heap: global GC hold

From: Sam Steingold <sds@gn...> - 2004-12-01 17:11

> * Bruno Haible <oehab@...> [2004-11-30 22:47:47 +0100]:
>
>
>   2) Some systems use a GC with 3 generations. CLISP has only 2 generations.
>      It might be worth trying out 3 generations.

I think the number of generations should be a build-time option (like
SAFETY or TYPECODES).

Also, I really want TIME to report not just the general GC stats, but
per generation, i.e., instead of 

GC: 9724, GC time: 14379.49 sec.

I want to see

GC-global: 9, time: 143.49 sec.
GC-local1: 97, GC2 time: 1437.49 sec.
GC-local2: 972, GC2 time: 14379.49 sec.

Also, I want (ROOM T) output whenever there is a crash,
especially if it happens because of ENOMEM,
but a general segfault would be nice too.

-- 
Sam Steingold (http://www.podval.org/~sds) running w2k
<http://www.camera.org> <http://www.iris.org.il> <http://www.memri.org/>
<http://www.mideasttruth.com/> <http://www.honestreporting.com>
Who is General Failure and why is he reading my hard disk?

clisp-cvs digest, Vol 1 #836 - 3 msgs

From: <clisp-cvs-request@li...> - 2004-12-01 04:11

Send clisp-cvs mailing list submissions to
	clisp-cvs@...

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
	clisp-cvs-request@...

You can reach the person managing the list at
	clisp-cvs-admin@...

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 <sds@...>
To: clisp-cvs@...
Subject: clisp/doc cl-ent.xml,1.73,1.74
Date: Tue, 30 Nov 2004 15:35:07 +0000
Reply-To: clisp-devel@...

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 <sds@...>
To: clisp-cvs@...
Subject: clisp/doc unix-ent.xml,1.55,1.56
Date: Tue, 30 Nov 2004 16:07:29 +0000
Reply-To: clisp-devel@...

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 <sds@...>
To: clisp-cvs@...
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: clisp-devel@...

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>&macros3-lisp; (optional)</term>
  <listitem><simpara>the macros &letf;, &letf-star; and &ethe;
 </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 &macros3-lisp; and loaded from the file &init-lisp; during
+ &make;:</para>
 
 <formalpara id="ethe"><title>Macro &ethe;</title>
 <para><code>(&ethe; &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&quot;.mem&quot;</filename>">
 <!ENTITY c-file "<filename>#P&quot;.c&quot;</filename>">
 <!ENTITY lib-file "<link linkend='require'><filename>#P&quot;.lib&quot;</filename></link>">
-<!ENTITY config-file "<link linkend='customize'><filename>#P&quot;config.lisp&quot;</filename></link>">
-<!ENTITY make-file "<filename>#P&quot;Makefile&quot;</filename>">
-<!ENTITY lispinit "<link linkend='image'><filename>#P&quot;lispinit.mem&quot;</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&quot;clisp.h&quot;</filename></link>">
+<!ENTITY clisp-h "<link linkend='clisp-h'><filename>clisp.h</filename></link>">
 
 <!-- *** pathnames *** -->
 <!ENTITY file-star  "<filename>&quot;*&quot;</filename>">
@@ -755,7 +755,20 @@
 <!ENTITY foo-f "<filename>#P&quot;foo&quot;</filename>">
 <!ENTITY bar-f "<filename>#P&quot;bar&quot;</filename>">
 <!ENTITY foolisp-f "<filename>#P&quot;foo.lisp&quot;</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
clisp-cvs@...
https://lists.sourceforge.net/lists/listinfo/clisp-cvs


End of clisp-cvs Digest