The Linux HOWTO Index
by Greg Hankins, gregh@sunsite.unc.edu
v2.10.63, 24 March 1998
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 on
short, specific subjects. They are only available in plain text and
HTML format.
2. Where Can 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 towards the beginning of the month to the
Usenet newsgroup comp.os.linux.answers. There is a tool called
NewstoHOWTO that
will assemble the postings.
2.1. HOWTO Translations
HOWTO translations are available on sunsite.unc.edu
and mirrors
around the world. So far there are:
ˇ Chinese (zh)
ˇ French (fr)
ˇ German (de)
ˇ Hellenic (el)
ˇ Italian (it)
ˇ Indonesian (id)
ˇ Japanese (ja)
ˇ Korean (ko)
ˇ 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. Index
3.1. HOWTOs
The following Linux HOWTOs are currently available:
ˇ 3Dfx HOWTO, by Bernd Kreimeier . How to use 3Dfx
graphics accelerator chip support. Updated 12 July 1997.
ˇ AX25 HOWTO, by Terry Dawson .
How to configure AX25 networking for Linux. Updated 17 October
1997.
ˇ Access HOWTO, by Michael De La Rue . How to
use adaptive technology with Linux. Updated 28 March 1997.
ˇ Alpha HOWTO, by David Mosberger . Overview
of Alpha systems and processors. Updated 6 June 1997.
ˇ Assembly HOWTO, by François-René Rideau .
Information on programming in x86 assembly. Updated 16 November
1997.
ˇ Benchmarking HOWTO, by André D. Balsa . How
to do basic benchmarking. Updated 15 August 1997.
ˇ BootPrompt HOWTO, by Paul Gortmaker .
List of boot time arguments and overview of booting software.
Updated 1 February 1998.
ˇ Bootdisk HOWTO, by Graham Chapman . How to
create a boot/root maintenance disk for Linux. Updated 4 April
1997.
ˇ Busmouse HOWTO, by Chris Bagwell .
Information on bus mouse compatibility with Linux. Updated 1
February 1998.
ˇ CD Writing HOWTO, by Winfried Trümper . How to
write CDs. Updated 16 December 1997.
ˇ CDROM HOWTO, by Jeff Tranter . Information
on CDROM drive compatibility for Linux. Updated 1 November 1997.
ˇ Chinese HOWTO, by Chih-Wei Huang . How to
configure Linux for use with the Chinese characterset. Updated 10
February 1998.
ˇ Commercial HOWTO, by Martin Michlmayr . Listing of
commercial software products for Linux. Updated 28 February 1998.
ˇ Config HOWTO, by Guido Gonzato . How to
fine-tune and customize your Linux system. Updated 4 November
1997.
ˇ Consultants HOWTO, by Martin Michlmayr . Listing
of Linux consultants. Updated 13 March 1998.
ˇ Cyrillic HOWTO, by Alexander L. Belikoff . How to
configure Linux for use with the Cyrillic characterset. Updated 23
January 1998.
ˇ DNS HOWTO, by Nicolai Langfeldt . How to set up
DNS. Updated 26 February 1998.
ˇ DOS to Linux HOWTO, by Guido Gonzato . How
to move from DOS to Linux. Updated 31 October 1997.
ˇ DOSEMU HOWTO, by Uwe Bonnes . HOWTO about the Linux MS-DOS Emulator, DOSEMU.
Updated 15 March 1997 for dosemu-0.64.4 (in progress).
ˇ Danish HOWTO, by Niels Kristian Bech Jensen . How
to configure Linux for use with the Danish characterset. Updated
23 January 1998.
ˇ Distribution HOWTO, by Eric S. Raymond . A
list of Linux distributions. Updated 31 October 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 21 Dececember 1997.
ˇ Ethernet HOWTO, by Paul Gortmaker .
Information on Ethernet hardware compatibility for Linux. Updated
1 February 1998.
ˇ 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.
ˇ French HOWTO, by Guylhem Aznar . How
to configure Linux for use with the French characterset. Updated
August 1997.
ˇ 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.
ˇ Glibc2 HOWTO, by Eric Green . How to install and
migrate to the glibc2 library. Updated 11 January 1998.
ˇ 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 March 1998.
ˇ Hardware Compatibility HOWTO, by Patrick Reijnen
. A list of hardware known to
work with Linux. Updated 10 December 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 24 October
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 14 February 1997.
ˇ Installation HOWTO, by Eric S. Raymond .
How to obtain and install Linux. Updated 22 October 1997.
ˇ Intranet Server HOWTO, by Pramod Karnad .
How to setup a Linux Intranet server. Updated 7 August 1997.
ˇ Italian HOWTO, by Marco ``Gaio'' Gaiarin . How
to configure Linux for use with the Italian characterset. Updated
6 August 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 November 1997.
ˇ META-FAQ, by Michael K. Johnson . A listing
of Linux sources of information. Updated 25 October 1997.
ˇ MGR HOWTO, by Vincent Broman . Information on the
MGR graphics interface for Linux. Updated 30 May 1996.
ˇ MILO HOWTO, by David A. Rusling .
How to use the Alpha Linux Miniloader (MILO). Updated 6 December
1996.
ˇ Mail HOWTO, by Guylhem Aznar .
Information on electronic mail servers and clients. Updated
January 1998.
ˇ Multi-Disk HOWTO, by Stein Gjoen . How to setup
multiple hard disk drives. Updated 3 February 1998.
ˇ NET-3 HOWTO, by Terry Dawson .
Howto configure TCP/IP networking under Linux. Updated 20 August
1997.
ˇ NFS HOWTO, by Nicolai Langfeldt . How to set up
NFS clients and servers. Updated 3 November 1997.
ˇ NIS HOWTO, by Thorsten Kukuk .
Information on using NIS/YP on Linux systems. Updated 10. January
1998.
ˇ Optical Disk HOWTO, by Skip Rye . How to use
optical disk drives with Linux. Updated 22 December 1997.
ˇ Oracle HOWTO, by Paul Haigh . How to
setup Oracle as a database server. Updated 10 March 1998.
ˇ 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 19 February 1998.
ˇ PPP HOWTO, by Robert Hart . Information on
using PPP networking with Linux. Updated 31 March 1997.
ˇ Parallel Processing HOWTO, by Hank Dietz .
Discussion of parallel processing approaches for Linux. Updated 5
January 1998.
ˇ Pilot HOWTO, by David H. Silber . How to use a
USR Pilot PDA with Linux. Updated 17 August 1997.
ˇ Polish HOWTO, by Sergiusz Pawlowicz .
Information on using Linux with Polish-specific features. Updated
5 January 1997.
ˇ PostgreSQL HOWTO, by Al Dev (Alavoor Vasudevan)
. How to setup PostgreSQL as a database server.
Updated 21 December 1997.
ˇ Printing HOWTO, by Grant Taylor . HOWTO
on printing software for Linux. Updated 23 September 1997.
ˇ Printing Usage HOWTO, by Mark Komarinski . How
to use the printing system for a variety of file types and options.
Updated 24 March 1997.
ˇ RPM HOWTO, by Donnie Barnes . How to use the Red
Hat Package Manager (.rpm). Updated 8 April 1997.
ˇ Reading List HOWTO, by Eric S. Raymond .
Interesting books pertaining to Linux subjects. Updated 29
November 1997.
ˇ Root RAID HOWTO, by Michael A. Robinton . How to
create a root-mounted RAID filesystem. Updated 12 February 1998.
ˇ 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.
ˇ SRM HOWTO, by David Mosberger . How to boot
Linux/Alpha using the SRM firmware. Updated 17 August 1996.
ˇ Security HOWTO, by Kevin Fenzi . General overview
of security issues. Updated 1 March 1998.
ˇ Serial Programming HOWTO, by Peter H. Baumann
. How to use serial ports in programs.
Updated 22 January 1998.
ˇ 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 1
November 1997.
ˇ Sound Playing HOWTO, by Yoo C. Chung .
How to play various sound formats under Linux. Updated 7 November
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 21
August 1997.
ˇ Thai HOWTO, by Poonlap Veeratanabutr . How
to configure Linux for use with the Thai characterset. Updated 16
July 1997.
ˇ Tips HOWTO, by Paul Anderson . HOWTO on
miscellaneous tips and tricks for Linux. Updated 26 December 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 18 November 1997.
ˇ UUCP HOWTO, by Guylhem Aznar .
Information on UUCP software for Linux. Updated 6 February 1998.
ˇ User Group HOWTO, by Kendall Grant Clark . Tips
on founding, maintaining, and growing a Linux User Group. Updated
1 January 1998.
ˇ VAR HOWTO, by Martin Michlmayr . Listing of Linux
value added resellers. Updated 17 March 1998.
ˇ VMS to Linux HOWTO, by Guido Gonzato . How
to move from VMS to Linux. Updated 31 October 1997.
ˇ Virtual Services HOWTO, by Brian Ackerman . How
to set up virtual hosting services. Updated 4 November 1997.
ˇ WWW HOWTO, by Wayne Leister . How to set up WWW
clients and servers. Updated 19 November 1997.
ˇ WWW mSQL HOWTO, by Oliver Corff . How to
set up a web server database with mSQL. Updated 17 September 1997.
ˇ XFree86 HOWTO, by Eric S. Raymond . How to
obtain, install, and configure XFree86 3.2 (X11R6). Updated 31
October 1997.
ˇ XFree86 Video Timings HOWTO, by Eric S. Raymond
. How to compose a mode line for XFree86.
Updated 31 October 1997.
3.2. mini-HOWTOs
The following mini-HOWTOs are available:
ˇ 3 Button Mouse mini-HOWTO, by Geoff Short
. How to configure your mouse to use 3
buttons. Updated 4 November 1997.
ˇ 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 13 January 1998.
ˇ 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 5 August 1997.
ˇ Battery Powered mini-HOWTO, by Hanno Mueller . How
to reduce a Linux system's power consumption. Updated 21 December
1997.
ˇ Boca mini-HOWTO, by David H Dennis . How to
install a Boca 16-port serial card (Boca 2016). Updated 1 August
1997.
ˇ BogoMips mini-HOWTO, by Wim C.A. van Dorst
. Information about BogoMips. Updated 13
December 1997.
ˇ Bridge mini-HOWTO, by Chris Cole . How to
setup an ethernet bridge. Updated 13 November 1997.
ˇ Bridge+Firewall mini-HOWTO, by Peter Breuer . How
to setup and ethernet bridge and firewall. Updated 19 December
1997.
ˇ Bzip2 mini-HOWTO, by David Fetter . How to use
the new bzip2 compression program. Updated 10 March 1998.
ˇ Cable Modem mini-HOWTO, by Vladimir Vuksan . How
to use a cable modem with a cable ISP. Updated 26 February 1998.
ˇ Clock mini-HOWTO, by Ron Bean . How to set and
keep your clock on time. Updated December 1996.
ˇ Coffee mini-HOWTO, by Georgatos Photis .
Thoughts about making coffee with Linux (humorous). Updated 15
January 1998.
ˇ Colour ls mini-HOWTO, by Thorbjoern Ravn Andersen .
How to set up the colours with 'ls'. Updated 7 August 1997.
ˇ Cyrus IMAP mini-HOWTO, by Kevin Mitchell . How to
install the Cyrus IMAP server. Updated 21 January 1998.
ˇ DHCPcd mini-HOWTO, by Vladimir Vuksan . How to
setup a DHCP client (dhcpcd). Updated 2 March 1998.
ˇ DPT Hardware RAID mini-HOWTO, by Ram Samudrala . How
to configure hardware RAID. Updated 15 December 1997.
ˇ Diald mini-HOWTO, by Harish Pillay . How to use
'diald' to dial an ISP. Updated 3 June 1996.
ˇ Diskless mini-HOWTO, by Robert Nemkin . How to
set up a diskless Linux box. Updated 31 May 1996.
ˇ Ext2fs Undeletion mini-HOWTO, by Aaron Crane .
How to retrieve deleted files from an ext2 filesystem. Updated 4
August 1997.
ˇ Fax Server mini-HOWTO, by Erez Strauss . How
to setup a fax server. Update 8 November 1997.
ˇ GIS-GRASS mini-HOWTO, by David A. Hastings .
How to install Geographic Information System (GIS) software.
Updated 13 November 1997.
ˇ GTEK BBS-550 mini-HOWTO, by Wajihuddin Ahmed
. How to setup the GTEK BBS-550 multiport
board with Linux. Updated 20 August 1997.
ˇ Hard Disk Upgrade mini-HOWTO, by Yves Bellefeuille
. How to copy a Linux system from one hard disk to
another. Updated 31 January 1998.
ˇ IO Port Programming mini-HOWTO, by Riku Saikkonen
. How to use I/O ports in C programs.
Updated 28 December 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 10 November 1997.
ˇ IP Subnetworking mini-HOWTO, by Robert Hart
. Why and how to subnetwork an IP network.
Updated 31 March 1997.
ˇ IP Connectivity mini-HOWTO, by Michael Strates
. How to get mail and news over a dialup
connection. Updated 6 November 1997.
ˇ Install From ZIP mini-HOWTO, by Kevin Snively
. How to install Linux from a parallel port
ZIP drive. Updated 27 January 1998.
ˇ Kerneld mini-HOWTO, by Henrik Storner .
How to use 'kerneld' (dynamic module loading). Updated 19 July
1997.
ˇ LBX mini-HOWTO, by Paul D. Smith . How to
use Low-Bandwidth X (LBX). Updated 11 December 1997.
ˇ LILO mini-HOWTO, by Alessandro Rubini . Examples
of typical LILO installations. Updated 9 January 1998.
ˇ Large Disk mini-HOWTO, by Andries Brouwer . How to use
disks with > 1024 cylinders. Updated 26 July 1996.
ˇ Leased Line mini-HOWTO, by Rob van der Putten .
How to setup leased line modems. Updated 3 March 1998.
ˇ Linux+DOS+Win95+OS2 mini-HOWTO, by Mike Harlan .
How to use Linux and DOS and OS/2 and Win95 together. Updated 11
November 1997.
ˇ Linux+FreeBSD mini-HOWTO, by Niels Kristian Bech Jensen
How to use Linux and FreeBSD together. Updated 23
January 1998.
ˇ Linux+NT-Loader mini-HOWTO, by Bernd Reichert
. How to use Linux and the Windows NT boot
loader together. Updated 2 September 1997.
ˇ Linux+Win95 mini-HOWTO, by Jonathan Katz . How to
use Linux and Windows95 together. Updated 26 October 1996.
ˇ Loadlin+Win95 mini-HOWTO, by Chris Fischer .
How to use Linux and Windows95 together, using loadlin. Updated 6
March 1998.
ˇ Mac Terminal mini-HOWTO, by Robert Kiesling
. How to use an Apple Macintosh as a serial
terminal. Updated 9 November 1997.
ˇ Mail Queue mini-HOWTO, by Leif Erlingsson
. How to queue remote mail and
deliver local mail. Updated 3 September 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 11 March 1998.
ˇ Modules mini-HOWTO, by Riley H. Williams . How to
setup and configure kernel modules. Updated 14 November 1997.
ˇ NFS-Root mini-HOWTO, by Andreas Kostyrka . How
to set up diskless Linux machines. Updated 8 August 1997.
ˇ NFS-Root-Client mini-HOWTO, by Ofer Maor . How
to set up diskless Linux machines using NFS. Updated 1 July 1997.
ˇ Netscape+Proxy mini-HOWTO, by Sarma Seetamraju .
How to set up a proxy server for Netscape. Updated 15 August 1997.
ˇ News Leafsite mini-HOWTO, by Florian Kuehnert . How
to set up a leaf news site. Updated 4 January 1998.
ˇ Offline Mailing mini-HOWTO, by Gunther Voet .
How to set up email addresses without a dedicated Internet
connection. Updated 7 February 1998.
ˇ Partition mini-HOWTO, by Kristian Koehntopp .
How to choose disk partitions. Updated 3 November 1997.
ˇ Partition Rescue mini-HOWTO, by Rolf Klausen
. How to rescue deleted Linux partitions.
Updated 22 October 1997.
ˇ Path mini-HOWTO, by Esa Turtiainen . How to use the
PATH environment variable. Updated 15 November 1997.
ˇ Pre-installation Checklist mini-HOWTO, by S. Parthasarathy
. Pre-installation checklist and
questionnaire. Updated 27 January 1998.
ˇ Process Accounting mini-HOWTO, by Albert M.C. Tam .
How to set up process accounting. Updated 8 August 1997.
ˇ Proxy ARP Subnet mini-HOWTO, by Bob Edwards
. How to use proxy ARP with subnetting.
Updated August 1997.
ˇ Public Web Browser mini-HOWTO, by Donald B. Marti Jr.
. How to set up a guest account to use a WWW
browser. Updated 5 January 1998.
ˇ Qmail+MH mini-HOWTO, by Christopher Richardson
. How to install qmail and MH. Updated 5
March 1998.
ˇ Quota mini-HOWTO, by Albert M.C. Tam . How to set
up disk quotas. Updated 8 August 1997.
ˇ RCS mini-HOWTO, by Robert Kiesling . How to
use RCS (Revision Control System). Updated 14 August 1997.
ˇ RPM+Slackware mini-HOWTO, by Dave Whitinger, .
How to install the Red Hat Package Manager (RPM) under Slackware.
Updated 25 February 1998.
ˇ Remote Boot mini-HOWTO, by Marc Vuilleumier Stückelberg
. How to set up a
server-based boot selector. Updated August 1997.
ˇ Remote X Apps mini-HOWTO, by Vincent Zweije .
How to run remote X applications. Updated 12 February 1998.
ˇ SLIP-PPP Emulator mini-HOWTO, by Irish . How to
use SLIP-PPP emulators with Linux. Updated 7 August 1997.
ˇ Sendmail+UUCP mini-HOWTO, by Jamal Hadi Salim .
How to use sendmail and UUCP together. Updated 25 October 1997.
ˇ Small Memory mini-HOWTO, by Todd Burgess .
How to run Linux on a system with a small amount of memory. Update
29 October 1997.
ˇ Software Building mini-HOWTO, by Mendel Leo Cooper
. How to build software packages.
Updated 4 November 1997.
ˇ Software RAID mini-HOWTO, by Linas Vepstas . How to
configure software RAID. Updated 28 December 1997.
ˇ Soundblaster AWE mini-HOWTO, by Marcus Brinkmann
. How to install the
Soundblaster AWE 32/64. Updated 11 January 1998.
ˇ StarOffice mini-HOWTO, by Matthew Borowski .
Information on installing the StarOffice suite. Updated 14 January
1998.
ˇ Term Firewall mini-HOWTO, by Barak Pearlmutter .
How to use 'term' over a firewall. Updated 15 July 1997.
ˇ TkRat mini-HOWTO, by Dave Whitinger . How to
install and use the TkRat mail program. Updated 2 February 1998.
ˇ Token Ring mini-HOWTO, by Mike Eckhoff . How to use token ring cards. Updated 7 January 1998.
ˇ Ultra-DMA mini-HOWTO, by Brion Vibber . How to
use Ultra-DMA drives and controllers. Updated 5 March 1998.
ˇ Update mini-HOWTO, by Stein Gjoen .. How to stay
updated about Linux development. Updated 3 February 1998.
ˇ 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 7 August 1997.
ˇ Visual Bell mini-HOWTO, by Alessandro Rubini .
How to disable audible bells, and enable visual bells. Updated 11
November 1997.
ˇ Windows Modem Sharing mini-HOWTO, by Friedemann Baitinger
. How to setup Windows to use a shared modem on
a Linux machine. Updated 2 November 1997.
ˇ WordPerfect mini-HOWTO, by Wade Hampton >.
How to set up WordPerfect for Linux. Updated 13 August 1997.
ˇ X Big Cursor mini-HOWTO, by Joerg Schneider .
How to use enlarged cursors with XWindows. Updated 11 August 1997.
ˇ XFree86-XInside mini-HOWTO, by Marco Melgazzi .
How to convert XFree86 to XInside modelines. Updated September
1997.
ˇ xterm Title mini-HOWTO, by Ric Lister .
How to put strings into the titlebar of an xterm. Updated 7
January 1998.
ˇ ZIP Install mini-HOWTO, by John Wiggins .
How to install Linux onto a ZIP drive. Updated 26 January 1998.
3.3. Special HOWTOs
The High Availability HOWTO, by Harald Milz is
available at http://sunsite.unc.edu/pub/Linux/ALPHA/ALPHA/linux-
ha/High-Availability-HOWTO.html. It is not included with the HOWTO
collection because it relies on figures and cannot be distributed in
all supported formats.
The Graphics mini-HOWTO, by Michael J. Hammel is available at http://www.graphics-muse.org/linux/lgh.html.
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.
3.4. Unmaintained HOWTOs and mini-HOWTOs
There are a number of unmaintained documents at
ftp://sunsite.unc.edu/pub/Linux/docs/HOWTO/unmaintained. These are
kept around since old documentation is sometimes better than none.
However, you should be aware that you are reading old documentation.
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://www.pobox.com/~cg/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. It is very important that you format
and review the output of the formatting in PostScript, plain text
and HTML.
ˇ If you are writing a mini-HOWTO, you can either use SGML (as
described above) or HTML. If you use SGML for your mini-HOWTO, it
will be pubished along with the HOWTOs in LDP books.
ˇ 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. In addition, have a look
at the LDP Style Guide for some guidelines.
ˇ 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. The standard
header is:
Title
Author's name and email address
Version number and date
for example:
The Linux HOWTO Index
by Greg Hankins
v2.10.29, 31 July 1997
ˇ 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
Copyright (c) 1995 - 1998 by Greg Hankins.
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.