From mdw@cs.cornell.edu Fri Jun 10 10:39:43 1994
Article: 18750 of comp.infosystems.www
From: mdw@cs.cornell.edu (Matt Welsh)
Subject: Linuxdoc-SGML v1.1 now available
Summary: SGML-based text formatting package with ASCII/LaTeX/HTML support
Organization: Cornell CS Robotics and Vision Laboratory, Ithaca, NY 14850
Date: Tue, 7 Jun 94 21:43:22 GMT-1:00
Linuxdoc-SGML is available on ftp.cs.cornell.edu/pub/mdw/old/.
Linuxdoc-SGML is a text-formatting package based on SGML (Standard
Generalized Markup Language), which allows you to produce LaTeX, groff,
HTML, and plain ASCII (via groff) documents from a single source. Texinfo
support is forthcoming; 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.
For an example of documents produced by Linuxdoc-SGML, FTP to
sunsite.unc.edu:/pub/Linux/docs/HOWTO/other-formats. You can also
look at http://sunsite.unc.edu/mdw/linux.html
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. Everything else is my fault. :)
Changes in Linuxdoc-SGML in Version 1.1:
* Full HTML support is now there. See the information in
doc/guide.txt.
* Added a <url> element for embedded Universal Resource Locators
in SGML documents. See doc/guide.txt for details.
* Added a <quote> element for quotations (like %lt;tscreen>, but
without typewriter font).
* Added name="..." argument to <ref>. This will allow you to make
cross-references within LaTeX, HTML, and nroff documents
produced by the system. See doc/guide.txt for information on
using this.
* Fixed a number of formatting bugs. Too numerous to mention.
All Linux HOWTOs format well with this new version, so it's
apparently stable.
* Included more information on special characters, etc. in the
User's Guide. Please read this section in doc/guide.txt.
* Modified nroff conversion so that right margins are sloppy.
This actually looks better (no odd spacing between words
when converting to ASCII). You can comment out one line near
the top of rep/nroff/mapping to turn this off.
Please mail comments, questions, and bug reports to me: mdw@sunsite.unc.edu.
Thanks,
mdw
From mdw@cs.cornell.edu Mon Jun 13 11:26:57 1994
Article: 166 of comp.infosystems.www.providers
From: mdw@cs.cornell.edu (Matt Welsh)
Subject: Re: Linuxdoc-SGML v1.1 now available
Organization: Cornell CS Robotics and Vision Laboratory, Ithaca, NY 14850
Date: Fri, 10 Jun 94 18:07:28 GMT-1:00
In article <1994Jun7.194322.21396@cs.cornell.edu> mdw@cs.cornell.edu (Matt Welsh
) writes:
>I have uploaded Linuxdoc-SGML v1.1 to sunsite.unc.edu:/pub/Linux/Incoming.
>It is also available on ftp.cs.cornell.edu:/pub/mdw.
Some folks have had problems compiling Linuxdoc-SGML on Linux systems.
(It's a case of foot-in-mouth disease.)
1. Linux systems generally have GNU flex installed, in which case you need
to edit html-fix/Makefile, and change the two instances of "-ll" to "-lfl".
This applies to other systems where flex is used instead of lex.
2. There is a bug in sgmls-1.1/configure which creeps up if you use bash
or zsh. Change the line:
if test "X$(PREFIX)" != "X/usr/local"
to
if test "X${PREFIX}" != "X/usr/local"
3. You may need to comment out the last three lines in sgmls-1.1/msgcat.h:
nl_catd catopen();
int catclose();
char *catgets();
if you get conflicting prototype errors from nl_types.h when building
the sgmls parser.
4. Also, you need getopt (the program, not the library function) installed,
which is used within the various shell scripts in bin/.
This is available for Linux in
sunsite.unc.edu:/pub/Linux/system/Misc/util-linux-1.6.tar.gz
If you have any problems getting the system to work (on Linux or
any other platform) please get in touch with me.
Cheers,
mdw