From 87b64aa4995cb2fbc4a7eb98423b2433c1ac9aeb Mon Sep 17 00:00:00 2001 From: John Fieber Date: Tue, 20 Jun 1995 16:29:55 +0000 Subject: [PATCH] Fixed a blatant lie regarding newsgroups. Added pointers to indexed arcihves of the mailing lists and usenet groups. Renamed the last part "Appendicies" Moved "PC hardware reference" to the Appendicies section and added an introduction. Fixed a dangling cross reference. (submitters.sgml) --- share/doc/handbook/eresources.sgml | 110 ++++++++++++++++++----------- share/doc/handbook/handbook.sgml | 11 ++- share/doc/handbook/hw.sgml | 29 +++++++- share/doc/handbook/submitters.sgml | 7 +- 4 files changed, 102 insertions(+), 55 deletions(-) diff --git a/share/doc/handbook/eresources.sgml b/share/doc/handbook/eresources.sgml index 2105f3683998..8608223a68c7 100644 --- a/share/doc/handbook/eresources.sgml +++ b/share/doc/handbook/eresources.sgml @@ -1,14 +1,28 @@ - + - - Additional resources on the Internet + + Resources on the Internet + +

The rapid pace of FreeBSD progress makes print media + impractical as a means for following the latest + developments. Electronic resources are the best, if not the + only way stay informed of the latest advances. Also, since + FreeBSD is a volunteer effort, the user community also serves + as the technical support department and invariably, + electronic mail and Usenet news are the most effective way of + getting technical problems resolved. + + Below, the most important points of contact with the FreeBSD + user community are outlined. If you are aware of other + resources not included, please send them to + doc@freebsd.org so they may be included. - Mailing lists + Mailing lists

Contributed by &a.dufalt;. - 5 May 1995. + 20 Jun 1995. Though many of the FreeBSD development members read USENET, we cannot always guarantee that we'll get to your questions in a timely fashion @@ -22,6 +36,12 @@ the list charter before joining a list. We must strive to keep the signal to noise ratio of the lists high, especially in the technical lists. +Archives are kept for all of the mailing lists and can be searched +using the the . The keyword searchable archive +offers an excellent way to find answers to frequently asked questions +and should be consulted before posting a question. + List summary

General lists: The following are general lists that @@ -92,9 +112,10 @@ cvs-usrsbin /usr/src/usr.sbin System binaries How to subscribe -

All mailing lists live on `FreeBSD.ORG', so to post to a list you -simply mail to `<listname>@FreeBSD.ORG'. It will then be redistributed -to mailing list members throughout the world. +

All mailing lists live on FreeBSD.ORG, so to post to a +list you simply mail to listname@FreeBSD.ORG. It +will then be redistributed to mailing list members throughout the +world. To subscribe to a list, send mail to: @@ -235,63 +256,66 @@ fixes, etc). - Usenet newsgroups + Usenet newsgroups -

While no newsgroups dedicated to FreeBSD exist, there - are many in which FreeBSD is discussed or are otherwise - relevant to FreeBSD users. +

In addition to two FreeBSD specific newsgroups on Usenet, there + are many other in which FreeBSD is discussed or are otherwise + relevant to FreeBSD users. Keyword searchable archives are + available for some of these newsgroups from + + courtesy of Warren Toomey <wkt@cs.adfa.oz.au>. BSD specific newsgroups

- comp.unix.bsd.freebsd.announce - comp.unix.bsd.freebsd.misc + comp.unix.bsd.freebsd.announce + comp.unix.bsd.freebsd.misc Other Unix newsgroups of interest

- comp.unix - comp.unix.questions - comp.unix.admin - comp.unix.programmer - comp.unix.shell - comp.unix.user-friendly - comp.security.unix - comp.sources.unix - comp.unix.advocacy - comp.unix.misc - comp.os.386bsd.announce - comp.os.386bsd.apps - comp.os.386bsd.bugs - comp.os.386bsd.development - comp.os.386bsd.misc - comp.os.386bsd.questions - comp.bugs.4bsd - comp.bugs.4bsd.ucb-fixes - comp.unix.bsd + comp.unix + comp.unix.questions + comp.unix.admin + comp.unix.programmer + comp.unix.shell + comp.unix.user-friendly + comp.security.unix + comp.sources.unix + comp.unix.advocacy + comp.unix.misc + comp.os.386bsd.announce + comp.os.386bsd.apps + comp.os.386bsd.bugs + comp.os.386bsd.development + comp.os.386bsd.misc + comp.os.386bsd.questions + comp.bugs.4bsd + comp.bugs.4bsd.ucb-fixes + comp.unix.bsd X-Window system

- comp.windows.x.i386unix - comp.windows.x - comp.windows.x.apps - comp.windows.x.announce - comp.windows.x.intrinsics - comp.windows.x.motif - comp.windows.x.pex - comp.emulators.ms-windows.wine + comp.windows.x.i386unix + comp.windows.x + comp.windows.x.apps + comp.windows.x.announce + comp.windows.x.intrinsics + comp.windows.x.motif + comp.windows.x.pex + comp.emulators.ms-windows.wine - Word Wide Web servers + Word Wide Web servers

- + diff --git a/share/doc/handbook/handbook.sgml b/share/doc/handbook/handbook.sgml index 85d88457bd4c..12074d3b12e0 100644 --- a/share/doc/handbook/handbook.sgml +++ b/share/doc/handbook/handbook.sgml @@ -1,4 +1,4 @@ - + The FreeBSD Documentation Project - June 14, 1995 + June 20, 1995 Welcome to FreeBSD! This handbook covers the installation and day to day use of FreeBSD Release @@ -98,7 +98,7 @@ OUTLINE: System Administration - Reconfiguring the Kernel + * Reconfiguring the Kernel Users, groups and security @@ -118,8 +118,6 @@ OUTLINE: * Serial ports * Sound cards - &hw; - Network Communications @@ -160,9 +158,10 @@ OUTLINE: - Additional resources + Appendicies &bibliography; &eresources; + &hw; &glossary; diff --git a/share/doc/handbook/hw.sgml b/share/doc/handbook/hw.sgml index c589a4bbb151..b0db439dd756 100644 --- a/share/doc/handbook/hw.sgml +++ b/share/doc/handbook/hw.sgml @@ -1,7 +1,32 @@ - + -* PC Hardware compatibility +PC Hardware compatibility + +

Issues of hardware compatibility are among the most + troublesome in the computer industry today and FreeBSD is by + no means immune to trouble. In this respect, FreeBSD's + advantage of being able to run on inexpensive commidity PC + hardware is also its liability when it comes to support for + the amazing variety of components on the market. While it + would be impossible to provide a exhaustive listing of + hardware that FreeBSD supports, this section serves as a + catalog of the device drivers included with FreeBSD and the + hardware each drivers supports. Where possible and + appropriate, notes about specific products are included. + + As FreeBSD is a volunteer project without a funded testing + department, we depend on you, the user, for much of the + information contained in this catalog. If you have direct + experience of hardware that does or does not work with + FreeBSD, please let us know by sending email to + doc@freebsd.org. Questions about supported hardware + should be directed to questions@freebsd.org (see + for more + information). When submitting information or asking a + question, please remember to specify exactly what version of + FreeBSD you are using and include as many details of your + hardware as possible. * Core/Processing diff --git a/share/doc/handbook/submitters.sgml b/share/doc/handbook/submitters.sgml index 81188ae8148c..4a45829c8bc6 100644 --- a/share/doc/handbook/submitters.sgml +++ b/share/doc/handbook/submitters.sgml @@ -1,4 +1,4 @@ - + Contributing to FreeBSD @@ -41,8 +41,7 @@ are each, in their own way, quite significant to the project. volume of mail!) may subscribe to the hackers mailing list by sendimg mail to <majordomo@freebsd.org>. - See + See for more information about this and other mailing lists. An actual bug report should be filed by using the @@ -204,7 +203,7 @@ THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. - $Id$ + $Id: submitters.sgml,v 1.2 1995/05/18 03:05:22 jfieber Exp $ For your convenience, a copy of this text can be found in /usr/share/examples/etc/bsd-style-copyright.