This post is sent weekly to the comp.os.linux newsgroup after numerous
people suggested I make it a regular thing. Any comments? Contact me...
------- *** Linux Documents Explained for Newbies (like me 8-) *** --------
Have any of you (relatively) new Linux users felt rather intimidated
by all the *** READ THE FAQ BEFORE YOU BOTHER US GURUS *** type posts,
then gone out and retrieved the numerous FAQ's (after wasting a lot of
time filtering through all the docs etc), read them, then still been
flamed for not finding something in the FAQ? Well, I kinda felt that
way, so I am compiling a very brief (and hopefully understandable) list
of what the various docs are that you may need and why.
Oh, by the way, when I first put this together I went out and checked
all these documents for location, etc. That was several months ago. I
don't have the time to continually check the accuracy of this post, so
if it has any inaccuracies, please be sure to let me know and I'll fix
it ASAP.
Here it is:
-----------------------------------------------------------------------
I. Where to find them:
- most of the docs are posted to comp.os.linux (c.o.l) and
comp.os.linux.announce (c.o.l.a) every couple of weeks. If
you are patient you'll see them.
- By ftp try:
tsx-11.mit.edu (18.172.1.2) in /pub/linux
sunsite.unc.edu (152.2.22.81) in /pub/Linux
nic.funet.fi (128.214.6.100) in /pub/OS/Linux
Note: As of late May the most up-to-date documents were all on
sunsite.
- By WAIS server at sunsite:
There is now a WAIS server running at sunsite.unc.edu that indexes
several of the FAQS and the LSM. This is particularly nice
as it will search through these documents for various
keywords.
To access: telnet to sunsite.unc.edu and login as linux. The rest
is up to you to hack out 8-).
- By mail server try:
mailserver@nic.funet.fi
mail-server@rtfm.mit.edu
ftpmail@decwrl.dec.com
- If none of those work then try asking Ian Jackson (who's post
*** READ THIS BEFORE POSTING *** should also be read) by
email (ijackson@nyx.cs.du.edu)
++++
II. What document files are available and should you get:
- INFO-SHEET - This file explains what Linux is, its features,
hardware supported, some software ported, and
(very important) where to get Linux via ftp or
snail mail. (in docs/)
- META-FAQ - Lots of useful information on where to find more
information about Linux (get this one for sure).
(in docs/)
- faq.p1.mmmyy - The FAQ itself comes in 4 parts. This is the
- faq.p2.mmmyy mother of all Linux documentation. These four
- faq.p3.mmmyy files are a *must* if you plan to use Linux.
- faq.p4.mmmyy (The FAQ is updated regularly, hence the date
extension. e.g. mmmyy = feb93) (in docs/FAQ)
- faq.toc.mmmyy - Table of Contents for the FAQ. A must-get in
order to avoid massive amounts of time waste
picking through the four FAQ volumes.
(in docs/FAQ)
- gcc-faq.mmmyy - The complete GCC FAQ.
- LSM - The Linux Software Map: This is a (relatively) complete
index of the software available for Linux, complete with
ftp addresses, path/filenames, descriptions, etc. Read
through this (or search it via the WAIS) before asking any
'Has this been ported...' type questions. Look for the file
'lsm-m.n.tar.z' where m.n is the version number. (in docs/)
- NET-FAQ - Documentation on networking Linux. This is in
addition to Chapter XI of the FAQ. (in docs/)
- LILO-QUICKSTART-1.1 - How to install LILO (the disk booting
program). (in docs/)
- ext2fs.faq - FAQ regarding the ext2fs utility (i.e. the second
version of the extended filesystem program).
(in ALPHA/ext2fs)
- drivers.doc.z - a gzipped file containing all the information you
you should need to know for writing a driver for
Linux. Read this before you even think about writing
your own driver. (in ALPHA/drv_guide)
- bbs.list - List of various BBS and ftp sites where you can find
Linux files.
++++
III. Information for SLS!!! (every newbie needs this 8-)
- DOWNLOADING - Information on how to get the SLS disks.
(in packages/SLS)
- NOTICE - Information on warranty, restrictions, etc for SLS.
Check this one out. (in packages/SLS)
- COPYING - The GNU General Public License document. (in packages/SLS)
- RELEASE - Information on what is in the latest release of SLS.
(in packages/SLS)
- ChangeLog - History of changes to Linux and SLS. (in packages/SLS)
- README - Most important document on SLS installation etc. You
*will* need this for installing SLS. (in packages/SLS)
- SLS.FAQ - The real thing. Two pages of questions you will come
come across (complete with answers, too 8-).
(in packages/SLS)
++++
IV. Comp.os.linux.announce (c.o.l.a) information:
- The newsgroup comp.os.linux.announce is a moderated newsgroup where
the *latest, greatest* stuff regarding Linux is posted.
- C.o.l.a [I love that acronym for this group 8-)] is archived in
several places:
- sunsite.unc.edu:/pub/Linux/docs/linux-announce.archive
- nic.funet.fi: /pub/OS/Linux/doc/news/COLA
- C.o.l.a announcements can also be obtained by email. The contact
address for this is linux-announce@tc.cornell.edu. Personally I
haven't tried it yet, but I'm told it works 8-).
++++
V. LDP (Linux Documentation Project) information:
- A dedicated group of Linux users has started working on the LDP.
When it is finished (and I don't know when that will be) the
LDP should contain enough information in one package to answer
most questions.
---------------------------------------------------------------------
From what I've seen so far there is a lot of information contained
in these documents. Also examine every README type file you find (e.g
README.tapes explained all I needed to know to get my SCSI tape stuff
going). A nice trick for finding these files is to get the find-ls
file from the archives then grep it for README, FAQ, DOC, etc.
i.e. grep README find-ls | more
For information on non Linux specific stuff check the corresponding
newsgroup for FAQ information (e.g. comp.unix.questions, comp.lang.c,
etc). Also, all the Internet FAQs are archived on rtfm.mit.edu. Check
it out if you have questions about other subjects.
BTW, for those of you with ftp access, here's a neat little trick you
may not know about. To view a file on the archive without first
transfering it to your machine type:
ftp>get filename |more
NOTE: NO SPACE BETWEEN THE | AND more!!! This is really handy for looking
at README files etc, and general file browsing.
HINT: The unix grep command is *REALLY* useful when looking for specific
information in the documents! 8-)
Cheers!
Jay MacDonald <- Linux convert
Geosense Consulting
Reno, NV
P.S. If I've missed any obvious docs or docs that anybody thinks should
be included, please let me know.
[newbies.autopost rev. F - last changed June 1st, '93]
--
==============================================================================
jay-m@equinox.unr.edu | The purpose of the bass player is to help his
macdonal@flame.ctc.fmc.com | audience surf the wave of low frequency sound
==============================================================================