RFC open on newLISP documentation

[nigelbrown]

re various examples

1) (sort

(sort '((3 4) "hi" 2.8 8 b)            => (2.8 8 "hi" b (3 4))

should eb

(sort '((3 4) "hi" 2.8 8 b))            => (2.8 8 "hi" b (3 4))

Nigel

[Lutz]

thanks for all the corrections Nigel, a comment to (normal ...)



The 'normal' , 'random' and 'rand' functions will cause different values on each computer executed and on each invocation, so it is natural that the documentation will show something different (but I think you where referring to the precision of the numbers). All rely on a pseudo random generator, which can be initialized using the 'seed' function. Using seed repeatable random sequences can be generated.



Lutz

[Lutz]

I did not yet put in the description for the memory limiting commandline switch ( -m N , where N is megabytes of max cell mem permitted), because of all the corrections we are doing on the manual, which I always post online for 7.4.0 users i the new revision.



This way I don't need to update two versions of the manual, and can make corrections available to users not using development versions. New features will always be shortly explained in the CHANGES file.



Lutz

[eddier]

The floor example has an error.



(floor -1.5) => -2



The definition of atan2 is incorrect in the index but correct in the body.



Eddie

[Lutz]

Thanks for all of the corrections, revision 6 of 7.4.0 is online at:



http://newlisp.org/download/newlisp_manual.html">http://newlisp.org/download/newlisp_manual.html

http://newlisp.org/download/newlisp_manual.pdf">http://newlisp.org/download/newlisp_manual.pdf



Lutz

[Sammo]

A few typos in v.7.4.8:



in the 'swap' command, "In the second form the charcaters ..." should be "In the second form the characters ..."



in the 'swap' command last sentence before example should end with "... the list or string."



in the 'symbol?' command, "= >" in the first example should be "=>"

[Lutz]

thanks for the corrections



Lutz

[Lutz]

Sam,



I am preparing some pages for a new section on the http://newlisp.org/news/">http://newlisp.org/news/ site for the 'Tips&Tricks' section.



I wonder if you give me permission to publish your 'roman.lsp' code. It is a nice small piece of newLISP code ideal for that section.



There will also be a small (and hopefully growing) collection of 'Code Snippets' with very short functions like 'allocate', 'cwd' etc, which I collected on this site and from my own stuff.



Lutz

[Sammo]

Lutz,



You are more than welcome to use my code.  FYI, I wrote it originally in muLISP on an old DOS box.  After I rewrote it just recently in newLISP, I read an article about Roman Numerals that suggests that not every numeral I generate is "correct" -- whatever "correct" means in Roman Numeral-land.  When I have a little time I will reread the article and perhaps update my code to comply with its recommendations.  In the meantime, the code is yours.  I hereby testify that the code is my own creation and not the property or invention of anyone else.

[eddier]

There is an error in the 7.5.1 manual under Contexts as Classes



The last line should be



JD-001:balance =>123.45



Eddie

[eddier]

Under the heading



"Hash tables"   should be "Hash Tables"



"newLisp"   should be "NewLisp"



"very efficient with"   should be "very efficiently with"



Eddie

[Lutz]

thanks Eddie



Lutz

[Lutz]

'newLISP' should always be written with lower case 'new' and uppercase 'LISP', it's a trademark.



On 'Hash tables' I am not sure. I don't capitalize nouns (except for the first one) in any other heading, or should I ?



Lutz

[Ryon]

Uh oh.

[eddier]

For books and other titles, capitalize the first and last word, as well as all the nouns, pronouns, adjectives, verbs and adverbs. Also capitalize any conjunction or preposition that is at least four letters long.



Trademarks are capitalized, but the generic product is not. It is Post-it notes, not Post-it Notes.

Source: http://www.alh.net/newlisp/phpbb/posting.php?mode=reply&t=119">http://www.alh.net/newlisp/phpbb/postin ... eply&t=119">http://www.alh.net/newlisp/phpbb/posting.php?mode=reply&t=119



I've always heard that we should always capitalize the first letter of the first word of a sentence, but with trademarks, I'm not sure. Maybe the site above will help.



Eddie[/quote]