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