The Linux HOWTO Index
by Greg Hankins, gregh@sunsite.unc.edu
v2.10.23, 18 June 1997
This document contains an index to the Linux HOWTOs and mini-HOWTOs,
as well as other information about the HOWTO project.
1. What Are Linux HOWTOs?
Linux HOWTOs are documents which describe in detail a certain aspect
of configuring or using Linux. For example, there is the Installation
HOWTO, which gives instructions on installing Linux, and the Mail
HOWTO, which describes how to set up and configure mail under Linux.
Other examples include the NET-3 HOWTO and the Printing HOWTO.
HOWTOs are comprehensive docs - much like an FAQ but generally not in
question-and-answer format. However, many HOWTOs contain an FAQ
section at the end.
There are several HOWTO formats available: plain text, PostScript,
DVI, and HTML.
In addition to the HOWTOs, there are a multitude of mini-HOWTOs.
These are short, specific HOWTOs, such as the Colour-ls mini-HOWTO.
They are only available in plain text format.
2. Where Do I Get Linux HOWTOs?
HOWTOs can be retrieved via anonymous FTP from the following sites:
· ftp://sunsite.unc.edu/pub/Linux/docs/HOWTO
· ftp://tsx-11.mit.edu/pub/linux/docs/HOWTO
as well as many mirror sites.
You can also browse HOWTOs in HTML format
. Many mirror sites
mirror the HTML files.
sunsite.unc.edu is heavily used, so please use a mirror site if
possible.
HOWTOs are also posted monthly to the Usenet newsgroup
comp.os.linux.answers.
2.1. HOWTO Translations
HOWTO translations are available on sunsite.unc.edu
and mirrors
around the world. So far there are:
· French (fr)
· German (de)
· Italian (it)
· Japanese (jp)
· Polish (pl)
· Spanish (es)
· Swedish (sv)
· Turkish (tr)
If you know of any other translation projects, please let me know and
I will add them to this list. If you are interested in getting your
translations archived on sunsite.unc.edu, please read the directory
structure specification at
http://sunsite.unc.edu/pub/Linux/docs/HOWTO/translations/Directory-
Structure and get in touch with me.
3. HOWTO Index
The following Linux HOWTOs are currently available:
· AX25 HOWTO, by Terry Dawson .
How to configure AX25 networking for Linux. Updated 2 March 1997.
· Access HOWTO, by Michael De La Rue . How to
use adaptive technology with Linux. Updated 28 March 1997.
· Assembly HOWTO, by François-René Rideau .
Information on programming in x86 assembly. Updated 30 March 1997.
· BootPrompt HOWTO, by Paul Gortmaker .
List of boot time arguments and overview of booting software.
Updated 6 December 1996.
· Bootdisk HOWTO, by Graham Chapman . How to
create a boot/root maintenance disk for Linux. Updated 4 April
1997.
· Busmouse HOWTO, by Mike Battersby . Information
on bus mouse compatibility with Linux. Updated 2 August 1994.
· CDROM HOWTO, by Jeff Tranter . Information
on CDROM drive compatibility for Linux. Updated 5 January 1997.
· Chinese HOWTO, by Hong Zhang . How to
configure Linux for use with the Chinese characterset. Updated 2
April 1997.
· Commercial HOWTO, by Martin Michlmayr . Listing of
commercial software products for Linux. Updated 30 May 1997.
· Consultants HOWTO, by Martin Michlmayr . Listing
of Linux consultants. Updated 13 June 1997.
· Cyrillic HOWTO, by Alexander L. Belikoff
. How to configure Linux for use with
the Cyrillic characterset. Updated 23 April 1997.
· DNS HOWTO, by Nicolai Langfeldt . How to set up
DNS. Updated 3 June 1997.
· DOS to Linux HOWTO, by Guido Gonzato .
How to move from DOS to Linux. Updated 11 December 1996.
· DOSEMU HOWTO, by Uwe Bonnes . HOWTO about the Linux MS-DOS Emulator, DOSEMU.
Updated dosemu-0.64.4 (in progress), 15 March 1997.
· Danish HOWTO, by Niels Kristian Bech Jensen . How
to configure Linux for use with the Danish characterset. Updated
31 May 1997.
· Distribution HOWTO, by Eric S. Raymond . A
list of Linux distributions. Updated 14 March 1997.
· ELF HOWTO, by Daniel Barlow . How to
install and migrate to the ELF binary file format. Updated 14 July
1996.
· Emacspeak HOWTO, by Jim Van Zandt . How to
use 'emacspeak' with Linux. Updated 2 February 1997.
· Ethernet HOWTO, by Paul Gortmaker .
Information on Ethernet hardware compatibility for Linux. Updated
2 February 1997.
· Finnish HOWTO, by Pekka Taipale . How to configure
Linux for use with the Finnish characterset. Updated 14 February
1996.
· Firewall HOWTO, by Mark Grennan, . How to set
up a firewall using Linux. Updated 8 November 1996.
· Ftape HOWTO, by Kevin Johnson . Information on
ftape drive compatibility with Linux. Updated 15 March 1997.
· GCC HOWTO, by Daniel Barlow . How to set
up the GNU C compiler and development libraries. Updated 28
February 1996.
· German HOWTO, by Winfried Trümper . Information
on using Linux with German-specific features. Updated 19 March
1997.
· HAM HOWTO, by Terry Dawson .
HOWTO configure amateur radio software for Linux. Updated 1 April
1997.
· HOWTO Index, by Greg Hankins . Index of
HOWTO documents about Linux. Updated 18 June 1997.
· Hardware Compatibility HOWTO, by Patrick Reijnen
. A list of hardware known to work with Linux.
Updated 14 June 1997.
· Hebrew HOWTO, by Yair G. Rajwan . How to
configure Linux for use with the Hebrew characterset. Updated 12
September 1995.
· INFO-SHEET, by Michael K. Johnson . Generic
introduction to the Linux operating system. Updated 13 January
1997.
· IPX HOWTO, by Terry Dawson . How
to install and configure IPX networking. Updated 29 March 1997.
· ISP Hookup HOWTO, by Egil Kvaleberg . Basic
introduction to hooking up to an ISP. Updated 9 December 1996.
· Installation HOWTO, by Eric S. Raymond .
How to obtain and install Linux. Updated 15 May 1997.
· Italian HOWTO, by Marco ``Gaio'' Gaiarin . How
to configure Linux for use with the Italian characterset. Updated
17 February 1997.
· Java-CGI HOWTO, by David H. Silber . How to set up
Java-capable CGI bin. Updated 18 November 1996.
· Kernel HOWTO, by Brian Ward .
Upgrading and compiling the Linux kernel. Updated 26 May 1997.
· Keyboard and Console HOWTO, by Andries Brouwer .
Information about the Linux keyboard, console and non-ASCII
characters. Updated 16 March 1997.
· META-FAQ, by Michael K. Johnson . A listing
of Linux sources of information. Updated 20 December 1996.
· MGR HOWTO, by Vincent Broman . Information on the
MGR graphics interface for Linux. Updated 30 May 1996.
· Electronic Mail HOWTO, by Vince Skahan .
Information on Linux-based mail servers and clients. Updated 29
November 1995.
· Module HOWTO, by Lauri Tischler . How to load
modules and a listing of parameters. Updated 20 October 1996.
· NET-3 HOWTO, by Terry Dawson .
Howto configure TCP/IP networking under Linux. Updated 29 March
1997.
· NFS HOWTO, by Nicolai Langfeldt . How to set up
NFS clients and servers. Updated 9 March 1997.
· NIS HOWTO, by Erwin Embsen . Information on using
NIS/YP on Linux systems. Updated 14 November 1996.
· News HOWTO, by Vince Skahan . Information on
USENET news server and client software for Linux. Updated 29
November 1995.
· PCI HOWTO, by Michael Will .
Information on PCI-architecture compatibility with Linux. Updated
30 March 1997.
· PCMCIA HOWTO, by Dave Hinds . How to
install and use PCMCIA Card Services. Updated 24 April 1997.
· PPP HOWTO, by Robert Hart . Information on
using PPP networking with Linux. Updated 31 March 1997.
· Polish HOWTO, by Sergiusz Pawlowicz .
Information on using Linux with Polish-specific features. Updated
5 January 1997.
· Portuguese HOWTO, by Joao Carlos Rodrigues Pereira
. How to configure Linux for use with
the Portuguese characterset. Updated 14 September 1995.
· Printing HOWTO, by Grant Taylor . HOWTO
on printing software for Linux. Updated 10 September 1996.
· Printing Usage HOWTO, by Mark Komarinski . How
to use the printing system for a variety of file types and options.
Updated 24 March 1997.
· SCSI HOWTO, by Drew Eckhardt . Information on
SCSI driver compatibility with Linux. Updated 30 August 1996.
· SCSI Programming HOWTO, by Heiko Eissfeldt
. Information on programming the generic
Linux SCSI interface. Updated 7 May 1996.
· SMB HOWTO, by David Wood . How to use the
Session Message Block (SMB) protocol with Linux. Updated 10 August
1996.
· Serial HOWTO, by Greg Hankins . How on
use serial devices (modems, terminals) with Linux. Updated 31
March 1997.
· Shadow Password HOWTO, by Michael H. Jackson .
How to obtain, install, and configure shadow passwords. Updated 3
April 1996.
· Slovenian HOWTO, by Primoz Peterlin . Information on using Linux with Slovenian-specific
features. Updated 30 October 1996.
· Sound HOWTO, by Jeff Tranter . Sound
hardware and software for the Linux operating system. Updated 5
January 1997.
· Sound Playing HOWTO, by Yoo C. Chung .
How to play various sound formats under Linux. Updated 13 May
1997.
· Spanish HOWTO, by Gonzalo Garcia Agullo . Information on using Linux with Spanish-specific
features. Updated 20 August 1996.
· teTeX HOWTO, by Robert Kiesling .
How to install the teTeX package (TeX and LaTeX) under Linux.
Updated 14 May 1997.
· Thai HOWTO, by Poonlap Veeratanabutr . How
to configure Linux for use with the Thai characterset. Updated 26
May 1997.
· Tips HOWTO, by Paul Anderson . HOWTO on
miscellaneous tips and tricks for Linux. Updated 7 January 1997.
· UMSDOS HOWTO, by Jacques Gelinas . How to
install and use the UMSDOS filesystem. Updated 13 November 1995.
· UPS HOWTO, by Harvey J. Stein . Information
on using a UPS power supply with Linux. Updated 31 March 1997.
· UUCP HOWTO, by Vince Skahan . Information on
UUCP software for Linux. Updated 29 November 1995.
· VAR HOWTO, by Martin Michlmayr . Listing of Linux
value added resellers. Updated 30 May 1997.
· VMS to Linux HOWTO, by Guido Gonzato .
How to move from VMS to Linux. Updated 18 March 1997.
· WWW HOWTO, by Peter Dreuw . How to set up WWW
clients and servers. Updated 6 October 1996.
· XFree86 HOWTO, by Eric S. Raymond . How to
obtain, install, and configure XFree86 3.2 (X11R6). Updated 26
March 1997.
The following mini-HOWTOs are available (plain text only):
· 3 Button Mouse mini-HOWTO, by Geoff Short
. How to configure your mouse to use 3
buttons. Updated 25 October 1996.
· ADSM Backup mini-HOWTO, by Thomas Koenig . How to install and use the ADSM backup program.
Updated 15 January 1997.
· AI-Alife mini-HOWTO, by John A. Eikenberry .
Information about AI software for Linux. Updated 19 May 1997.
· Advocacy mini-HOWTO, by Paul L. Rogers .
Suggestions on how to advocate the use of Linux. Updated 6
February 1997.
· Backup with MSDOS mini-HOWTO, by Christopher Neufeld
. How to backup Linux machines with
MSDOS. Updated 6 February 1996.
· Battery Powered mini-HOWTO, by Hanno Mueller .
How to reduce a Linux system's power consumption. Updated 5 May
1997.
· Boca mini-HOWTO, by David H Dennis .
How to install a Boca 16-port serial card (Boca 2016). Updated 16
February 1995.
· BogoMips mini-HOWTO, by Wim C.A. van Dorst
. Information about BogoMips. Updated 30
May 1997.
· Bridge mini-HOWTO, by Chris Cole . How
to setup and ethernet bridge. Updated 23 August 1996.
· Bridge+Firewall mini-HOWTO, by Peter Breuer . How
to setup and ethernet bridge and firewall. Updated 23 December
1996.
· CD Writing mini-HOWTO, by Winfried Trümper . How
to write CDs. Updated 18 March 1997.
· Clock mini-HOWTO, by Ron Bean . How to set and
keep your clock on time. Updated December 1996.
· Colour ls mini-HOWTO, by Thorbjoern Ravn Andersen .
How to set up the colours with 'ls'. Updated 27 April 1996.
· Comeau C++ mini-HOWTO, by Mark Swanson .
How to set up Comeau C++. Updated 16 May 1997.
· DHCPd mini-HOWTO, by Paul Makeev . How to get
Linux to serve DHCP information. Updated 5 March 1997.
· Dial On Demand mini-HOWTO, by Rodney van den Oever
. How to use dial-on-demand dialing
to dial an ISP. Updated 29 February 1997.
· Diald mini-HOWTO, by Harish Pillay . How to use
'diald' to dial an ISP. Updated 3 June 1996.
· Dip+SLiRP+CSLIP mini-HOWTO, by Zenon Fortuna .
How to use Dip+SLiRP+CSLIP together. Updated 15 October 1995.
· Diskless mini-HOWTO, by Robert Nemkin . How to
set up a diskless Linux box. Updated 31 May 1996.
· Dynamic IP Hacks mini-HOWTO, by Michael Driscoll
. Tips and tricks for people with dynamic
IP addresses. Updated 25 May 1997.
· Ext2fs Undeletion mini-HOWTO, by Aaron Crane .
How to retrieve deleted files from an ext2 filesystem. Updated 18
January 1997.
· GTEK BBS-550 mini-HOWTO, by Wajihuddin Ahmed
. How to setup the GTEK BBS-550 multiport
board with Linux. Updated 20 November 1996.
· GUI Development mini-HOWTO, by Philip Markwalder
. Information about GUI Development
Software and Books. Updated 6 June 1995.
· Graphics Tools mini-HOWTO, by Michael J. Hammel .
Introduction to graphics tools available for Linux. Updated 15 May
1996.
· Gravis-UltraSound mini-HOWTO, by J-F Mammet . How to install the Gravis UltraSound PnP card. Updated
27 March 1996.
· HTML Validation mini-HOWTO, by Keith M. Corbett
. How to validate HTML 2.0 documents with
nsgmls. Updated 29 October 1995.
· HTTP+Netware mini-HOWTO, by Pramod Karnad
. How to setup a Linux HTTP server on a
Netware LAN. Updated 14 March 1996.
· IO Port Programming mini-HOWTO, by Riku Saikkonen
. How to use I/O ports in C programs.
Updated 30 March 1997.
· IP Alias mini-HOWTO, by Harish Pillay . How to
use IP aliasing. Updated 13 January 1997.
· IP Masquerade mini-HOWTO, by Ambrose Au . How
to use IP masquerading. Updated 1 January 1997.
· IP Subnetworking mini-HOWTO, by Robert Hart
. Why and how to subnetwork an IP network.
Updated 31 March 1997.
· Jaz Drive mini-HOWTO, by Bob Willmot . How to
use an Iomega Jaz drive with Linux. Updated 4 June 1997.
· Kerneld mini-HOWTO, by Henrik Storner .
How to use 'kerneld' (dynamic module loading). Updated 6 April
1997.
· Key Setup mini-HOWTO, by Stephen Lee . How to
set up cursor control keys. Updated 16 September 1995.
· LBX mini-HOWTO, by Paul D. Smith . How to
use Low-Bandwidth X (LBX). Updated 23 October 1995.
· LF1000 mini-HOWTO, by Skip Rye . How
to use the Panasonic LF1000 optical disk drive. Updated 29 March
1996.
· LILO mini-HOWTO, by Cameron Spitzer .
Examples of typical LILO installations. Updated 4 June 1995.
· Linux+DOS+Win95 mini-HOWTO, by Alan L. Wendt
. How to use Linux and DOS and Windows95
together. Updated 10 September 1996.
· Linux+NT-Loader mini-HOWTO, by Bernd Reichert .
How to use Linux and the Windows NT boot loader together. Updated
5 May 1997.
· Linux+OS2+DOS mini-HOWTO, by Hamish Moffatt
. How to use Linux and OS/2 and
DOS together. Updated 20 May 1996.
· Linux+DOS+Win95+OS2 mini-HOWTO, by Mike Harlan
. How to use Linux and DOS and OS/2 and
Win95 together. Updated 6 March 1996.
· Linux+Win95 mini-HOWTO, by Jonathan Katz . How to
use Linux and Windows95 together. Updated 25 June 1996.
· Linux+WinNT mini-HOWTO, by Bill Wohler
. How to use Linux and WindowsNT
together. Updated 19 February 1997.
· Large Disk mini-HOWTO, Andries Brouwer . How to use
disks with > 1024 cylinders. Updated 26 July 1996.
· Locales mini-HOWTO, by Peeter Joot . How to
configure Linux to use locales. Updated 14 December 1996.
· MIDI+SB mini-HOWTO, by Hideki Saito . How to a
MIDI keyboard with a Sound Blaster. Updated 13 October 1996.
· Mail Queue mini-HOWTO, by Leif Erlingsson
. How to queue remote mail and
deliver local mail. Updated 22 March 1997.
· Mail2News mini-HOWTO, by Robert Hart . How to
set up a mail to news gateway. Updated 4 November 1996.
· Man Page mini-HOWTO, by Jens Schweikhardt .
How to write man pages. Updated March 1997.
· Modeline mini-HOWTO, by Rick Niles .
How to use 'modeline'. Updated 11 February 1995.
· Multiple Disks Layout mini-HOWTO, by Gjoen Stein .
How to layout partitions on multiple disks. Updated 23 March 1997.
· Multiple Ethernet mini-HOWTO, by Don Becker
. How to use multiple ethernet cards.
Updated 5 August 1995.
· NFS-Root mini-HOWTO, by Andreas Kostyrka . How
to set up diskless Linux machines. Updated 3 February 1997.
· NFS-Root-Client mini-HOWTO, by Ofer Maor . How
to set up diskless Linux machines using NFS. Updated 5 December
1996.
· Netscape+Proxy mini-HOWTO, by Sarma Seetamraju .
How to set up a proxy server for Netscape. Updated October 1996.
· Offline Mailing mini-HOWTO, by Gunther Voet . How
to set up email addresses without a dedicated Internet connection.
Updated 10 June 1997.
· Online Support mini-HOWTO, by lilo .
Information about the Linux Internet Support Cooperative. Updated
7 May 1996.
· PLIP mini-HOWTO, by Andrea Controzzi .
How to set up PLIP (Parallel Line Interface Protocol). Updated 22
August 1996.
· PPP-over-ISDN mini-HOWTO, by R Marc Phillips .
How to set up MLPPP over ISDN. Updated 13 April 1996.
· PPP-over-minicom mini-HOWTO, by Winfried Trümper
. How to use minicom to start PPP. Updated 9
December 1996.
· Process Accounting mini-HOWTO, by Albert M.C. Tam .
How to set up process accounting. Updated 29 July 1996.
· Proxy ARP mini-HOWTO, by Al Longyear . A
small treatise on the use of Proxy ARP. Updated 5 December 1994.
· Pager mini-HOWTO, by Chris Snell . How to set
up an alphanumeric paging gateway. Updated 15 June 1997.
· Partition mini-HOWTO, by Kristian Koehntopp .
How to choose disk partitions. Updated 24 January 1997.
· Print2Win mini-HOWTO, by Harish Pillay . How to
use SAMBA to print to Windows. Updated 3 June 1996.
· Public Web Browser mini-HOWTO, by Donald B. Marti Jr.
. How to set up a guest account to use a WWW
browser. Updated 2 February 1997.
· Qmail+MH mini-HOWTO, by Christopher Richardson
. How to install qmail and MH. Updated 13
June 1997.
· Quota mini-HOWTO, by Albert M.C. Tam . How to set
up disk quotas. Updated 27 July 1996.
· Reading List, by James H. Haynes .
Interesting books pertaining to Linux subjects. Updated 24
February 1996.
· Remote Boot mini-HOWTO, by Marc Vuilleumier Stückelberg
. How to set up a
server-based boot selector. Updated 29 April 1997.
· SLIP+proxyARP mini-HOWTO, by Dave Kennedy . How
to use SLIP and Proxy ARP to connect LANs to the net. Updated 20
November 1996.
· Sendmail+UUCP mini-HOWTO, by Jamal Hadi Salim .
How to use sendmail and UUCP together. Updated 15 March 1997.
· Serial Port Programming mini-HOWTO, by Antonino Iannella
. How to use serial ports in C programs.
Updated 9 March 1997.
· Soundblaster-16 mini-HOWTO, by Eric Z. Ayers
. How to install the Soundblaster 16 PnP
card. Updated 14 January 1997.
· StarOffice mini-HOWTO, by Matthew Borowski .
Information on installing the StarOffice suite. Updated 9 June
1997.
· Swap Space mini-HOWTO, by H. Peter Anvin . How
to share swap space between Linux and Windows. Updated 19 June
1995.
· TIA mini-HOWTO, by Irish . How to use 'TIA' with
Linux. Updated 16 December 1995.
· Term Firewall mini-HOWTO, by Barak Pearlmutter
. How to use 'term' over a
firewall. Updated 22 May 1996.
· Tiny News mini-HOWTO, by Kent Lewis . How
to use 'INN' to make a small news spool. Updated 25 May 1995.
· Token Ring mini-HOWTO, by Mike Eckhoff
. How to use token ring cards.
Updated 30 April 1997.
· Upgrade mini-HOWTO, by Greg Louis . How to
upgrade your Linux distribution. Updated 6 June 1996.
· VPN mini-HOWTO, by Árpád Magosányi . How
to set up a VPN (Virtual Private Network). Updated 3 May 1997.
· Virtual Web mini-HOWTO, by Dan Pancamo . How
to set up a virtual WWW site. Updated 24 November 1995.
· Virtual wu-ftpd mini-HOWTO, by Winfried Trümper .
How to set up wu-ftpd with virtual domains. Updated 27 January
1997.
· Visual Bell mini-HOWTO, by Alessandro Rubini
. How to disable audible bells, and enable
visual bells. Updated August 1996.
· Win95+Win+Linux mini-HOWTO, by Robert Goodwin
. How to get Windows95, Windows 3.x and
Linux to work. Updated 4 August 1996.
· WordPerfect mini-HOWTO, by Wade Hampton . How to
set up SCO WordPerfect for Linux. Updated 17 May 1995.
· X Big Cursor mini-HOWTO, by Joerg Schneider .
How to use enlarged cursors with XWindows. Updated 12 September
1996.
· X Notebook mini-HOWTO, by Darin Ernst . How to
set up X on notebooks with WD90C24 video chips. Updated 10 August
1995.
· XFree86-XInside mini-HOWTO, by Marco Melgazzi .
How to convert XFree86 to XInside modelines. Updated May 1997.
· xterm Title mini-HOWTO, by Winfried Trümper .
How to put strings into the titlebar of an xterm. Updated 22
October 1996.
· Xterminal mini-HOWTO, by Scot W. Stevenson .
How to connect Xterminals to Linux boxen. Updated July 1995.
· ZIP Drive mini-HOWTO, by Grant Guenther . How to
use an Iomega ZIP drive with Linux. Updated 15 April 1996.
· ZIP Install mini-HOWTO, by John Wiggins .
How to install Linux onto a ZIP drive. Updated 5 December 1996.
4. Writing and Submitting a HOWTO
If you are interested in writing a HOWTO or mini-HOWTO, please get in
touch with me FIRST!!! at gregh@sunsite.unc.edu.
Here are a few guidelines that you should follow when writing a HOWTO
or mini-HOWTO:
· 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.
· If you are writing a HOWTO, you must use the SGML-Tools package,
available from http://web.inter.nl.net/users/C.deGroot/sgmltools,
to format the HOWTO. This package allows us to produce LaTeX (for
DVI and PostScript), plain text, and HTML from a single source
document, and was designed specifically for the HOWTOs. This also
gives all of the HOWTOs a uniform look.
· If you are writing a mini-HOWTO, you can use any form you wish.
mini-HOWTOs are meant to be short, free-form HOWTOs on very
specific subjects. In general, these should be quick to write and
maintain, so it's not worth bothering with the Linuxdoc-SGML
package. This does not mean that the mini-HOWTOs are any less
important! Only plain text versions of mini-HOWTOs are
distributed.
· 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.
· Make sure that you are covering the most recent version of the
available software. Also, be sure to include full instructions on
where software can be downloaded from (FTP site name, full
pathname), and the current version number and release date of the
software.
· Include an FAQ section at the end, if appropriate. Many HOWTO
documents need an ``FAQ'' or ``Common Problems'' section to cover
information which can't be covered in the regular text.
· Use other HOWTOs or mini-HOWTOs as a model! The SGML source to the
HOWTOs is available on Linux FTP sites.
· Make sure that your name, email address, date, and a version number
is near the beginning of the document. You could also include WWW
addresses and a snail mail address if you want.
· Lastly, be prepared to receive questions and comments about your
writing. There are several hundreds of accesses to the HOWTO
collection every day from around the world!
After you have written the HOWTO, mail it to me. If you used SGML-
Tools, simply mail me the SGML source; I take care of formatting the
documents. I'll also take care of archiving the HOWTOs on
sunsite.unc.edu and posting them to the various newsgroups.
It is important that you go through me when submitting a HOWTO, as I
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.
5. Copyright
Unless otherwise stated, Linux HOWTO documents are copyrighted by
their respective authors. Linux HOWTO documents may be reproduced and
distributed in whole or in part, in any medium physical or electronic,
as long as this copyright notice is retained on all copies. Commercial
redistribution is allowed and encouraged; however, the author would
like to be notified of any such distributions.
All translations, derivative works, or aggregate works incorporating
any Linux HOWTO documents must be covered under this copyright notice.
That is, you may not produce a derivative work from a HOWTO and impose
additional restrictions on its distribution. Exceptions to these rules
may be granted under certain conditions; please contact the Linux
HOWTO coordinator at the address given below.
In short, we wish to promote dissemination of this information through
as many channels as possible. However, we do wish to retain copyright
on the HOWTO documents, and would like to be notified of any plans to
redistribute the HOWTOs.
If you have questions, please contact Greg Hankins, the Linux HOWTO
coordinator, at gregh@sunsite.unc.edu via email.