From Fri Jun 10 10:39:43 1994
Article: 18750 of comp.infosystems.www
From: (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

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 You can also
look at
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

	* 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:


From Mon Jun 13 11:26:57 1994
Article: 166 of comp.infosystems.www.providers
From: (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 <> (Matt Welsh
) writes:
>I have uploaded Linuxdoc-SGML v1.1 to
>It is also available on

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"
        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

If you have any problems getting the system to work (on Linux or
any other platform) please get in touch with me.