Revision 4 of the newLISP manual 9.3.0

Started by Lutz, March 25, 2008, 01:35:32 PM

Previous topic - Next topic

Lutz

revision 4 of the newLISP manual is posted here:



http://www.newlisp.org/downloads/newlisp_manual.html">http://www.newlisp.org/downloads/newlisp_manual.html



a PDF version of revision 4 will come later this week

newdep

#1
function "rest" points to "slice" in the "slice" paragarph.
-- (define? (Cornflakes))

newdep

#2
sys-info is missing '7'



hehe there are only 0-8 ;-) mis numbering in the doc...
-- (define? (Cornflakes))

newdep

#3
"define" chapter

does not mention the local variable possibility inside define.

i.e. (define (default? X, (s 10)) (println s))







"global?" chapter



is missing a "(" in the example
-- (define? (Cornflakes))

Lutz

#4
(s 10) is just a normal parameter with a default value, nothing special here. The comma is just a visual trick behaving like a variable itself:



http://www.newlisp.org/downloads/newlisp_manual.html#commas">http://www.newlisp.org/downloads/newlis ... tml#commas">http://www.newlisp.org/downloads/newlisp_manual.html#commas

newdep

#5
Lutz,



Perhpas handy to put inside the manual that:



net-udp-send is limited to 65508 bytes by default for datasize,

if its bigger it returns 'nil and the data is not sent.

(max data size in unix for udp) Sending packets in smaller chunks

in udp is a saver option i.e. 8k or 16k





PS: I knew there was a limit, but these numbers you forget, so

i just could not get the file over to the remote site ;-)



Norman.
-- (define? (Cornflakes))

cormullion

#6
You know how much I like and use the manual, Lutz! I'm always referring to it - the bookmark on my browser is all dirty and worn through overuse...



But I've been getting the feeling recently that some of the functions are not in 100%-accurate alphabetical order...  To test this, I ran this simplistic code:


(set 'file (read-file "/usr/share/doc/newlisp/newlisp_manual.html"))

(set 'data   (find-all (string {<h2><span>([a-z].*?)</span></h2>}) file   $1))

(map (fn (x y)
  (if (!= x y)
   (println { --> } x { } y)
   (println {     } x { } y)))  
  data
 (sort data))


While not all the indicated functions are necessarily wrongly placed, there's a few which could be swapped... In this extract, the do... functions are OK (who worries about hyphens), but that delete-url looks out of place...



    dec dec
 --> define def-new
 --> define-macro default
 --> def-new define
 --> default define-macro
     delete delete
     delete-file delete-file
 --> destroy delete-url
 --> det destroy
 --> device det
 --> delete-url device
     difference difference
     directory directory
     directory? directory?
     div div
 --> doargs do-until
 --> dolist do-while
 --> dostring doargs
 --> dotimes dolist
 --> dotree dostring
 --> do-until dotimes
 --> do-while dotree
     dump dump


And in case you're wondering why I scroll through the document and notice this sort of thing, it's because when I resize the browser window the function definition I'm reading moves out of visibility, so I have to scroll and find it...



I could write you a function to sort the HTML... But you could write a better one... :)