Starting the process of writing a HOWTO can be time consuming. This generator is designed to overcome this problem. This document is itself created with the Generator and thus verifies that it works as designed.
Copyright © 2005-07-11 by Stein Roar Gjoen. You are free:
Use the information in this document at your own risk. I disavow any potential liability for the contents of this document. Use of the concepts, examples, and/or other content of this document is entirely at your own risk.
All copyrights are owned by their owners, unless specifically noted otherwise. Use of a term in this document should not be regarded as affecting the validity of any trademark or service mark.
Naming of particular products or brands should not be seen as endorsements.
You are strongly recommended to take a backup of your system before major installation and backups at regular intervals.
After numerous test versions this is the first public release of the new HOWTO Generator. Initial testing helped locating bugs in the generator itself.
The author is grateful for the work on new categories by Gerd Berget and also acknowledges the initial set by David Merrill
This is based on the large Template and follows the same structure which is the default of this generator.
No cgi-bin is required or even used here. Thus it is possible to work off-line.
Just write in plain ascii text. Formatting and special features are described in the large Template.
Nevertheless remember to escape underscore, ampersand and less than characters.
Note that this Generator is only for the initial SGML authoring; it is as yet not possible to continue updating a document in this Generator.
Plans are underway for on-line editing elsewhere.
While LinuxDoc SGML looks familiar to those who know HTML the markup is nevertheless different. Please refer to the Templates for details on the specifics.
Incorrect use of special characters will cause problems. The Generator will catch a few potential problems but not all.
Please refer to the Templates and the man pages for the LinuxDoc SGML package. Latest version is 1.0.9, an unofficial version.
Trouble with the Generator? Please contact the author for details and have the log at hand.
Try it. Small test at first since there is no reload feature here. Then go for it.
Q: How do I get a paragraph break? A: Just make a double lineshift (one blank line).
Well, this is one example. Please check the SGML code that was generated.