article.xml revision 127867
10Sstevel@tonic-gate<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [ 20Sstevel@tonic-gate<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN"> 30Sstevel@tonic-gate%man; 40Sstevel@tonic-gate<!ENTITY % authors PUBLIC "-//FreeBSD//ENTITIES DocBook Author Entities//EN"> 51662Sqz150045%authors; 61662Sqz150045<!ENTITY % mlists PUBLIC "-//FreeBSD//ENTITIES DocBook Mailing List Entities//EN"> 70Sstevel@tonic-gate%mlists; 80Sstevel@tonic-gate<!ENTITY % trademarks PUBLIC "-//FreeBSD//ENTITIES DocBook Trademark Entities//EN"> 90Sstevel@tonic-gate%trademarks; 100Sstevel@tonic-gate<!ENTITY % release PUBLIC "-//FreeBSD//ENTITIES Release Specification//EN"> 110Sstevel@tonic-gate%release; 120Sstevel@tonic-gate<!ENTITY % misc PUBLIC "-//FreeBSD//ENTITIES DocBook Miscellaneous FreeBSD Entities//EN"> 130Sstevel@tonic-gate%misc; 140Sstevel@tonic-gate]> 150Sstevel@tonic-gate 160Sstevel@tonic-gate<article> 170Sstevel@tonic-gate <articleinfo> 180Sstevel@tonic-gate <title>&os; &release.current; README</title> 190Sstevel@tonic-gate 200Sstevel@tonic-gate <corpauthor>The &os; Project</corpauthor> 210Sstevel@tonic-gate 227187Shh224818 <pubdate>$FreeBSD: head/release/doc/en_US.ISO8859-1/readme/article.sgml 127867 2004-04-04 21:33:16Z phantom $</pubdate> 230Sstevel@tonic-gate 240Sstevel@tonic-gate <copyright> 250Sstevel@tonic-gate <year>2000</year> 260Sstevel@tonic-gate <year>2001</year> 270Sstevel@tonic-gate <year>2002</year> 280Sstevel@tonic-gate <year>2003</year> 290Sstevel@tonic-gate <holder role="mailto:doc@FreeBSD.org">The FreeBSD Documentation Project</holder> 300Sstevel@tonic-gate </copyright> 310Sstevel@tonic-gate 320Sstevel@tonic-gate <legalnotice id="trademarks" role="trademarks"> 330Sstevel@tonic-gate &tm-attrib.freebsd; 340Sstevel@tonic-gate &tm-attrib.intel; 350Sstevel@tonic-gate &tm-attrib.opengroup; 360Sstevel@tonic-gate &tm-attrib.sparc; 370Sstevel@tonic-gate &tm-attrib.general; 380Sstevel@tonic-gate </legalnotice> 390Sstevel@tonic-gate </articleinfo> 400Sstevel@tonic-gate 410Sstevel@tonic-gate <abstract> 420Sstevel@tonic-gate <para>This document gives a brief introduction to &os; 430Sstevel@tonic-gate &release.current;. It includes some information on how to 440Sstevel@tonic-gate obtain &os;, a listing of various ways to contact the &os; 450Sstevel@tonic-gate Project, and pointers to some other sources of 460Sstevel@tonic-gate information.</para> 470Sstevel@tonic-gate </abstract> 480Sstevel@tonic-gate 490Sstevel@tonic-gate <sect1 id="intro"> 500Sstevel@tonic-gate <title>Introduction</title> 510Sstevel@tonic-gate 520Sstevel@tonic-gate <para>This distribution is a &release.type; of &os; &release.current;, the 530Sstevel@tonic-gate latest point along the &release.branch; branch.</para> 540Sstevel@tonic-gate 550Sstevel@tonic-gate <sect2> 560Sstevel@tonic-gate <title>About &os;</title> 570Sstevel@tonic-gate 580Sstevel@tonic-gate <para>&os; is an operating system based on 4.4 BSD Lite for 590Sstevel@tonic-gate Intel, AMD, Cyrix or NexGen <quote>x86</quote> based PC 600Sstevel@tonic-gate hardware (&i386;), NEC PC-9801/9821 series PCs and compatibles 610Sstevel@tonic-gate (pc98), DEC/Compaq/HP Alpha computers (alpha), 620Sstevel@tonic-gate and &ultrasparc; machines (&sparc64;). Versions 630Sstevel@tonic-gate for the IA64 (ia64), &powerpc; (&powerpc;), and AMD 640Sstevel@tonic-gate <quote>Hammer</quote> (amd64) architectures are currently under 650Sstevel@tonic-gate development as well. &os; works with a wide variety of 660Sstevel@tonic-gate peripherals and configurations and can be used for everything 670Sstevel@tonic-gate from software development to games to Internet Service 687187Shh224818 Provision.</para> 690Sstevel@tonic-gate 700Sstevel@tonic-gate <para>This release of &os; contains everything you need to run 710Sstevel@tonic-gate such a system, including full source code for the kernel and 720Sstevel@tonic-gate all utilities in the base distribution. With the source 730Sstevel@tonic-gate distribution installed, you can literally recompile the entire 740Sstevel@tonic-gate system from scratch with one command, making it ideal for 750Sstevel@tonic-gate students, researchers, or users who simply want to see how it 760Sstevel@tonic-gate all works.</para> 770Sstevel@tonic-gate 780Sstevel@tonic-gate <para>A large collection of third-party ported software (the 790Sstevel@tonic-gate <quote>Ports Collection</quote>) is also provided to make it 800Sstevel@tonic-gate easy to obtain and install all your favorite traditional &unix; 810Sstevel@tonic-gate utilities for &os;. Each <quote>port</quote> consists of a 820Sstevel@tonic-gate set of scripts to retrieve, configure, build, and install a 830Sstevel@tonic-gate piece of software, with a single command. Over &os.numports; 840Sstevel@tonic-gate ports, from editors to programming languages to graphical 850Sstevel@tonic-gate applications, make &os; a powerful and comprehensive operating 860Sstevel@tonic-gate environment that extends far beyond what's provided by many 870Sstevel@tonic-gate commercial versions of &unix;. Most ports are also available as 880Sstevel@tonic-gate pre-compiled <quote>packages</quote>, which can be quickly 890Sstevel@tonic-gate installed from the installation program.</para> 900Sstevel@tonic-gate </sect2> 910Sstevel@tonic-gate 920Sstevel@tonic-gate <sect2> 930Sstevel@tonic-gate <title>Target Audience</title> 940Sstevel@tonic-gate 950Sstevel@tonic-gate<![ %release.type.snapshot; [ 960Sstevel@tonic-gate 970Sstevel@tonic-gate <para>This &release.type; is aimed primarily at early adopters 980Sstevel@tonic-gate and various other users who want to get involved with the 990Sstevel@tonic-gate ongoing development of &os;. While the &os; development team 1000Sstevel@tonic-gate tries its best to ensure that each &release.type; works as 1010Sstevel@tonic-gate advertised, &release.branch; is very much a 1020Sstevel@tonic-gate work-in-progress.</para> 1030Sstevel@tonic-gate 1040Sstevel@tonic-gate <para>The basic requirements for using this &release.type; are 1050Sstevel@tonic-gate technical proficiency with &os; and an understanding of the 1060Sstevel@tonic-gate ongoing development process of &os; &release.branch; (as 1070Sstevel@tonic-gate discussed on the &a.current;).</para> 1080Sstevel@tonic-gate 1090Sstevel@tonic-gate <para>For those more interested in doing business with &os; than 1100Sstevel@tonic-gate in experimenting with new &os; technology, formal releases 1110Sstevel@tonic-gate (such as &release.prev.stable;) are frequently more appropriate. 1120Sstevel@tonic-gate Releases undergo a period of testing and quality assurance 1130Sstevel@tonic-gate checking to ensure high reliability and dependability.</para> 1140Sstevel@tonic-gate 1150Sstevel@tonic-gate]]> 1160Sstevel@tonic-gate 1170Sstevel@tonic-gate<![ %release.type.release; [ 1180Sstevel@tonic-gate 1190Sstevel@tonic-gate <para>This &release.type; of &os; is suitable for all users. It 1200Sstevel@tonic-gate has undergone a period of testing and quality assurance 1210Sstevel@tonic-gate checking to ensure the highest reliability and 1220Sstevel@tonic-gate dependability.</para> 1230Sstevel@tonic-gate 1240Sstevel@tonic-gate]]> 1250Sstevel@tonic-gate 1260Sstevel@tonic-gate </sect2> 1270Sstevel@tonic-gate </sect1> 1280Sstevel@tonic-gate 1290Sstevel@tonic-gate <sect1 id="obtain"> 1300Sstevel@tonic-gate <title>Obtaining &os;</title> 1310Sstevel@tonic-gate 1320Sstevel@tonic-gate <para>&os; may be obtained in a variety of ways. This section 1330Sstevel@tonic-gate focuses on those ways that are primarily useful for obtaining a 1340Sstevel@tonic-gate complete &os; distribution, rather than updating an existing 1350Sstevel@tonic-gate installation.</para> 1360Sstevel@tonic-gate 1370Sstevel@tonic-gate <sect2> 1380Sstevel@tonic-gate <title>CDROM and DVD</title> 1390Sstevel@tonic-gate 1400Sstevel@tonic-gate <para>&os; -RELEASE distributions may be ordered on CDROM or DVD 1410Sstevel@tonic-gate from several publishers. This is frequently the most 1420Sstevel@tonic-gate convenient way to obtain &os; for new installations, as it 1430Sstevel@tonic-gate provides a convenient way to quickly reinstall the system if 1440Sstevel@tonic-gate necessary. Some distributions include some of the optional, 1450Sstevel@tonic-gate precompiled <quote>packages</quote> from the &os; Ports 1460Sstevel@tonic-gate Collection.</para> 1470Sstevel@tonic-gate 1480Sstevel@tonic-gate <para>A list of the CDROM and DVD publishers known to the 1490Sstevel@tonic-gate project are listed in the <ulink 1500Sstevel@tonic-gate url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/mirrors.html"><quote>Obtaining 1510Sstevel@tonic-gate FreeBSD</quote></ulink> appendix to the Handbook.</para> 1520Sstevel@tonic-gate </sect2> 1530Sstevel@tonic-gate 1540Sstevel@tonic-gate <sect2> 1550Sstevel@tonic-gate <title>FTP</title> 1560Sstevel@tonic-gate 1570Sstevel@tonic-gate <para>You can use FTP to retrieve &os; and any or all of its 1580Sstevel@tonic-gate optional packages from <ulink 1590Sstevel@tonic-gate url="ftp://ftp.FreeBSD.org/"></ulink>, which is the official 1600Sstevel@tonic-gate &os; release site, or any of its 1610Sstevel@tonic-gate <quote>mirrors</quote>.</para> 1620Sstevel@tonic-gate 1630Sstevel@tonic-gate <para>Lists of locations that mirror &os; can be found in the 1640Sstevel@tonic-gate <ulink 1650Sstevel@tonic-gate url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/mirrors-ftp.html">FTP 1660Sstevel@tonic-gate Sites</ulink> section of the Handbook, or on the <ulink 1670Sstevel@tonic-gate url="http://mirrorlist.FreeBSD.org/"></ulink> Web pages. 1680Sstevel@tonic-gate Finding a close (in networking terms) mirror from which to 1690Sstevel@tonic-gate download the distribution is highly recommended.</para> 1700Sstevel@tonic-gate 1710Sstevel@tonic-gate <para>Additional mirror sites are always welcome. Contact 1720Sstevel@tonic-gate <email>freebsd-admin@FreeBSD.org</email> for more details on 1730Sstevel@tonic-gate becoming an official mirror site. You can also find useful 1740Sstevel@tonic-gate information for mirror sites at the <ulink 1750Sstevel@tonic-gate URL="http://www.FreeBSD.org/doc/en_US.ISO8859-1/articles/hubs/">Mirroring 1760Sstevel@tonic-gate FreeBSD</ulink> article.</para> 1770Sstevel@tonic-gate 1780Sstevel@tonic-gate <para>Mirrors generally contain the floppy disk images necessary 1790Sstevel@tonic-gate to begin an installation, as well as the distribution files 1800Sstevel@tonic-gate needed for the install process itself. Many mirrors also 1810Sstevel@tonic-gate contain the ISO images necessary to create a CDROM of 1820Sstevel@tonic-gate a &os; release.</para> 1830Sstevel@tonic-gate 1840Sstevel@tonic-gate </sect2> 1850Sstevel@tonic-gate </sect1> 1860Sstevel@tonic-gate 1870Sstevel@tonic-gate <sect1 id="contacting"> 1880Sstevel@tonic-gate <title>Contacting the &os; Project</title> 1890Sstevel@tonic-gate 1900Sstevel@tonic-gate <sect2> 1910Sstevel@tonic-gate <title>Email and Mailing Lists</title> 1920Sstevel@tonic-gate 1930Sstevel@tonic-gate <para>For any questions or general technical support issues, 1940Sstevel@tonic-gate please send mail to the &a.questions;.</para> 1950Sstevel@tonic-gate 1960Sstevel@tonic-gate <para>If you're tracking the &release.branch; development efforts, you 1970Sstevel@tonic-gate <emphasis>must</emphasis> join the &a.current;, in order to 1980Sstevel@tonic-gate keep abreast of recent developments and changes that may 1990Sstevel@tonic-gate affect the way you use and maintain the system.</para> 2000Sstevel@tonic-gate 2010Sstevel@tonic-gate <para>Being a largely-volunteer effort, the &os; 2020Sstevel@tonic-gate Project is always happy to have extra hands willing to help—there are already far more desired enhancements than 2030Sstevel@tonic-gate there is time to implement them. To contact the developers on 2040Sstevel@tonic-gate technical matters, or with offers of help, please send mail to 2050Sstevel@tonic-gate the &a.hackers;.</para> 2060Sstevel@tonic-gate 2070Sstevel@tonic-gate <para>Please note that these mailing lists can experience 2080Sstevel@tonic-gate <emphasis>significant</emphasis> amounts of traffic. If you 2097656SSherry.Moore@Sun.COM have slow or expensive mail access, or are only interested in 2107656SSherry.Moore@Sun.COM keeping up with major &os; events, you may find it 2110Sstevel@tonic-gate preferable to subscribe instead to the &a.announce;.</para> 2120Sstevel@tonic-gate 2130Sstevel@tonic-gate <para>All of the mailing lists can be freely joined by anyone 2140Sstevel@tonic-gate wishing to do so. Visit the <ulink url="http://www.FreeBSD.org/mailman/listinfo"> 2150Sstevel@tonic-gate FreeBSD Mailman Info Page</ulink>. This will give you more 2160Sstevel@tonic-gate information on joining the various lists, accessing archives, 2170Sstevel@tonic-gate etc. There are a number of mailing lists targeted at special 2180Sstevel@tonic-gate interest groups not mentioned here; more information can be 2190Sstevel@tonic-gate obtained either from the Mailman pages or the <ulink 2207656SSherry.Moore@Sun.COM url="http://www.FreeBSD.org/support.html#mailing-list">mailing 2210Sstevel@tonic-gate lists section</ulink> of the &os; Web site.</para> 2220Sstevel@tonic-gate 2230Sstevel@tonic-gate <important> 2240Sstevel@tonic-gate <para>Do <emphasis>not</emphasis> send email to the lists 2250Sstevel@tonic-gate asking to be subscribed. Use the Mailman interface 2260Sstevel@tonic-gate instead.</para> 2270Sstevel@tonic-gate </important> 2280Sstevel@tonic-gate </sect2> 2290Sstevel@tonic-gate 2300Sstevel@tonic-gate <sect2> 2310Sstevel@tonic-gate <title>Submitting Problem Reports</title> 2320Sstevel@tonic-gate 2330Sstevel@tonic-gate <para>Suggestions, bug reports and contributions of code are 2340Sstevel@tonic-gate always valued—please do not hesitate to report any 2350Sstevel@tonic-gate problems you may find. Bug reports with attached fixes are of 2360Sstevel@tonic-gate course even more welcome.</para> 2370Sstevel@tonic-gate 2380Sstevel@tonic-gate <para>The preferred method to submit bug reports from a machine 2390Sstevel@tonic-gate with Internet mail connectivity is to use the &man.send-pr.1; 2400Sstevel@tonic-gate command. 2410Sstevel@tonic-gate <quote>Problem Reports</quote> (PRs) submitted in this way 2420Sstevel@tonic-gate will be filed and their progress tracked; the &os; developers 2430Sstevel@tonic-gate will do their best to respond to all reported bugs as soon as 2440Sstevel@tonic-gate possible. <ulink 2450Sstevel@tonic-gate url="http://www.FreeBSD.org/cgi/query-pr-summary.cgi">A list 2460Sstevel@tonic-gate of all active PRs</ulink> is available on the &os; Web site; 2470Sstevel@tonic-gate this list is useful to see what potential problems other users 2480Sstevel@tonic-gate have encountered.</para> 2490Sstevel@tonic-gate 2500Sstevel@tonic-gate <para>Note that &man.send-pr.1; itself is a shell script that 2510Sstevel@tonic-gate should be easy to move even onto a non-&os; system. Using 2520Sstevel@tonic-gate this interface is highly preferred. If, for some reason, you 2530Sstevel@tonic-gate are unable to use &man.send-pr.1; to submit a bug report, you 2540Sstevel@tonic-gate can try to send it to the &a.bugs;.</para> 2550Sstevel@tonic-gate 2560Sstevel@tonic-gate <para>For more information, <ulink 2570Sstevel@tonic-gate url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/articles/problem-reports/"><quote>Writing 2580Sstevel@tonic-gate FreeBSD Problem Reports</quote></ulink>, available on the &os; Web 2590Sstevel@tonic-gate site, has a number of helpful hints on writing and submitting 2600Sstevel@tonic-gate effective problem reports.</para> 2610Sstevel@tonic-gate </sect2> 2620Sstevel@tonic-gate </sect1> 2630Sstevel@tonic-gate 2640Sstevel@tonic-gate <sect1 id="seealso"> 2650Sstevel@tonic-gate <title>Further Reading</title> 2660Sstevel@tonic-gate 2670Sstevel@tonic-gate <para>There are many sources of information about &os;; some are 2680Sstevel@tonic-gate included with this distribution, while others are available 2690Sstevel@tonic-gate on-line or in print versions.</para> 2700Sstevel@tonic-gate 2710Sstevel@tonic-gate <sect2 id="release-docs"> 2720Sstevel@tonic-gate <title>Release Documentation</title> 2730Sstevel@tonic-gate 2740Sstevel@tonic-gate <para>A number of other files provide more specific information 2750Sstevel@tonic-gate about this &release.type; distribution. These files are 2760Sstevel@tonic-gate provided in various formats. Most distributions will include 2777187Shh224818 both ASCII text (<filename>.TXT</filename>) and HTML 2780Sstevel@tonic-gate (<filename>.HTM</filename>) renditions. Some distributions 2790Sstevel@tonic-gate may also include other formats such as PostScript 2800Sstevel@tonic-gate (<filename>.PS</filename>) or Portable Document Format 2810Sstevel@tonic-gate (<filename>.PDF</filename>). 2820Sstevel@tonic-gate 2830Sstevel@tonic-gate <itemizedlist> 2840Sstevel@tonic-gate <listitem> 2850Sstevel@tonic-gate <para><filename>README.TXT</filename>: This file, which 2860Sstevel@tonic-gate gives some general information about &os; as well as 2870Sstevel@tonic-gate some cursory notes about obtaining a 2880Sstevel@tonic-gate distribution.</para> 2890Sstevel@tonic-gate </listitem> 2900Sstevel@tonic-gate 2910Sstevel@tonic-gate <listitem> 2920Sstevel@tonic-gate <para><filename>EARLY.TXT</filename>: A guide for early 2930Sstevel@tonic-gate adopters of &os; &release.current;. Highly recommended 2940Sstevel@tonic-gate reading for users new to &os; &release.branch; and/or the 2950Sstevel@tonic-gate 5.<replaceable>X</replaceable> series of releases.</para> 2960Sstevel@tonic-gate </listitem> 2970Sstevel@tonic-gate 2980Sstevel@tonic-gate <listitem> 2990Sstevel@tonic-gate <para><filename>RELNOTES.TXT</filename>: The release 3000Sstevel@tonic-gate notes, showing what's new and different in &os; 3010Sstevel@tonic-gate &release.current; compared to the previous release (&os; 3020Sstevel@tonic-gate &release.prev;).</para> 3030Sstevel@tonic-gate </listitem> 3040Sstevel@tonic-gate 3050Sstevel@tonic-gate <listitem> 3060Sstevel@tonic-gate <para><filename>HARDWARE.TXT</filename>: The hardware 3070Sstevel@tonic-gate compatibility list, showing devices with which &os; has 3080Sstevel@tonic-gate been tested and is known to work.</para> 3090Sstevel@tonic-gate </listitem> 3100Sstevel@tonic-gate 3110Sstevel@tonic-gate <listitem> 3120Sstevel@tonic-gate <para><filename>INSTALL.TXT</filename>: Installation 3130Sstevel@tonic-gate instructions for installing &os; from its distribution 3140Sstevel@tonic-gate media.</para> 3150Sstevel@tonic-gate </listitem> 3160Sstevel@tonic-gate 3170Sstevel@tonic-gate <listitem> 3180Sstevel@tonic-gate <para><filename>ERRATA.TXT</filename>: Release errata. 3190Sstevel@tonic-gate Late-breaking, post-release information can be found in 3200Sstevel@tonic-gate this file, which is principally applicable to releases 3210Sstevel@tonic-gate (as opposed to snapshots). It is important to consult 3220Sstevel@tonic-gate this file before installing a release of &os;, as it 3230Sstevel@tonic-gate contains the latest information on problems which have 3240Sstevel@tonic-gate been found and fixed since the release was 3250Sstevel@tonic-gate created.</para> 3260Sstevel@tonic-gate </listitem> 3270Sstevel@tonic-gate </itemizedlist> 3280Sstevel@tonic-gate 3290Sstevel@tonic-gate <note> 3300Sstevel@tonic-gate <para>Several of these documents (in particular, 3310Sstevel@tonic-gate <filename>RELNOTES.TXT</filename>, 3320Sstevel@tonic-gate <filename>HARDWARE.TXT</filename>, and 3330Sstevel@tonic-gate <filename>INSTALL.TXT</filename>) contain information that 3340Sstevel@tonic-gate is specific to a particular hardware architecture. For 3350Sstevel@tonic-gate example, the alpha release notes contain information not 3360Sstevel@tonic-gate applicable to the &i386;, and vice versa. The architecture 3370Sstevel@tonic-gate for which each document applies will be listed in that 3380Sstevel@tonic-gate document's title.</para> 3390Sstevel@tonic-gate </note> 3400Sstevel@tonic-gate 3410Sstevel@tonic-gate </para> 3420Sstevel@tonic-gate 3430Sstevel@tonic-gate <para>On platforms that support &man.sysinstall.8; (currently 3440Sstevel@tonic-gate alpha, &i386;, ia64, pc98, and &sparc64;), these documents are generally available via the 3450Sstevel@tonic-gate Documentation menu during installation. Once the system is 3460Sstevel@tonic-gate installed, you can revisit this menu by re-running the 3470Sstevel@tonic-gate &man.sysinstall.8; utility.</para> 3480Sstevel@tonic-gate 3490Sstevel@tonic-gate <note> 3500Sstevel@tonic-gate <para>It is extremely important to read the errata for any 3510Sstevel@tonic-gate given release before installing it, to learn about any 3520Sstevel@tonic-gate <quote>late-breaking news</quote> or post-release problems. 3530Sstevel@tonic-gate The errata file accompanying each release (most likely right 3540Sstevel@tonic-gate next to this file) is already out of date by definition, but 3550Sstevel@tonic-gate other copies are kept updated on the Internet and should be 3560Sstevel@tonic-gate consulted as the <quote>current errata</quote> for this 3570Sstevel@tonic-gate release. These other copies of the errata are located at 3580Sstevel@tonic-gate <ulink url="http://www.FreeBSD.org/releases/"></ulink> (as 3590Sstevel@tonic-gate well as any sites which keep up-to-date mirrors of this 3600Sstevel@tonic-gate location).</para> 3610Sstevel@tonic-gate </note> 3620Sstevel@tonic-gate </sect2> 3630Sstevel@tonic-gate 3640Sstevel@tonic-gate <sect2> 3650Sstevel@tonic-gate <title>Manual Pages</title> 3660Sstevel@tonic-gate 3670Sstevel@tonic-gate <para>As with almost all &unix; like operating systems, &os; comes 3680Sstevel@tonic-gate with a set of on-line manual pages, accessed through the 3690Sstevel@tonic-gate &man.man.1; command or through the <ulink 3700Sstevel@tonic-gate url="http://www.FreeBSD.org/cgi/man.cgi">hypertext manual 3710Sstevel@tonic-gate pages gateway</ulink> on the &os; Web site. In general, the 3720Sstevel@tonic-gate manual pages provide information on the different commands and 3730Sstevel@tonic-gate APIs available to the &os; user.</para> 3740Sstevel@tonic-gate 3750Sstevel@tonic-gate <para>In some cases, manual pages are written to give 3760Sstevel@tonic-gate information on particular topics. Notable examples of such 3770Sstevel@tonic-gate manual pages are &man.tuning.7; (a guide to performance tuning), 3780Sstevel@tonic-gate &man.security.7; (an introduction to &os; security), and 3790Sstevel@tonic-gate &man.style.9; (a style guide to kernel coding).</para> 3800Sstevel@tonic-gate </sect2> 3810Sstevel@tonic-gate 3820Sstevel@tonic-gate <sect2> 3830Sstevel@tonic-gate <title>Books and Articles</title> 3840Sstevel@tonic-gate 3850Sstevel@tonic-gate <para>Two highly-useful collections of &os;-related information, 3860Sstevel@tonic-gate maintained by the &os; Project, 3870Sstevel@tonic-gate are the &os; Handbook and &os; FAQ (Frequently Asked 3880Sstevel@tonic-gate Questions document). On-line versions of the <ulink 3890Sstevel@tonic-gate url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/">Handbook</ulink> 3900Sstevel@tonic-gate and <ulink 3910Sstevel@tonic-gate url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/faq/">FAQ</ulink> 3920Sstevel@tonic-gate are always available from the <ulink 3930Sstevel@tonic-gate url="http://www.FreeBSD.org/docs.html">FreeBSD Documentation 3940Sstevel@tonic-gate page</ulink> or its mirrors. If you install the 3950Sstevel@tonic-gate <filename>doc</filename> distribution set, you can use a Web 3960Sstevel@tonic-gate browser to read the Handbook and FAQ locally.</para> 3970Sstevel@tonic-gate 3980Sstevel@tonic-gate <para>A number of on-line books and articles, also maintained by 3990Sstevel@tonic-gate the &os; Project, cover more-specialized, &os;-related topics. 4000Sstevel@tonic-gate This material spans a wide range of topics, from effective use 4010Sstevel@tonic-gate of the mailing lists, to dual-booting &os; with other 4020Sstevel@tonic-gate operating systems, to guidelines for new committers. Like the 4030Sstevel@tonic-gate Handbook and FAQ, these documents are available from the &os; 4040Sstevel@tonic-gate Documentation Page or in the <filename>doc</filename> 4050Sstevel@tonic-gate distribution set.</para> 4060Sstevel@tonic-gate 4070Sstevel@tonic-gate <para>A listing of other books and documents about &os; can be 4080Sstevel@tonic-gate found in the <ulink 4090Sstevel@tonic-gate url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/books/handbook/bibliography.html">bibliography</ulink> 4100Sstevel@tonic-gate of the &os; Handbook. Because of &os;'s strong &unix; heritage, 4110Sstevel@tonic-gate many other articles and books written for &unix; systems are 4120Sstevel@tonic-gate applicable as well, some of which are also listed in the 4130Sstevel@tonic-gate bibliography.</para> 4140Sstevel@tonic-gate </sect2> 4150Sstevel@tonic-gate </sect1> 4160Sstevel@tonic-gate 417829Sry162471 <sect1 id="acknowledgements"> 4180Sstevel@tonic-gate <title>Acknowledgments</title> 4190Sstevel@tonic-gate 4200Sstevel@tonic-gate <para>&os; represents the cumulative work of many hundreds, if not 4210Sstevel@tonic-gate thousands, of individuals from around the world who have worked 4220Sstevel@tonic-gate countless hours to bring about this &release.type;. For a 4230Sstevel@tonic-gate complete list of &os; developers and contributors, please see 4240Sstevel@tonic-gate <ulink 4250Sstevel@tonic-gate url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/articles/contributors/"><quote>Contributors 4260Sstevel@tonic-gate to FreeBSD</quote></ulink> on the &os; Web site or any of its 4270Sstevel@tonic-gate mirrors.</para> 4280Sstevel@tonic-gate 4290Sstevel@tonic-gate <para>Special thanks also go to the many thousands of &os; users 4300Sstevel@tonic-gate and testers all over the world, without whom this &release.type; 4310Sstevel@tonic-gate simply would not have been possible.</para> 4320Sstevel@tonic-gate </sect1> 4330Sstevel@tonic-gate</article> 4340Sstevel@tonic-gate 4350Sstevel@tonic-gate<!-- 4360Sstevel@tonic-gate Local Variables: 4370Sstevel@tonic-gate mode: sgml 4380Sstevel@tonic-gate sgml-indent-data: t 4390Sstevel@tonic-gate sgml-omittag: nil 4400Sstevel@tonic-gate sgml-always-quote-attributes: t 4410Sstevel@tonic-gate End: 4420Sstevel@tonic-gate--> 4430Sstevel@tonic-gate