From: mdw@sunsite.unc.edu (Matt Welsh)
Newsgroups: comp.os.linux.announce,comp.os.linux.help,comp.os.linux.admin,news.answers,comp.answers
Subject: Linux HOWTO Index
Date: 16 Mar 1994 05:26:55 GMT
Approved: linux-announce@tc.cornell.edu (Matt Welsh)
Message-ID: <2m65av$e12@bigblue.oit.unc.edu>

Archive-name: linux/howto/index
Last-modified: 14 February 1994

The Linux HOWTO Index 
Matt Welsh, <mdw@sunsite.unc.edu>
-----------------------------------------------------------------------------
Last Modified 14 February 1994

This is an introduction and index to the Linux HOWTO documents. 

0. What are Linux HOWTOs?

	Linux HOWTOs are short online documents which describe in detail
	a certain aspect of configuring or using the Linux system. 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-2-HOWTO (previously the NET-2-FAQ) and the Linux-vs-386BSD HOWTO.

	Information in HOWTOs is generally more detailed and in-depth than
	what can be squeezed into the Linux FAQ. For this reason, the
	Linux FAQ is being rewritten. A large amount of the information
	contained therein will be relegated to various HOWTO documents.
	The FAQ will be a shorter list of frequently asked questions about 
	Linux, covering small specific topics. Most of the ``useful'' 
	information in the FAQ will now be covered in the HOWTOs. 

	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. For example, the NET-2-FAQ has been renamed to
	the NET-2-HOWTO, because it wasn't in question-and-answer format. 
	However, you will see the NET-2-HOWTO named as the NET-2-FAQ in many
	places. The two docs are one and the same.


1. Where to get Linux HOWTOs

	HOWTOs can be retrieved via anonymous FTP from the following
	sites:

		sunsite.unc.edu:/pub/Linux/docs/HOWTO

		tsx-11.mit.edu:/pub/linux/docs/HOWTO

	The Index, printed below, lists the currently available HOWTOs.

	HOWTOs are also posted regularly to the newsgroups comp.os.linux
	and comp.os.linux.announce. In addition, a number of the HOWTOs
	will be crossposted to news.answers. Therefore, you can find the
	Linux HOWTOs on the news.answers archive site rtfm.mit.edu.


2. HOWTO Index
	
	The following Linux HOWTOs are currently available. The list
	is small, because this is a relatively new project. 

	* INSTALLATION HOWTO, by Matt Welsh (mdw@sunsite.unc.edu). 
  	  How to obtain and install Linux. This is the first document which 
	  a Linux newcomer should read. It discusses how to obtain Linux, 
	  both from the Internet and via Snail-mail, and how to install it. 
	  Focuses primarily on the SLS distribution of Linux, which is the 
	  current de facto standard.

	* Linux INFO-SHEET, by Michael K. Johnson (johnsonm@sunsite.unc.edu). 
	  A general technical introduction to Linux, listing its features, 
	  supported hardware, and other general information. 

	* Linux META-FAQ, by Michael K. Johnson (johnsonm@sunsite.unc.edu). u
	  A list of sources of information about Linux, such as documentation, 
	  newsgroups, FTP sites, and so on.

	* Linux Distribution HOWTO, by Matt Welsh (mdw@sunsite.unc.edu). 
	  A list of many of the major Linux distributions available via 
	  anonymous FTP and via mail order on diskette, tape, or CD-ROM. 
	  Also includes other Linux-related goodies that you can only get 
	  via mail order.

	* NET-2 HOWTO, by Terry Dawson (terryd@extro.ucc.su.oz.au). 
	  Describes how to install and configure the Linux NET-2 TCP/IP code, 
	  in kernels 0.99.pl10 and above. (This has nothing to do with the 
	  so-called BSD NET-2 distribution.) Discusses various aspects of 
	  TCP/IP networking under Linux, including the use of SLIP. The 
	  complete instruction manual for TCP/IP under Linux.
	
	* Ethernet HOWTO, by Paul Gortmaker (gpg109@rsphysse.anu.edu.au). A 
	  HOWTO about the various Ethernet device drivers which are available 
	  for Linux. Should be read along with the NET-2 HOWTO by anyone 
	  using Ethernet for TCP/IP on Linux.
	
	* Serial HOWTO, by Greg Hankins (gregh@cc.gatech.edu). 
	  Information on serial communications, devices, and software packages 
	  for Linux. 

	* XFree86 HOWTO, by Helmut Geyer 
	                    (geyer@polyhymnia.iwr.uni-heidelberg.de). 
	  This HOWTO describes how to install and configure XFree86-2.0 
	  for Linux. Most of this is Linux-specific, and expects you to 
	  read the documentation included in the XFree86-2.0 package.

	* MGR HOWTO, by Vincent Broman (broman@Np.nosc.mil). 
	  A HOWTO describing the MGR window system for Linux, another 
	  graphical interface somewhat like X. 

	* Mail HOWTO, by Vince Skahan (vince@victrola.wa.com). 
	  All about configuration of electronic mail with Linux, including 
	  UUCP and TCP/IP mailers such as Smail and sendmail.

	* UUCP HOWTO, by Vince Skahan (vince@victrola.wa.com). 
	  How to configure UUCP to transfer files, mail, and news to 
	  other UNIX machines on a UUCP-based connection. Includes
	  discussion of Taylor UUCP for Linux.
	
	* News HOWTO, by Vince Skahan (vince@victrola.wa.com). 
	  Setup and configuration of news software, such as C News, INN, 
	  and newsreaders (such as rn and tin) under Linux.

	* Printing HOWTO, by Grant Taylor (gtaylor@cs.tufts.edu). 
	  How to configure and use printing software under Linux, such as 
	  lp, lpr, etc. including remote printing.

	* SCSI HOWTO, by Drew Eckhardt (drew@kinglear.cs.Colorado.EDU). 
	  All about SCSI tapes, drives, and CD-ROMs under Linux.

	* Hardware Compatibility HOWTO, by Ed Carp (erc@apple.com). 
	  An extensive list of hardware supported by Linux.

	* Ftape HOWTO, by Kai Harrekilde-Petersen (ftape@mic.dth.dk). 
	  A HOWTO describing the setup and use of various QIC ftape drivers 
	  for Linux. 

	* Sound HOWTO, by Jess Tranter (tranter@software.mitel.com). 
	  Information on sound-related hardware and software for Linux, 
	  such as how to configure your system for use with a sound card.


	WANTED. I would be very happy if someone would write the following 
	HOWTO documents, and submit them to me (see the instructions in
	the next section below). Most of these are modifications of existing
	FAQ documents, and should be easy to put into HOWTO format. Keep in
	mind that HOWTOs generally aren't in FAQ format, but can contain an
	FAQ section at the end.

	Some of these are under construction; however, if you're interested
	in working on one of them, please let me know.

	* GCC/LIBRARY HOWTO. Discussing installation/upgrading of the GCC 
	  and shared libraries under Linux. How to build shared libraries.
	  Most of the material would come from Mitchum DeSouza's GCC FAQ. 

	* KERNEL HOWTO. How to upgrade and compile the kernel. Basic kernel
	  tweaking, including how to turn on debugging output. How to decrypt
	  panic messages. Basic introduction to kernel structure and hacking.
	  (Under constructions, mdw@sunsite.unc.edu).
	
	* If you have an idea for another HOWTO, please mail me!


3. Writing and submitting a HOWTO

	If you would like to write a Linux HOWTO document, there are a few
	guidelines that you should follow. 

	* Format the document neatly. HOWTOs must be available in plain 
	  ASCII format, but you are free to use a formatting tool (texinfo,
	  LameTeX, nroff) to format the document. 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.

	* 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). 

	* 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 as a model. It is nice to have a common look and
	  feel to HOWTO documents--- this document being an example. The
	  easier the HOWTO is to browse, the more useful it will be to
	  readers.


	After you have written the HOWTO, mail it to me (Matt Welsh) at
	mdw@sunsite.unc.edu. I am the HOWTO coordinator---I will look 
	over the HOWTO, and make any editorial remarks. I will also take
	care of approving and posting the HOWTO to the various newsgroups
	and uploading the HOWTO to the FTP archive sites. Of course,
	all credit for the HOWTO will go to the author.

	It is important that you go through me when submitting a HOWTO. I
	maintain the HOWTO archives and need to keep track of what HOWTOs
	are being written and who is doing what. If you don't submit a
	HOWTO to me, I can't include it in the archive or add it to the
	HOWTO INDEX. 

	I can also help to reformat the HOWTO if needed to make it look
	nicer. :) Once I have approved the HOWTO, I will post it and
	upload it to the FTP sites. I will also send you (the author) 
	the "final" version of the HOWTO with any changes. All you have
	to do is send me periodic updates (every month or so, as needed)
	and I will take care of posting the HOWTO regularly. 


3. Miscellaneous and Legalese

	If you have questions, please feel free to mail mdw@sunsite.unc.edu.
	The Linux FAQ rewrite is being coordinated by Ian Jackson, 
	ijackson@nyx.cs.du.edu, with help from others.

	Linux HOWTOs are copyrighted by their authors. You are free to
	distribute verbatim copies of HOWTOs in any medium, provided that
	the copyright notice and authorship remains intact.
