/usr/share/doc/linuxdoc-tools/html/guide-1.html is in linuxdoc-tools 0.9.71-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.71">
<TITLE>LinuxDoc-Tools User's Guide: Introduction</TITLE>
<LINK HREF="guide-2.html" REL=next>
<LINK HREF="guide.html#toc1" REL=contents>
</HEAD>
<BODY>
<A HREF="guide-2.html"><IMG SRC="next.png" ALT="Next"></A>
<IMG SRC="prev.png" ALT="Previous">
<A HREF="guide.html#toc1"><IMG SRC="toc.png" ALT="Contents"></A>
<HR>
<H2><A NAME="s1">1.</A> <A HREF="guide.html#toc1">Introduction</A></H2>
<P>This document is the user's guide to the LinuxDoc-Tools document
processing system. LinuxDoc-Tools is a suite of programs to help
you write source documents that can be rendered as plain text,
hypertext, or LaTeX files. It contains what you need to know to
set up LinuxDoc-Tools and write documents using it.
See <CODE>example.sgml</CODE> for an example of an LinuxDoc DTD SGML document
that you can use as a model for your own documents.
The ``LinuxDoc'' means the name of a specific SGML DTD here.</P>
<H2><A NAME="ss1.1">1.1</A> <A HREF="guide.html#toc1.1">What's the DTD ?</A>
</H2>
<P>The DTD specifies the names of ``elements'' within the document.
An element is just a bit of structure; like a section, a subsection,
a paragraph, or even something smaller like <EM>emphasized text</EM>.
You may know the HTML has their own DTD.</P>
<P>Don't be confusing. SGML is <EM>not</EM> a text-formatting system.
SGML itself is used only to specify the document structure. There are
no text-formatting facilities or ``macros'' intrinsic to SGML itself.
All of those things are defined within the DTD.
You can't use SGML without a DTD; a DTD defines what SGML does.
For more Detail, please refer the later section of this document
(
<A HREF="guide-6.html#sgml">How LinuxDoc-Tools Works</A>).</P>
<H2><A NAME="ss1.2">1.2</A> <A HREF="guide.html#toc1.2">History of the LinuxDoc</A>
</H2>
<P>The LinuxDoc DTD is created by Matt Welsh as the core part of his
Linuxdoc-SGML document processing system. This DTD is based heavily
on the QWERTZ DTD by Tom Gordon, <CODE>thomas.gordon@gmd.de</CODE>.
The target of the QWERTZ DTD is to provide the simple way to create
LaTeX source for document publishing. Matt Welsh took and shaped it
into Linuxdoc-SGML because he needed it to produce a lot of Linux
Documentations. It can convert a single source of documentation into
various output formats such as plain text, html, and PS. No work for
synchronization between various output formatted documents are needed.</P>
<P>The Linuxdoc-SGML system had been maintained for years by Matt Welsh
and many others, but it has some limitations. Then Cees de Groot came
and created the new system using perl. The new system is called as
``SGML-Tools''. The perl based version for LinuxDoc had been maintained
for a year, then totally new system using the original python scripts
and some stylesheets with the jade has been released. This system is
called as ``SGML-Tools 2.0'' and it does not use the LinuxDoc DTD as
the main DTD, but uses the new standard one, the DocBook DTD.
Now ``SGML-Tools 2.0'' becomes ``SGMLtools-Lite'' and is distributed
from
<A HREF="http://sgmltools-lite.sourceforge.net/">http://sgmltools-lite.sourceforge.net/</A>.</P>
<P>Recently, the DocBook DTD is the standard DTD for the technical
software documentation, and used by many project such as GNOME and
KDE, as well as many professional authors and commercial publishers.
But some people in the LDP, and users of the various LinuxDoc SGML
documents, still needs the support of the tools for the LinuxDoc.
This ``LinuxDoc-Tools'' is created for those people. If you need
the tools for the LinuxDoc DTD, then you may wish to use this. But
remember, the LinuxDoc DTD is not the standard way now even in the
Linux world. If you can, try the DocBook DTD. It is the standard,
and full-featured way of writing the documentations.</P>
<HR>
<A HREF="guide-2.html"><IMG SRC="next.png" ALT="Next"></A>
<IMG SRC="prev.png" ALT="Previous">
<A HREF="guide.html#toc1"><IMG SRC="toc.png" ALT="Contents"></A>
</BODY>
</HTML>
|