suggesting the newLISP manual as CHM

Q&A's, tips, howto's
Locked
kukma
Posts: 9
Joined: Mon Jan 04, 2010 12:44 pm
Location: 9° E

suggesting the newLISP manual as CHM

Post 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

Lutz
Posts: 5289
Joined: Thu Sep 26, 2002 4:45 pm
Location: Pasadena, California
Contact:

Re: suggesting the newLISP manual as CHM

Post 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.

kosh
Posts: 72
Joined: Sun Sep 13, 2009 5:38 am
Location: Japan
Contact:

Re: suggesting the newLISP manual as CHM

Post 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

kukma
Posts: 9
Joined: Mon Jan 04, 2010 12:44 pm
Location: 9° E

Re: suggesting the newLISP manual as CHM

Post 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!

kukma
Posts: 9
Joined: Mon Jan 04, 2010 12:44 pm
Location: 9° E

Re: suggesting the newLISP manual as CHM

Post 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

kukma
Posts: 9
Joined: Mon Jan 04, 2010 12:44 pm
Location: 9° E

Re: suggesting the newLISP manual as CHM

Post 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

Locked