The 9.4.0 newLISP manual

[Lutz]

Thanks xytroxon, here revision 10:



http://www.newlisp.org/download/development/newlisp_manual.html">http://www.newlisp.org/download/develop ... anual.html">http://www.newlisp.org/download/development/newlisp_manual.html

[DrDave]

Lutz,



I saw your comment about being able to edit directly into the HTML source file. I see that I can run the entire doc through a spell checker and make corrections. So how to send to you the corrected file?

[Lutz]

Thanks DrDave, actually I spell-checked it already, but I may have forgotten something. You can send it as an email attachement to lutz at nuevatec dot com. Take the latest from the development directory, currently revision 10.

[cormullion]

spellchecking the newLISP way:

Code Select Expand

(set 'file (map lower-case
   (parse (read-file (string (env "HOME") "/Desktop/newLISP v.9.4.0 Manual and Reference.html")) {W} 0)))
(set 'words (parse (read-file "/usr/share/dict/words")))
(difference file words)

("" "doctype" "html" "w3c" "dtd" "4" "0" "http" "equiv" "charset" "utf" "8" "lutz"
 "mueller" "keywords" "newlisp" "programming" "nuevatec" "users" "9" "css" "2em"
 "1em" "roman" "ffaa28" "optima" "georgia" "456" "100" "16px" "arw" "303030" "cc0000"
 "555555" "aa0000" "keyword" ... ... ...

Oh no, the list is way too long - that old Unix dictionary is showing its age!



But glancing through the list, I can see some typos:

Code Select Expand

parseing  repetetive expresson destruvtive fuctions loalhost succcessful statments proces enviroment connnection complilation compiliation boool statments prcompiled

So it finds a few more for you... :)

[Lutz]

Thanks Cormullion, updated revision 11:



http://www.newlisp.org/download/development/newlisp_manual.html">http://www.newlisp.org/download/develop ... anual.html">http://www.newlisp.org/download/development/newlisp_manual.html



at some point I would like to hand it off to you, so we don't work on two different versions. Tell me when the time has come, that you want to start the final review and correction pass. Then I stop correcting, and if people find stuff, you can work it in.



Thanks again for offering to do this, its a rather big piece of work. On the other side, since Michael and Melissa made a complete pass, I probably haven't touched more then 15% of it. The art is to find those 15% though ;-)

[Lutz]

Just received a complete spell-check by DrDave.



Thank you very much.



82 mispelled words, missing commas, double word occurrences etc., have been fixed in revision 12:



http://www.newlisp.org/download/development/newlisp_manual.html">http://www.newlisp.org/download/develop ... anual.html">http://www.newlisp.org/download/development/newlisp_manual.html

[cormullion]

Sorry Lutz, I was hoping to spend some time on the manual over the weekend, but life caught up with me - and then overtook me... Not sure what I can do in the next few days either.



For the future, I can't help thinking that getting a number of different people to contribute to the manual this way is a bit too ..., well, 20th century. Isn't there some more dynamic way to allow people to collaborate as a loosely constructed group and work on areas that they feel comfortable with, in their own time? GoogleDocs? (No, not GoogleDocs, that can't even handle documents over 512K) What else is out there?

[Kazimir Majorinc]

"retrieves the argument list of a macro expression" --> "retrieves the argument list of a function or a macro expression"

[tom]

What else is out there?

http://savannah.nongnu.org">http://savannah.nongnu.org

[Kazimir Majorinc]

Letex example has one extra quote:



(letex '(x 1 y 2 z 3) '(x y z))

[Kazimir Majorinc]

I noted that length requires constant time in Newlisp, and that is some advantage over other Lisp dialects where it is linear. Maybe it deserves to be mentioned in the function reference.

[Kazimir Majorinc]

"integer" appears to be alias for "int" but is not documented in manual.

On the other side, "int?" is not defined as predicate, but "integer?" is.



I think it is the best to define both as aliases - "int" and "integer"; "int?" and "integer?" and also to document both. (Such aliases, short and long seem to be good practice to me.)

[cormullion]

I thought integer might have been deprecated in 2004... (Before my time...) Lutz will know - or you could try to find old release notes...

[rickyboy]

I thought integer might have been deprecated in 2004... (Before my time...) Lutz will know - or you could try to find old release notes...

See item 3 http://www.alh.net/newlisp/phpbb/viewtopic.php?p=7290#7290">here.

[newdep]

Lutz,



Regarding newlisp 10.0



Have you ever considered porting the documentaion to windows chm format?

Not sure how much work it takes but its a nice format that reads good too.





Norman