home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1993 #1 / NN_1993_1.iso / spool / comp / os / linux / 23622 < prev    next >
Encoding:
Text File  |  1993-01-11  |  3.8 KB  |  86 lines
  1. Newsgroups: comp.os.linux
  2. Path: sparky!uunet!news.univie.ac.at!chx400!bernina!almesber
  3. From: almesber@nessie.cs.id.ethz.ch (Werner Almesberger)
  4. Subject: Re: Annoying Linux developer habits.
  5. Message-ID: <1993Jan11.154103.24261@bernina.ethz.ch>
  6. Sender: news@bernina.ethz.ch (USENET News System)
  7. Organization: Swiss Federal Institute of Technology (ETH), Zurich, CH
  8. References: <C0LFHK.F2E@ais.org>
  9. Date: Mon, 11 Jan 1993 15:41:03 GMT
  10. Lines: 74
  11.  
  12. In article <C0LFHK.F2E@ais.org> sno@ais.org (Stephen Opal) writes:
  13. > Lilo is only distributed with postscript documentation.
  14.  
  15. No, the documentation comes in
  16.  
  17.   - LaTeX (lilo.n.tar.Z, doc/doc.tex)
  18.   - PostScript (lilo.n.ps.Z)
  19.   - ASCII (lilo.n.tar.Z, README)
  20.  
  21. The ASCII documentation is admittedly not quite as comprehensive as the
  22. LaTeX or PostScript versions (which are, by the way, identical).
  23.  
  24. Why I use LaTeX and not some other format (WordPerfect, Framemaker, Word,
  25. ATK, WordStar, PageMaker, Showcase, ...) ? Because a) (La)TeX is prevalent
  26. in academia, b) everybody can get it for free, c) it's available for many
  27. operating systems, d) it's powerful and generates excellent output, e) it's
  28. device-independent, f) I like TeX.
  29.  
  30. Why I use LaTeX and not plain ASCII ? Because a) long ASCII documents are
  31. hard to read, b) manual formatting is a pain, c) ASCII drawings are hard to
  32. create and usually don't look good, d) I'd have to do it all in LaTeX
  33. anyway if this should ever become part of a printed document, e) I like
  34. TeX.
  35.  
  36. > Several other packages have made their "current" documentation only
  37. > available in TeX. 
  38.  
  39. A lot of freely FTPable software has documentation exclusively in (La)TeX
  40. and it's very unlikely that anybody will convert it to ASCII, so LILO
  41. won't be your last encounter with LateX.
  42.  
  43. Of course, ASCII has a few advantages too: it is on-line readable and it's
  44. easy to search for text in it. However, I hope nobody is seriously con-
  45. sidering reading more than very few pages of text on-line (and there is
  46. xdvi, if you're really desparate) and searching in LaTeX code and reading
  47. the relevant section is also possible, although not very convenient.
  48.  
  49. The main advantage of using anything more advanced than ASCII is print
  50. quality and readability. Anybody who has ever read both the ASCII and the
  51. LaTeX FAQ will surely agree.
  52.  
  53. I think there are only three solutions for those who can't or don't want
  54. to install LaTeX or don't own a graphics printer and don't have access to
  55. a LaTeX installation at work or at school and don't have access to a
  56. PostScript printer and don't know anybody who could print the documenta-
  57. tion for them:
  58.  
  59.   1) fix any of the above problems, e.g. install LaTeX, buy a better
  60.      printer, join a computer club, ... ;-)
  61.   2) get access to *any* graphics printer, get somebody on the net to
  62.      generate output for it and print that. (It would probably already
  63.      help a lot if somebody could generate HP-DJ output for the most
  64.      common LaTeX documents and upload it.)
  65.   3) write a LaTeX to ASCII converter (with a few restrictions, of
  66.      course)
  67.  
  68. I doubt that there are many people who currently use Linux and are
  69. truly unable to print LaTeX documentation - they probably simply don't
  70. try hard enough.
  71.  
  72. > WE NEED ASCII!!!  One of the biggest complaints in this newsgroup is from
  73. > people chastising users who can't seem to read the available info/faq.  I
  74. > think we could go a long way in minimizing this "problem" by making the
  75. > current documentation available to the lowest common denominator.
  76.  
  77. Introductory documentation is typically written in ASCII. That the more
  78. complete part is written in a decent format isn't a good excuse for not
  79. reading the READMEs and FAQs :-)
  80.  
  81. - Werner
  82. -- 
  83.    _________________________________________________________________________
  84.   / Werner Almesberger, ETH Zuerich, CH      almesber@nessie.cs.id.ethz.ch /
  85.  /_IFW_A44__Tel._+41_1_254_7213___________________________________________/
  86.