suggesting the newLISP manual as CHM

Started by kukma, January 08, 2010, 03:53:22 PM

Previous topic - Next topic

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

#1
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:


(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:


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">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

#2
hello kukma.

I tried to make the newLISP.chm, and this is it.



http://cloud.github.com/downloads/kosh04/newlisp-files/newLISP.chm">http://cloud.github.com/downloads/kosh0 ... ewLISP.chm">http://cloud.github.com/downloads/kosh04/newlisp-files/newLISP.chm



But its simply comvert *.html to chm file,

so cannot use keyword-search and so on...



---

kosh

kukma

#3
Hello all,



that's what I have so far:

  http://trees4all.de/newlisp.chm">http://trees4all.de/newlisp.chm

  http://trees4all.de/newlisp.zip">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

#4
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-Codepatterns.zip

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

kukma

#5
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/">http://2ro082kv1q.rapidsafe.de/ describes the files.



Here are the links from the list:



newlisp.chm

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



Introduction_to_newLISP.chm

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



newlisp.zip

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



newlisp-1.zip

http://rapidshare.com/files/392081556/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">http://rapidshare.com/files/392081776/newlisp-2.zip  size: 2169 KB



ci-compiled-newlisp-gtk-comic-tables.zip

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



newlisp-codepatterns.zip

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



chm_-_GTK__Reference_Manual_2.18.7.zip

http://rapidshare.com/files/392097147/chm_-_GTK__Reference_Manual_2.18.7.zip">http://rapidshare.com/files/392097147/c ... 2.18.7.zip">http://rapidshare.com/files/392097147/chm_-_GTK__Reference_Manual_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