Serving the Web/ServingTheWeb1995.disc1of1.iso/linux/howto/howto-in

Text File | 1995-03-23 | 10.8 KB | 274 lines

  Linux    HOWTO Index
  by Greg Hankins, [e-mail]
  v2.1,    22 February 1995

  This is an index to the Linux    HOWTO documents.

  1.  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 Printing 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.

  There    are several HOWTO formats: plain text, PostScript, dvi,    and html
  formats are all available.  You can also browse HOWTOs online    on the
  Web (http://sunsite.unc.edu/mdw/HOWTO/).

  In addition to the HOWTOs, there are a multitude of short "mini-
  HOWTOs".  These are very short, specific HOWTOs, such    as the Colour-ls
  HOWTO.  They are only    available in plain text    format.



  2.  Where to get Linux HOWTOs

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

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

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

     as    well as    the many mirror    sites, which are listed    in the Linux
     META-FAQ (see below).

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

  HOWTOs are also posted regularly to the newsgroup
  comp.os.linux.answers, and other appropriate newsgroups.


  3.  HOWTO Index

  The following    Linux HOWTOs are currently available:



  o  Linux Bootdisk HOWTO, by Graham Chapman <[e-mail]>.  How
     to    create a boot/root maintenance disk for    Linux

  o  Linux Busmouse HOWTO, by Mike Battersby
     <[e-mail]>.  Information on bus mouse
     compatibility with    Linux

  o  Linux CDROM HOWTO,    by Jeff    Tranter    <[e-mail]>.
     Information on CD-ROM drive compatibility for Linux

  o  Linux Commercial HOWTO, by    Harald Milz <[e-mail]>.     Listing of
     commercial    software prducts for Linux

  o  Linux DOSEMU HOWTO, by Michael E. Deisher
     <[e-mail]>.  HOWTO about the Linux MS-DOS
     Emulator, DOSEMU

  o  Linux Danish HOWTO, by Thomas Petersen <[e-mail]>    .  How
     to    configure Linux    for use    with the Danish    characterset

  o  Linux Distribution    HOWTO, by Matt Welsh <[e-mail]>.  A
     list of mail order    distributions and other    commercial services

  o  Linux Ethernet HOWTO, by Paul Gortmaker
     <[e-mail]>.  Information    on Ethernet hardware
     compatibility for Linux

  o  Linux Ftape HOWTO,    by Ftape-HOWTO maintainer <[e-mail]>.
     Information on ftape drive    compatibility with Linux

  o  Linux German HOWTO, by Winfried Truemper <[e-mail]-
     Koeln.DE>.     Information on    using Linux with German-specific
     features

  o  Linux HAM HOWTO, by Terry Dawson <[e-mail]>.
     HOWTO configure amateur radio software for    Linux

  o  Linux HOWTO Index,    by Greg    Hankins    <[e-mail]>.  Index
     of    HOWTO documents    about Linux.

  o  Linux Hardware Compatibility HOWTO, by Tawei Wan
     <[e-mail]>.  A list of hardware known to work with Linux

  o  Linux INFO-SHEET, by Michael K. Johnson <[e-mail]>.
     Generic introduction to the Linux operating system

  o  Linux Installation    HOWTO, by Matt Welsh <[e-mail]>.  How
     to    obtain and install the Linux software

  o  Linux JE-HOWTO, by    Yasuhiro Yamazaki
     <[e-mail]>.  Information on JE, a set of
     Japanese language extensions for Linux

  o  Linux Kernel HOWTO, by Brian Ward <[e-mail]>.
     Upgrading and compiling the Linux kernel

  o  Linux Keystroke HOWTO, by Zenon Fortuna <[e-mail]>.  HOWTO
     bind macro    actions    to keystrokes under Linux

  o  Linux META-FAQ, by    Michael    K. Johnson <[e-mail]>.
     A listing of Linux    sources    of information

  o  Linux MGR HOWTO, by Vincent Broman    <[e-mail]>.
     Information on the    MGR graphics interface for Linux

  o  Linux Electronic Mail HOWTO, by Vince Skahan <[e-mail]>.
     Information on Linux-based    mail servers and clients


  o  Linux NET-2 HOWTO,    by Terry Dawson    <[e-mail]>.
     HOWTO configure TCP/IP networking,    SLIP, PLIP, and    PPP under Linux.

  o  Linux NIS HOWTO, by Erwin Embsen <[e-mail]>.    Information on
     using NIS/YP on Linux systems

  o  Linux News    HOWTO, by Vince    Skahan <[e-mail]>.  Information
     on    USENET news server and client software for Linux

  o  Linux PCI-HOWTO, by Michael Will <[e-mail]-
     tuebingen.de>.  Information on PCI-architecture compatibility with
     Linux

  o  Linux Distribution    HOWTO, by Dave Hinds
     <[e-mail]> .  How to install and use PCMCIA Card
     Services

  o  Linux PPP-HOWTO, by Al Longyear <[e-mail]>.  Information
     on    using PPP networking with Linux

  o  Linux Printing HOWTO, by Grant Taylor <[e-mail]>.
     HOWTO on printing software    for Linux

  o  Linux SCSI    HOWTO, by Drew Eckhardt    <[e-mail]>.
     Information on SCSI driver    compatibility with Linux

  o  Linux SCSI    Programming HOWTO, by Heiko Eissfeldt
     <[e-mail]>.  Information on programming the generic
     Linux SCSI    interface

  o  Linux Serial HOWTO, by Greg Hankins <[e-mail]>.
     Information on use    of serial devices and communications software

  o  Linux Sound HOWTO,    by Jeff    Tranter    <[e-mail]>.
     Sound hardware and    software for the Linux operating system

  o  Linux Term    HOWTO, by Patrick Reijnen <[e-mail]>.     HOWTO
     use the `term' communications package on Linux systems

  o  Linux Tips    HOWTO, by Vince    Reed <[e-mail]>.  HOWTO on
     miscellaneous tips    and tricks for Linux

  o  Linux UPS HOWTO, by Harvey    J. Stein <[e-mail]>.
     Information on using a UPS    power supply with Linux

  o  Linux UUCP    HOWTO, by Vince    Skahan <[e-mail]>.  Information
     on    UUCP software for Linux

  o  Linux XFree86 HOWTO, by Helmut Geyer <[e-mail]-
     heidelberg.de>.  HOWTO on installation of XFree86 (X11R5) for Linux


  4.  Wanted HOWTOs

  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.



  o  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.

  o  If    you have an idea for another HOWTO, please mail    me!


  5.  Writing and submitting a HOWTO

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


  o  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.

  o  You may wish to use the Linuxdoc-SGML package, available from
     ftp.cs.cornell.edu:/pub/mdw/, to format the HOWTO.    This package
     allows you    to produce LaTeX, plain    ASCII, and HTML    from a single
     source document, and was designed specifically with the HOWTOs in
     mind.  If you are writing a new HOWTO you should seriously    consider
     this.

  o  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.

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

  o  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.

  o  Use other HOWTOs as a model.

  After    you have written the HOWTO, mail it to me (Greg    Hankins) at
  [e-mail]. If you    have use Linuxdoc-SGML,    simply mail me
  the SGML source; I take care of formatting the documents.  I'll also
  take care of archiving the HOWTO and posting it 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.

  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.


  6.  Miscellaneous and    Legalese

  If you have questions, please    feel free to mail [e-mail].
  The Linux FAQ    rewrite    is being coordinated by    Ian Jackson,
  [e-mail], with help from others.

  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,
  without permission of    the author. Translations and derivative    works
  are similarly    permitted without express permission. Commercial
  redistribution is allowed and    encouraged; however, the author    would
  like to be notified of any such distributions.

  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 [e-mail].