Return to BSD News archive
Path: sserve!newshost.anu.edu.au!munnari.oz.au!news.ecn.uoknor.edu!paladin.american.edu!howland.reston.ans.net!news.sprintlink.net!news.bluesky.net!news.mathworks.com!news.kei.com!nntp.et.byu.edu!news.byu.edu!hamblin.math.byu.edu!park.uvsc.edu!usenet
From: Terry Lambert <terry@cs.weber.edu>
Newsgroups: comp.unix.bsd.freebsd.misc
Subject: Re: Documentation project (was Re: Slight flame from Linux user)
Date: 10 Jun 1995 23:08:02 GMT
Organization: Utah Valley State College, Orem, Utah
Lines: 50
Message-ID: <3rd8ki$76k@park.uvsc.edu>
References: <3ql3gd$je2@bell.maths.tcd.ie> <AMOSS.95Jun9141718@picton.cs.huji.ac.il>
NNTP-Posting-Host: hecate.artisoft.com
[ ... about FreeBSD documentation ... ]
taob@gate.sinica.edu.tw (Brian Tao) writes:
]
] Actually, I'd prefer a series of LaTeX files which I can then turn
] into dvi files for on-screen previewing, which can then be easily
] converted to PostScript or HPGL for printing. Or use latex2html to
] turn them into Web-browsable HTML files. PostScript is only good for
] printing (and viewing, to an extent). It isn't particularly well-
] suited for conversion to other formats.
The document sources are in SGML.
If you want LaTeX output, use that make target.
If you want HTML output, use that make target.
amoss@picton.cs.huji.ac.il (Amos Shapira) wrote:
] Just wondering - what about using GNU's texinfo? I think that
] way you get also Emacs' info mode into the picture without
] loosing all the benefits of LaTeX you mentioned.
]
] (am I right?)
I'm not sure if you can convert the Linux documents (which are
also sourced in SGML, in a DTD called "LinDoc") into texinfo.
Personally, my major concern has been converting things *out*
of texinfo, if texinfo is involved at all.
If you can, then you can convert the FreeBSD documents. If you
can't, you can't claim "Linux documentation is better" on that
basis. Period.
The FreeBSD SGML DTD's differences from the LinDoc DTD are calimed
to be there because the LinDoc DTD is different from that expected
by SGML using book publishers. Like O'Reilly.
I you are really that interested in this topic, you should contact
the FreeBSD documentation project (doc@freebsd.org), and they will
happily put you to work.
Terry Lambert
terry@cs.weber.edu
---
Any opinions in this posting are my own and not those of my present
or previous employers.