This commit is contained in:
gferg 2000-06-05 15:49:39 +00:00
parent 0159f0f164
commit 5f09b03759
1 changed files with 34 additions and 37 deletions

View File

@ -5,7 +5,7 @@
<title>The Linux HOWTO Index
<author>by Guylhem Aznar, <tt><htmlurl url="mailto:guylhem@oeil.qc.ca" name="guylhem@oeil.qc.ca"></tt>
and Greg Ferguson, <tt><htmlurl url="mailto:gferg@sgi.com" name="gferg@sgi.com"></tt>
<date>v3.8, June 2000</date>
<date>v3.9, June 2000</date>
<abstract>
This document contains an index to the Linux HOWTOs as well as other
@ -19,9 +19,9 @@ information about the HOWTO project.
Linux HOWTOs are documents which describe in detail
a certain aspect of configuring or using Linux. For
example, there is the <EM/Installation HOWTO/, which gives
instructions on installing Linux, and the <EM/Mail HOWTO/, which
instructions on installing Linux, and the <EM/Mail Administrator HOWTO/, which
describes how to set up and configure mail under Linux.
Other examples include the <EM/NET-3 HOWTO/ and the
Other examples include the <EM/Net HOWTO/ and the
<EM/Printing HOWTO/.
HOWTOs are comprehensive docs - much like an FAQ but generally not
@ -29,7 +29,7 @@ information about the HOWTO project.
section at the end.
There are several HOWTO formats available: plain text, PostScript,
DVI, and HTML.
PDF, and HTML.
In addition to the HOWTOs, there are a multitude of mini-HOWTOs on
short, specific subjects.
@ -52,7 +52,7 @@ information about the HOWTO project.
You can also browse HOWTOs
<URL URL="http://www.linuxdoc.org/LDP/HOWTO/"
NAME="in HTML format"> or grab <URL URL="http://www.linuxdoc.org/LDP/HOWTO/Linux-html-HOWTOs.tar.gz"
NAME="in HTML format"> or grab <URL URL="http://metalab.unc.edu/pub/Linux/docs/HOWTO/other-formats/html/Linux-html-HOWTOs.tar.gz"
NAME="Linux-html-HOWTOs.tar.gz"> for viewing on your own PC. The
files will be extracted into HOWTO/html/.
@ -62,7 +62,7 @@ information about the HOWTO project.
<tt/www.linuxdoc.org/ is heavily used, so please use a mirror
site if possible.
HOWTOs are also posted towards the beginning of the month
A HOWTO index is also posted towards the beginning of the month
to the Usenet newsgroup
<tt/comp.os.linux.answers/. There is a tool called
<URL URL="ftp://metalab.unc.edu/pub/Linux/system/news/misc/"
@ -96,7 +96,7 @@ information about the HOWTO project.
and I will add them to this list. If you are interested in getting
your translations archived on metalab.unc.edu, please read the
directory structure specification at
<HTMLURL URL="http://metalab.unc.edu/pub/Linux/docs/HOWTO/translations/Directory-Structure" NAME="http://metalab.unc.edu/pub/Linux/docs/HOWTO/translations/Directory-Structure"> and get in touch with me.
<HTMLURL URL="http://metalab.unc.edu/pub/Linux/docs/HOWTO/translations/Directory-Structure" NAME="http://metalab.unc.edu/pub/Linux/docs/HOWTO/translations/Directory-Structure"> and contact the LDP.
<sect>Index
<SECT1>HOWTOs
@ -188,7 +188,7 @@ device parameters.
How to install, configure and use a busmouse under Linux.
<item><htmlurl url="C++Programming-HOWTO.html" name="C++Programming-HOWTO">,
<BF/C++ Programming HOWTO/ <p><em/Updated: May 2000/.
<BF/C++ Programming HOWTO/ <p><em/Updated: June 2000/.
Discusses methods to avoid memory problems in C++ and
also will help you to program properly in C++ language.
Applies to all operating sytems.
@ -240,7 +240,7 @@ most common applications and services.
A listing of companies providing commercial Linux related support.
<item><htmlurl url="CVS-RCS-HOWTO.html" name="CVS-RCS-HOWTO">,
<BF/CVS-RCS HOWTO for Linux (Source Code Control System)/ <p><em/Updated: April 2000/.
<BF/CVS-RCS HOWTO for Linux (Source Code Control System)/ <p><em/Updated: June 2000/.
A "practical guide" to very quickly setup a CVS/RCS source code
control system.
@ -712,7 +712,7 @@ Addresses Linux localization issues specific to Portuguese users
(written in Portuguese).
<item><htmlurl url="PostgreSQL-HOWTO.html" name="PostgreSQL-HOWTO">,
<BF/Database-SQL-RDBMS HOWTO for Linux (PostgreSQL Object Relational Database System)/ <p><em/Updated: May 2000/.
<BF/Database-SQL-RDBMS HOWTO for Linux (PostgreSQL Object Relational Database System)/ <p><em/Updated: June 2000/.
A "practical guide" to very quickly setup a SQL Database engine and
front end tools on a Unix system.
@ -1070,7 +1070,7 @@ How to install and use a client for the commercial ADSM backup system
for Linux/i386.
<item><htmlurl url="mini/Advocacy.html" name="Advocacy">,
<BF>Linux Advocacy mini-HOWTO</BF> <P><em/Updated: May 1998/.
<BF>Linux Advocacy mini-HOWTO</BF> <P><em/Updated: May 2000/.
Suggestions for how the Linux community can effectively advocate the use of Linux.
<item><htmlurl url="mini/Alsa-sound.html" name="Alsa-sound">,
@ -1614,7 +1614,8 @@ on figures and cannot be distributed in all supported formats.
<P>
The <EM/Graphics mini-HOWTO/, by Michael J. Hammel &lt;mjhammel@graphics-muse.org&gt; is available
at <TT><HTMLURL
URL="http://www.graphics-muse.org/linux/lgh.html" NAME="http://www.graphics-muse.org/linux/lgh.html"></TT>. It is not included with the HOWTO collection because it needs to use a lot of images, which don't translate to other output formats.
URL="http://www.graphics-muse.org/linux/lgh.html" NAME="http://www.graphics-muse.org/linux/lgh.html"></TT>.
It is not included with the HOWTO collection because it needs to use a lot of images, which don't translate to other output formats.
<SECT1>Unmaintained HOWTOs
<P>
@ -1634,32 +1635,22 @@ not-so-hot topics (for ex AX-25 HOWTO).
<sect>Writing and Submitting a HOWTO
<p>
If you are interested in writing or maintaining a HOWTO,
please get in touch with us <bf/FIRST!!!/ at
please contact us <bf/FIRST!!!/ at
<tt><htmlurl url="mailto:ldp-discuss@lists.linuxdoc.org"
name="ldp-discuss@lists.linuxdoc.org"></tt>.
If you want to maintain a unmaintained HOWTO, please also get in
touch with the former author.
If you want to maintain a unmaintained HOWTO, please try to contact
the former author.
<p>
Here are a few guidelines that you should follow when writing a HOWTO:
Consult the <htmlurl url="HOWTO-HOWTO/index.html" name="HOWTO-HOWTO"> for
detailed information on writing and submitting a HOWTO.
<p>
Here are a few general guidelines that you should follow when writing a HOWTO:
<itemize>
<item>Try to use meaningful structure and organization, and write
clearly. Remember that many of the people reading HOWTOs do not
speak English as their first language.
<item>If you are writing a HOWTO, you <EM/must/ use the SGML-Tools
package, available from
<TT><HTMLURL URL="http://www.sgmltools.org/"
NAME="http://www.sgmltools.org/"></TT>,
to format the HOWTO. This package allows us to produce HTML,
LaTeX (for DVI and PostScript), plain text and DocBook sgml from a
single source document, and was designed specifically for the
HOWTOs. This also gives all of the HOWTOs a uniform look. It is
very important that you format and review the output of the
formatting in PostScript, plain text and HTML.
<item>Make sure that all of the information is correct. I can't
stress this enough. When in doubt, speculate, but make it clear that
you're only guessing.
@ -1674,11 +1665,15 @@ not-so-hot topics (for ex AX-25 HOWTO).
documents need an ``FAQ'' or ``Common Problems'' section to cover
information which can't be covered in the regular text.
<item>Use other HOWTOs a model! The SGML source to
the HOWTOs is available on Linux FTP sites. In addition, have a look
at the <URL URL="http://metalab.unc.edu/godoy/using-docbook/using-docbook.html"
NAME="Using DocBook Guide">, the HOWTO-HOWTO, the LDP manifesto and
the LDP license guide.
<item>HOWTOs <EM>should</EM> be submitted to us in either
DocBook or linuxdoc SGML. Refer to the <htmlurl url="HOWTO-HOWTO/index.html" name="HOWTO-HOWTO">
for further information.
<item>Use other HOWTOs a model. The SGML source to
the HOWTOs is available on Linux FTP sites. In addition, examine the
<htmlurl url="HOWTO-HOWTO/index.html" name="HOWTO-HOWTO">, the
<htmlurl url="../manifesto.html" name="LDP manifesto"> (and license guide), and the
<URL URL="http://metalab.unc.edu/godoy/using-docbook/using-docbook.html" name="Using DocBook HOWTO">.
<item>Make sure that your name, email address, date, and a version
number is near the beginning of the document. You could also include
@ -1709,8 +1704,7 @@ not-so-hot topics (for ex AX-25 HOWTO).
we maintain the archives and need to keep track of what HOWTOs
are being written and who is doing what.
Then, all you have to do is send me periodic updates whenever
appropriate.
Please send the LDP periodic updates whenever appropriate.
<sect>Copyright
<p>
@ -1738,4 +1732,7 @@ the HOWTOs.
If you have questions, please contact the Linux HOWTO coordinator, at
<tt><htmlurl url="mailto:linux-howto@metalab.unc.edu"
name="linux-howto@metalab.unc.edu"></tt> via email. </ARTICLE>
name="linux-howto@metalab.unc.edu"></tt> via email.
</ARTICLE>