home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / misc / linuxhow.zip / HOWTO.IDX < prev    next >
Internet Message Format  |  1993-09-14  |  10KB
  1. Path: nlbbs!jaxsat!pagesat!decwrl!concert!samba.oit.unc.edu!sunSITE!mdw
  2. From: mdw@sunsite.unc.edu (Matt Welsh)
  3. Newsgroups: comp.os.linux.announce,comp.os.linux.
  4. elp,comp.os.linux.admin,news.answers,comp.answers
  5. Subject: Linux HOWTO Index
  6. Summary: Index of HOWTO documents about Linux.
  7. Keywords: Linux, HOWTO, FAQ, documentation, index
  8. Message-ID: <270f03$slk@samba.oit.unc.edu>
  9. Date: 13 Sep 1993 00:30:59 GMT
  10. Organization: Linux. It's not just for breakfast anymore.
  11. Lines: 192
  12. Approved: linux-announce@tc.cornell.edu (Matt Welsh)
  13. NNTP-Posting-Host: calypso.oit.unc.edu
  14. Originator: mdw@sunSITE
  15.  
  16. Archive-name: linux/howto/index
  17. Last-modified: 6 September 1993
  18.  
  19. The Linux HOWTO Index 
  20. Matt Welsh, <mdw@sunsite.unc.edu>
  21. -----------------------------------------------------------------------------
  22. Last Modified 6 September 1993
  23.  
  24. This is an introduction and index to the Linux HOWTO documents. 
  25.  
  26. 0. What are Linux HOWTOs?
  27.  
  28.         Linux HOWTOs are short online documents which describe in detail
  29.         a certain aspect of configuring or using the Linux system. For 
  30.         example, there is the Installation HOWTO, which gives instructions
  31.         on installing Linux, and the Mail HOWTO, which describes how to
  32.         set up and configure mail under Linux. Other examples include the
  33.         NET-2-HOWTO (previously the NET-2-FAQ) and the Linux-vs-386BSD HOWTO.
  34.  
  35.         Information in HOWTOs is generally more detailed and in-depth than
  36.         what can be squeezed into the Linux FAQ. For this reason, the
  37.         Linux FAQ is being rewritten. A large amount of the information
  38.         contained therein will be relegated to various HOWTO documents.
  39.         The FAQ will be a shorter list of frequently asked questions about 
  40.         Linux, covering small specific topics. Most of the ``useful'' 
  41.         information in the FAQ will now be covered in the HOWTOs. 
  42.  
  43.         HOWTOs are comprehensive docs---much like an FAQ but generally not
  44.         in question-and-answer format. However, many HOWTOs contain an FAQ
  45.         section at the end. For example, the NET-2-FAQ has been renamed to
  46.         the NET-2-HOWTO, because it wasn't in question-and-answer format. 
  47.         However, you will see the NET-2-HOWTO named as the NET-2-FAQ in many
  48.         places. The two docs are one and the same.
  49.  
  50.  
  51. 1. Where to get Linux HOWTOs
  52.  
  53.         HOWTOs can be retrieved via anonymous FTP from the following
  54.         sites:
  55.  
  56.                 sunsite.unc.edu:/pub/Linux/docs/HOWTO
  57.  
  58.                 tsx-11.mit.edu:/pub/linux/docs/HOWTO
  59.  
  60.         The Index, printed below, lists the currently available HOWTOs.
  61.  
  62.         HOWTOs are also posted regularly to the newsgroups comp.os.linux
  63.         and comp.os.linux.announce. In addition, a number of the HOWTOs
  64.         will be crossposted to news.answers. Therefore, you can find the
  65.         Linux HOWTOs on the news.answers archive site rtfm.mit.edu.
  66.  
  67.  
  68. 2. HOWTO Index
  69.         
  70.         The following Linux HOWTOs are currently available. The list
  71.         is small, because this is a relatively new project. 
  72.  
  73.         * INSTALLATION HOWTO. How to obtain and install Linux. This is the
  74.           first document which a Linux newcomer should read. It discusses
  75.           how to obtain Linux, both from the Internet and via Snail-mail,
  76.           and how to install it. Focuses primarily on the SLS distribution
  77.           of Linux, which is the current de facto standard.
  78.  
  79.         * Linux INFO-SHEET. A general technical introduction to Linux,
  80.           listing its features, supported hardware, and other general
  81.           information. 
  82.  
  83.         * Linux META-FAQ. A list of sources of information about Linux,
  84.           such as documentation, newsgroups, FTP sites, and so on.
  85.  
  86.         * NET-2 HOWTO. Describes how to install and configure the Linux NET-2 
  87.           TCP/IP code, in kernels 0.99.pl10 and above. (This has nothing 
  88.           to do with the so-called BSD NET-2 distribution.) Discusses various
  89.           aspects of TCP/IP networking under Linux, including the use of SLIP.
  90.           The complete instruction manual for TCP/IP under Linux.
  91.         
  92.         * Ethernet HOWTO. A HOWTO about the various Ethernet device drivers
  93.           which are available for Linux. Should be read along with the NET-2
  94.           HOWTO by anyone using Ethernet for TCP/IP on Linux.
  95.  
  96.         * Mail HOWTO. All about configuration of electronic mail with Linux,
  97.           including UUCP and TCP/IP mailers such as Smail and sendmail.
  98.  
  99.         * UUCP HOWTO. How to configure UUCP to transfer files, mail, and
  100.           news to other UNIX machines on a UUCP-based connection. Includes
  101.           discussion of Taylor UUCP for Linux.
  102.         
  103.         * News HOWTO. Setup and configuration of news software, such as 
  104.           C News, INN, and newsreaders (such as rn and tin) under Linux.
  105.  
  106.  
  107.         WANTED. I would be very happy if someone would write the following 
  108.         HOWTO documents, and submit them to me (see the instructions in
  109.         the next section below). Most of these are modifications of existing
  110.         FAQ documents, and should be easy to put into HOWTO format. Keep in
  111.         mind that HOWTOs generally aren't in FAQ format, but can contain an
  112.         FAQ section at the end.
  113.  
  114.         Some of these are under construction; however, if you're interested
  115.         in working on one of them, please let me know.
  116.  
  117.         * GCC/LIBRARY HOWTO. Discussing installation/upgrading of the GCC 
  118.           and shared libraries under Linux. How to build shared libraries.
  119.           Most of the material would come from Mitchum DeSouza's GCC FAQ. 
  120.  
  121.         * KERNEL HOWTO. How to upgrade and compile the kernel. Basic kernel
  122.           tweaking, including how to turn on debugging output. How to decrypt
  123.           panic messages. Basic introduction to kernel structure and hacking.
  124.           (Under constructions, mdw@sunsite.unc.edu).
  125.         
  126.         * PRINTING HOWTO. How to install and use printing software such as
  127.           lp/lpr on your system. How to configure /etc/printcap for
  128.           various types of printers. Information can come from existing
  129.           Printer and LPR FAQs. (Under construction.)
  130.  
  131.         * SCSI HOWTO. All of the ins and outs about SCSI drivers for Linux. 
  132.  
  133.         * SERIAL HOWTO. All of the ins and outs about serial communications
  134.           under Linux, including use of getty for dialins. Perhaps a section
  135.           on FAX software.
  136.  
  137.         * X WINDOWS HOWTO. How to install and configure XFree86 under Linux.
  138.           Much of this is general, not Linux-specific, but the current
  139.           XFree86 documentation consists mostly READMEs which most new users 
  140.           don't understand. What hardware is supported, tweaking the Xconfig
  141.           file, getting xdm to work, and so on. (Under construction, 
  142.           mdw@sunsite.unc.edu).
  143.  
  144.  
  145. 3. Writing and submitting a HOWTO
  146.  
  147.         If you would like to write a Linux HOWTO document, there are a few
  148.         guidelines that you should follow. 
  149.  
  150.         * Format the document neatly. HOWTOs must be available in plain 
  151.           ASCII format, but you are free to use a formatting tool (texinfo,
  152.           LameTeX, nroff) to format the document. Try to use meaningful
  153.           structure and organization, and write clearly. Remember that
  154.           many of the people reading HOWTOs do not speak English as their
  155.           first language.
  156.  
  157.         * Make sure that all of the information is correct. I can't stress
  158.           this enough. When in doubt, speculate, but make it clear that
  159.           you're only guessing. 
  160.  
  161.         * Make sure that you are covering the most recent version of the
  162.           available software. Also, be sure to include full instructions
  163.           on where software can be downloaded from (FTP site name, full
  164.           pathname). 
  165.  
  166.         * Include an FAQ section at the end, if appropriate. Many HOWTO
  167.           documents need an "FAQ" or "Common Problems" section to cover
  168.           information which can't be covered in the regular text.
  169.  
  170.         * Use other HOWTOs as a model. It is nice to have a common look and
  171.           feel to HOWTO documents--- this document being an example. The
  172.           easier the HOWTO is to browse, the more useful it will be to
  173.           readers.
  174.  
  175.  
  176.         After you have written the HOWTO, mail it to me (Matt Welsh) at
  177.         mdw@sunsite.unc.edu. I am the HOWTO coordinator---I will look 
  178.         over the HOWTO, and make any editorial remarks. I will also take
  179.         care of approving and posting the HOWTO to the various newsgroups
  180.         and uploading the HOWTO to the FTP archive sites. Of course,
  181.         all credit for the HOWTO will go to the author.
  182.  
  183.         It is important that you go through me when submitting a HOWTO. I
  184.         maintain the HOWTO archives and need to keep track of what HOWTOs
  185.         are being written and who is doing what. If you don't submit a
  186.         HOWTO to me, I can't include it in the archive or add it to the
  187.         HOWTO INDEX. 
  188.  
  189.         I can also help to reformat the HOWTO if needed to make it look
  190.         nicer. :) Once I have approved the HOWTO, I will post it and
  191.         upload it to the FTP sites. I will also send you (the author) 
  192.         the "final" version of the HOWTO with any changes. All you have
  193.         to do is send me periodic updates (every month or so, as needed)
  194.         and I will take care of posting the HOWTO regularly. 
  195.  
  196.  
  197. 3. Miscellaneous and Legalese
  198.  
  199.         If you have questions, please feel free to mail mdw@sunsite.unc.edu.
  200.         The Linux FAQ rewrite is being coordinated by Ian Jackson, 
  201.         ijackson@nyx.cs.du.edu, with help from others.
  202.  
  203.         Linux HOWTOs are copyrighted by their authors. You are free to
  204.         distribute verbatim copies of HOWTOs in any medium, provided that
  205.         the copyright notice and authorship remains intact.
  206. -- 
  207. Send submissions for comp.os.linux.announce to: linux-announce@tc.cornell.edu
  208.