jw@sics.se (Johan Widen) (01/28/88)
In article <10823@shemp.UCLA.EDU> othar@CS.UCLA.EDU () writes: >Has anyone (outside GNU/FSF) any experience with creating/using "info" >files other than the ones that come with the GNU distribution? (if you >don't know what I'm talking about, type M-X info and see) We have written a prolog manual (about 100 pages) in texinfo. Writing documentation in texinfo is fairly easy, in part because texinfo has fewer commands than raw TeX. There is one thing that I find annoying though. The texinfo formatter (the one that produces info files) is reluctant to do paragraph filling. You often have to fill the paragraphs manually or insert a @refill command. On the plus side: you get both a printed manual and an online manual. Texinfo also provides you with indexes and cross references. I have not figured out how to do bibliographic references in a proper way (on that works both in info and tex). Anyway, texinfo is the package I use and intend to use when I write documentation. -- Johan Widen SICS, PO Box 1263, S-164 28 KISTA, SWEDEN Tel: +46 8 752 15 32 Ttx: 812 61 54 SICS S Fax: +46 8 751 72 30 Internet: jw@sics.se or {mcvax,munnari,ukc,unido}!enea!sics.se!jw