Page 1 of 1

suggesting the newLISP manual as CHM

Posted: Fri Jan 08, 2010 11:53 pm
by kukma
Hello Lutz,
could you make the manual available as separate HTML files?
I would like to use the to be compiled CHM file in text editors to achieve context sensitive help in.
TIA

Re: suggesting the newLISP manual as CHM

Posted: Sat Jan 09, 2010 11:45 am
by Lutz
The newLISP reference in newlisp_manual.html has been formatted using simple HTML and is easy to parse. E.g. the file newlisp-x.x.x/util/nls contains the following function to give online help:

Code: Select all

(define (help func-name)
  (if (find func-name "|+*-") (push "\\" func-name))
  (set 'html-text (join (find-all (format {(syntax: \(%s.*?\))} func-name)
    (read-file "/usr/share/doc/newlisp/newlisp_manual.html")) "\n"))
  (replace "<.*?>" html-text "" 0)
  (replace "<" html-text "<")
  (replace ">" html-text ">")
  (replace "&" html-text "&")
  (println html-text)
  "")
People have written scripts breaking the reference apart into chunks for each function.

If help is executed in nls (newLISP shell integrating UNIX Bourne shell and LISP repl), it looks like this on Mac OS X:

Code: Select all

MAIN:/Users/lutz> help pri
syntax: (primitive? exp)
syntax: (print exp-1 [exp-2 ... ])
syntax: (println exp-1 [exp-2 ... ])
MAIN:/Users/lutz>
Another method to get to Windows CHM files would be, to start with a newlisp_manual.doc (MS Word) file generated from the newlisp_manual.html file. I posted a newlisp_manual.odt (OpenOffice Document format) here:

http://www.newlisp.org/newlisp_manual.odt

This file is used to generate the PDF version of the manual. You could convert it to .doc using OpenOffice and then use an MS utility to convert the .doc file to CHM. I used to do this back in the times when newLISP was only available on MS-Windows.

Re: suggesting the newLISP manual as CHM

Posted: Sun Jan 10, 2010 12:17 pm
by kosh
hello kukma.
I tried to make the newLISP.chm, and this is it.

http://cloud.github.com/downloads/kosh0 ... ewLISP.chm

But its simply comvert *.html to chm file,
so cannot use keyword-search and so on...

---
kosh

Re: suggesting the newLISP manual as CHM

Posted: Tue Jan 12, 2010 11:24 am
by kukma
Hello all,

that's what I have so far:
http://trees4all.de/newlisp.chm
http://trees4all.de/newlisp.zip

Kosh, I have not directly included source from the distribution yet.
Planned is to add some source from the internet as well.

Have fun!

Re: suggesting the newLISP manual as CHM

Posted: Tue Mar 30, 2010 7:20 am
by kukma
Here you can find the compiled HTML help files for before 10.2.0 versions,
content and project files included:

http://trees4all.de/chm-Codepatterns.zip
http://trees4all.de/chm-Introduction%20to%20newLISP.zip

Re: suggesting the newLISP manual as CHM

Posted: Mon May 31, 2010 10:13 am
by kukma
Hi,

though still for before newLISP 10.2 versions I have uploaded the files and some more to Rapidshare.
On trees4all all files given above will be deleted.

http://2ro082kv1q.rapidsafe.de/ describes the files.

Here are the links from the list:

newlisp.chm
http://rapidshare.com/files/392065930/newlisp.chm size: 2434 KB

Introduction_to_newLISP.chm
http://rapidshare.com/files/392073672/I ... ewLISP.chm size: 913 KB

newlisp.zip
http://rapidshare.com/files/392075118/newlisp.zip size: 6676 KB

newlisp-1.zip
http://rapidshare.com/files/392081556/newlisp-1.zip size: 1667 KB

newlisp-2.zip
http://rapidshare.com/files/392081776/newlisp-2.zip size: 2169 KB

ci-compiled-newlisp-gtk-comic-tables.zip
http://rapidshare.com/files/392083585/c ... tables.zip size: 23485 KB

newlisp-codepatterns.zip
http://rapidshare.com/files/392084426/n ... tterns.zip size: 126 KB

chm_-_GTK__Reference_Manual_2.18.7.zip
http://rapidshare.com/files/392097147/c ... 2.18.7.zip size: 14375 KB

In the compiled programs not all of the DLLs are needed.

You are encouraged to compile the project in chm_-_GTK__Reference_Manual_2.18.7.zip yourself.
There will be required only some minor corrections.

Best regards
Michael