[1215] in linux-announce channel archive
linuxdoc-sgml-1.4
daemon@ATHENA.MIT.EDU (Lars Wirzenius)
Sun Oct 29 08:14:28 1995
Date: Tue, 24 Oct 1995 20:36:39 +0200
From: Lars Wirzenius <wirzeniu@cc.helsinki.fi>
To: linux-announce@vger.rutgers.edu
Reply-To: linux-announce-owner@vger.rutgers.edu
From: gregh@cc.gatech.edu (Greg Hankins)
Newsgroups: comp.os.linux.announce
Subject: linuxdoc-sgml-1.4
Organization: Bastard Squad
Approved: linux-announce@news.ornl.gov (Lars Wirzenius)
Followup-to: comp.os.linux.development.apps
-----BEGIN PGP SIGNED MESSAGE-----
I've just put linuxdoc-sgml-1.4 on sunsite.unc.edu in the Incoming directory.
It should soon be in utils/text. For those of you who don't know what
linuxdoc-sgml is, here is the README file:
*** This is the README file for the linuxdoc-sgml package, version 1.4
*** For more uptodate information, visit the linuxdoc-sgml homepage
at http://www.informatik.tu-muenchen.de/~schwarz/linuxdoc-sgml/
Linuxdoc-SGML is a text-formatting package based on SGML (Standard
Generalized Markup Language), which allows you to produce LaTeX,
HTML, texinfo, and plain ASCII (via groff) from a single source;
due to the flexible nature of SGML many other target formats are possible.
This system is tailored for writing technical software documentation,
an example of which are the Linux HOWTO documents. However, there is nothing
Linux-specific about this package; it can be used for many other types of
documentation on many other systems. The name is simply derived from its
use for the Linux HOWTO documents. It should be useful for all kinds of
printed and online documentation.
The current version of linuxdoc-sgml can be found at
ftp://sunsite.unc.edu/pub/Linux/utils/text/linuxdoc-sgml-1.4.tar.gz
The file doc/guide.sgml is SGML source for the User's Guide. As you
probably don't know how to format it yet, there is formatted plain ASCII
in doc/guide.txt. There's also guide.dvi and guide.ps, if you wish to
print them instead. The first thing you should read is doc/guide.txt,
which explains how to install the software, and how to start writing
documents with it. The file doc/example.sgml is a simple example document
which you can use as a tutorial.
For real-life examples of uses of Linuxdoc-SGML, look at the Linux HOWTOs
on sunsite.unc.edu:/pub/Linux/docs/HOWTO/other-formats/sgml. These HOWTOs
are written in SGML and automatically translated into PostScript, dvi, and
ASCII using this system. You can also look at the URL
http://sunsite.unc.edu/mdw/HOWTO/
which has HTML formats of many Linux HOWTOs, produced using Linuxdoc-SGML.
Linuxdoc-SGML is based on James Clark's sgmls parser, and the QWERTZ
DTD by Tom Gordon. Magnus Alvestad and Helmut Geyer provided the HTML
support, Christian Schwarz wrote the texinfo interface. The linuxdoc-sgml
package was created by Matt Welsh. It is currently maintained by
Greg Hankins <greg.hankins@cc.gatech.edu>.
Please send me any questions or bug reports, as well as suggestions for
improvement. I prefer patches. Specifically, if you're using Linuxdoc-SGML
to write Linux documentation, and would like to see a particular feature
added or changed, please get in touch with me. In this way Linuxdoc-SGML
can be quasi-standard for Linux documentation, and any documents written
in it can be formatted using the same software.
Share and enjoy,
Matt Welsh
Greg Hankins
(and other contributers)
- --
Greg Hankins (greg.hankins@cc.gatech.edu) | Georgia Institute of Technology
Computing and Networking Services | College of Computing, room 213
+1 404 853 9989 | Atlanta, GA 30332-0280
<A HREF="http://www.cc.gatech.edu/staff/h/Greg.Hankins/">Greg Hankins</A>
<A HREF="http://www.cc.gatech.edu/staff/h/Greg.Hankins/pubkey.asc">PGP key</A>
-----BEGIN PGP SIGNATURE-----
Version: 2.6.2i
iQCVAwUBMI0vfoQRll5MupLRAQG8IgQAjG2SfwzhKgDpCihwdUT0lqoMGRB4Azjh
ELLxNDKDVLFKgHga4cRvGqw40boHfe6bxxby6Fl4boNtBceVGTZYUn6Qq46ls/q4
Y9/nWN2G/bgSULYZPf4CP+UGduZLlLHADHZmQ8h58d5mx6oEZnePwFJ1IhpzVj55
8snHOQ4hLZI=
=OH87
-----END PGP SIGNATURE-----
--
This article has been digitally signed by the moderator, using PGP.
Finger wirzeniu@kruuna.helsinki.fi for PGP key needed for validating signature.
Send submissions for comp.os.linux.announce to: linux-announce@news.ornl.gov
PLEASE remember a short description of the software and the LOCATION.
