home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #27 / NN_1992_27.iso / spool / alt / hypertex / 914 < prev    next >
Encoding:
Internet Message Format  |  1992-11-19  |  3.0 KB
  1. Xref: sparky alt.hypertext:914 comp.lang.misc:3799
  2. Path: sparky!uunet!mcsun!sun4nl!cwi.nl!guido
  3. From: guido@cwi.nl (Guido van Rossum)
  4. Newsgroups: alt.hypertext,comp.lang.misc
  5. Subject: Python documentation as INFO and WWW hypertext
  6. Message-ID: <7950@charon.cwi.nl>
  7. Date: 19 Nov 92 20:02:38 GMT
  8. Sender: news@cwi.nl
  9. Followup-To: alt.hypertext
  10. Lines: 61
  11.  
  12. Python is an object-oriented, interpreted programming language with a
  13. nice clean syntax and data model (compared to C or Perl, at least :-)
  14. Until now, the Python documentation has been available only as LaTeX
  15. source or PostScript, which meant you had to print the entire manual
  16. in order to use it.
  17.  
  18. But thanks to my colleague Jan-Hein Buhrman, the library documentation
  19. for Python can now be browsed on-line! There are even two ways: as
  20. Emacs INFO tree (1) and as a bunch of WWW hypertext nodes (2).
  21.  
  22. (1) Emacs INFO tree
  23.  
  24. The library documentation is available in the format understood by the
  25. Emacs INFO browser.  For this you need to fetch the tar file
  26. python-lib-info.tar from anonymous ftp site ftp.cwi.nl
  27. [192.16.184.180], directory /pub (source for Python is also here).
  28.  
  29. The tar file contains 6 compressed info files which together comprise
  30. the entire info tree for the library manual.  You can go to the top of
  31. the tree using the 'g' command in INFO mode, type g followed by
  32. (python-lib), assuming the tar file has been extracted in the right
  33. directory.  Of course you can also edit your "localdir" file.
  34.  
  35. You don't need Emacs to browse INFO files: if you uncompress the
  36. info files, they can also be browsed with the info browser written in
  37. Python from the Python distribution's demo directory,
  38. python/demo/stdwin/ibrowse/ib.  (This requires that you have installed
  39. the STDWIN extension to Python.)
  40.  
  41. (2) WWW hypertext
  42.  
  43. If you have a browser from CERN's WWW project (World-Wide Web, a
  44. distributed hypertext system) you can browse a WWW hypertext version
  45. of the manual by following the following link:
  46.  
  47.     http://voorn.cwi.nl:2784/texinfo/python/top.html
  48.  
  49. If your name server doesn't know about voorn.cwi.nl, substitute
  50. 192.16.201.121.  Try http://voorn.cwi.nl:2784/default.html to see
  51. what other WWW documents are available from CWI -- I have converted
  52. several other texinfo documents to WWW's format and made them
  53. available, such as the Emacs manual.
  54.  
  55. It is possible that our Internet interface prohibits access to port
  56. 2784 on voorn.cwi.nl.  In that case, you can try the following slower
  57. but equivalent access path using ftp:
  58.  
  59.     file://ftp.cwi.nl/pub/www/texinfo/python/top.html
  60.  
  61. Sources and binaries of WWW browsers can be ftp'ed from site
  62. ftp.cern.ch, directory pub/www.  Start extracting README.txt.  The
  63. Viola browser is quite worthwile (if you have X11).
  64.  
  65. I have also written a WWW browser in Python, but its displayer and
  66. parser are rather slow compared to the C versions.  If you're
  67. interested in the texinfo-to-WWW conversion program (also in Python),
  68. send me mail.
  69.  
  70. --Guido van Rossum, CWI, Amsterdam <guido@cwi.nl>
  71. "Well there's spam, egg, sausage and spam.  That's not got *much* spam
  72. in it"
  73.