<!--
     The FreeBSD Documentation Project

     $FreeBSD$
-->

<appendix id="eresources">
  <title>Resources on the Internet</title>

  <para>The rapid pace of FreeBSD progress makes print media impractical as a
    means of following the latest developments.  Electronic resources are the
    best, if not often the only, way stay informed of the latest advances.
    Since FreeBSD is a volunteer effort, the user community itself also
    generally serves as a <quote>technical support department</quote> of sorts,
    with electronic mail and  USENET news being the most effective way of
    reaching that community.</para>

  <para>The most important points of contact with the FreeBSD user community
    are outlined below.  If you are aware of other resources not mentioned
    here, please send them to the &a.doc; so that they may also be
    included.</para>

  <sect1 id="eresources-mail">
    <title>Mailing Lists</title>

    <para>Though many of the FreeBSD development members read USENET, we
      cannot always guarantee that we will get to your questions in a timely
      fashion (or at all) if you post them only to one of the
      <literal>comp.unix.bsd.freebsd.*</literal> groups.  By addressing your
      questions to the appropriate mailing list you will reach both us and a
      concentrated FreeBSD audience, invariably assuring a better (or at least
      faster) response.</para>

    <para>The charters for the various lists are given at the bottom of this
      document.  <emphasis>Please read the charter before joining or sending
	mail to any list</emphasis>.  Most of our list subscribers now receive
      many hundreds of FreeBSD related messages every day, and by setting down
      charters and rules for proper use we are striving to keep the
      signal-to-noise ratio of the lists high. To do less would see the
      mailing lists ultimately fail as an effective communications medium for
      the project.</para>

    <para>When in doubt about what list to post a question to, see <ulink
      url="&url.articles.freebsd-questions;">How to get best results from
        the FreeBSD-questions mailing list</ulink>.</para>

    <para>Before posting to any list, please learn about how to best use
      the mailing lists, such as how to help avoid frequently-repeated
      discussions, by reading the <ulink url="&url.articles.mailing-list-faq;">
        Mailing List Frequently Asked Questions</ulink> (FAQ) document.</para>

    <para>Archives are kept for all of the mailing lists and can be searched
      using the <ulink url="&url.base;/search/index.html">FreeBSD World
	Wide Web server</ulink>.  The keyword searchable archive offers an
      excellent way of finding answers to frequently asked questions and
      should be consulted before posting a question.</para>

    <sect2 id="eresources-summary">
      <title>List Summary</title>

      <para><emphasis>General lists:</emphasis> The following are general
	lists which anyone is free (and encouraged) to join:</para>

      <informaltable frame="none" pgwide="1">
	<tgroup cols="2">
	  <thead>
	    <row>
	      <entry>List</entry>
	      <entry>Purpose</entry>
	    </row>
	  </thead>

	  <tbody>
	    <row>
	      <entry>&a.cvsall.name;</entry>
	      <entry>Changes made to the FreeBSD source tree</entry>
	    </row>

	    <row>
	      <entry>&a.advocacy.name;</entry>
	      <entry>FreeBSD Evangelism</entry>
	    </row>

	    <row>
	      <entry>&a.announce.name;</entry>
	      <entry>Important events and project milestones</entry>
	    </row>

	    <row>
	      <entry>&a.arch.name;</entry>
	      <entry>Architecture and design discussions</entry>
	    </row>

	    <row>
	      <entry>&a.bugbusters.name;</entry>
	      <entry>Discussions pertaining to the maintenance of the FreeBSD
		problem report database and related tools</entry>
	    </row>

    	    <row>
	      <entry>&a.bugs.name;</entry>
	      <entry>Bug reports</entry>
	    </row>

	    <row>
	      <entry>&a.chat.name;</entry>
	      <entry>Non-technical items related to the FreeBSD
		community</entry>
	    </row>

	    <row>
	      <entry>&a.current.name;</entry>
	      <entry>Discussion concerning the use of
		&os.current;</entry>
	    </row>

	    <row>
	      <entry>&a.isp.name;</entry>
	      <entry>Issues for Internet Service Providers using
		FreeBSD</entry>
	    </row>

	    <row>
	      <entry>&a.jobs.name;</entry>
	      <entry>FreeBSD employment and consulting
		opportunities</entry>
	    </row>

	    <row>
	      <entry>&a.policy.name;</entry>
	      <entry>FreeBSD Core team policy decisions.  Low volume, and
		read-only</entry>
	    </row>

	    <row>
	      <entry>&a.questions.name;</entry>
	      <entry>User questions and technical support</entry>
	    </row>

	    <row>
	      <entry>&a.security-notifications.name;</entry>
	      <entry>Security notifications</entry>
	    </row>

	    <row>
	      <entry>&a.stable.name;</entry>
	      <entry>Discussion concerning the use of
		&os.stable;</entry>
	    </row>

	    <row>
	      <entry>&a.test.name;</entry>
	      <entry>Where to send your test messages instead of one of
		the actual lists</entry>
	    </row>
	  </tbody>
	</tgroup>
      </informaltable>

      <para><emphasis>Technical lists:</emphasis> The following lists are for
	technical discussion.  You should read the charter for each list
	carefully before joining or sending mail to one as there are firm
	guidelines for their use and content.</para>

      <informaltable frame="none" pgwide="1">
	<tgroup cols="2">
	  <thead>
	    <row>
	      <entry>List</entry>
	      <entry>Purpose</entry>
	    </row>
	  </thead>

	  <tbody>
	    <row>
	      <entry>&a.acpi.name;</entry>
	      <entry>ACPI and power management development</entry>
	    </row>

	    <row>
	      <entry>&a.afs.name;</entry>
	      <entry>Porting AFS to FreeBSD</entry>
	    </row>

	    <row>
	      <entry>&a.aic7xxx.name;</entry>
	      <entry>Developing drivers for the &adaptec; AIC 7xxx</entry>
	    </row>

	    <row>
	      <entry>&a.alpha.name;</entry>
	      <entry>Porting FreeBSD to the Alpha</entry>
	    </row>

	    <row>
	      <entry>&a.amd64.name;</entry>
	      <entry>Porting FreeBSD to AMD64 systems</entry>
	    </row>

	    <row>
	      <entry>&a.apache.name;</entry>
	      <entry>Discussion about <application>Apache</application> related ports</entry>
	    </row>

	    <row>
	      <entry>&a.arm.name;</entry>
	      <entry>Porting FreeBSD to &arm; processors</entry>
	    </row>

	    <row>
	      <entry>&a.atm.name;</entry>
	      <entry>Using ATM networking with FreeBSD</entry>
	    </row>

	    <row>
	      <entry>&a.audit.name;</entry>
	      <entry>Source code audit project</entry>
	    </row>

	    <row>
	      <entry>&a.binup.name;</entry>
	      <entry>Design and development of the binary update system</entry>
	    </row>

	    <row>
	      <entry>&a.bluetooth.name;</entry>
	      <entry>Using &bluetooth; technology in FreeBSD</entry>
	    </row>

	    <row>
	      <entry>&a.cluster.name;</entry>
	      <entry>Using FreeBSD in a clustered environment</entry>
	    </row>

	    <row>
	      <entry>&a.cvsweb.name;</entry>
	      <entry>CVSweb maintenance</entry>
	    </row>

	    <row>
	      <entry>&a.database.name;</entry>
	      <entry>Discussing database use and development under
		FreeBSD</entry>
	    </row>

	    <row>
	      <entry>&a.doc.name;</entry>
	      <entry>Creating FreeBSD related documents</entry>
	    </row>

	    <row>
	      <entry>&a.emulation.name;</entry>
	      <entry>Emulation of other systems such as
		Linux/&ms-dos;/&windows;</entry>
	    </row>

	    <row>
	      <entry>&a.firewire.name;</entry>
	      <entry>FreeBSD &firewire; (iLink, IEEE 1394) technical
		discussion</entry>
	    </row>

	    <row>
	      <entry>&a.fs.name;</entry>
	      <entry>File systems</entry>
	    </row>

	    <row>
	      <entry>&a.geom.name;</entry>
	      <entry>GEOM-specific discussions and implementations</entry>
	    </row>

	    <row>
	      <entry>&a.gnome.name;</entry>
	      <entry>Porting <application>GNOME</application> and <application>GNOME</application> applications</entry>
	    </row>

	    <row>
	      <entry>&a.hackers.name;</entry>
	      <entry>General technical discussion</entry>
	    </row>

	    <row>
	      <entry>&a.hardware.name;</entry>
	      <entry>General discussion of hardware for running
		FreeBSD</entry>
	    </row>

	    <row>
	      <entry>&a.i18n.name;</entry>
	      <entry>FreeBSD Internationalization</entry>
	    </row>

	    <row>
	      <entry>&a.ia32.name;</entry>
	      <entry>FreeBSD on the IA-32 (&intel; x86) platform</entry>
	    </row>

	    <row>
	      <entry>&a.ia64.name;</entry>
	      <entry>Porting FreeBSD to &intel;'s upcoming IA64 systems</entry>
	    </row>

	    <row>
	      <entry>&a.ipfw.name;</entry>
	      <entry>Technical discussion concerning the redesign of the IP
		firewall code</entry>
	    </row>

	    <row>
	      <entry>&a.isdn.name;</entry>
	      <entry>ISDN developers</entry>
	    </row>

	    <row>
	      <entry>&a.java.name;</entry>
	      <entry>&java; developers and people porting &jdk;s to
		FreeBSD</entry>
	    </row>

	    <row>
	      <entry>&a.kde.name;</entry>
	      <entry>Porting <application>KDE</application> and <application>KDE</application> applications</entry>
	    </row>

	    <row>
	      <entry>&a.lfs.name;</entry>
	      <entry>Porting LFS to FreeBSD</entry>
	    </row>

	    <row>
	      <entry>&a.libh.name;</entry>
	      <entry>The second generation installation and package
	         system</entry>
	    </row>

	    <row>
	      <entry>&a.mips.name;</entry>
	      <entry>Porting FreeBSD to &mips;</entry>
	    </row>

	    <row>
	      <entry>&a.mobile.name;</entry>
	      <entry>Discussions about mobile computing</entry>
	    </row>

	    <row>
	      <entry>&a.mozilla.name;</entry>
	      <entry>Porting <application>Mozilla</application> to FreeBSD</entry>
	    </row>

	    <row>
	      <entry>&a.multimedia.name;</entry>
	      <entry>Multimedia applications</entry>
	    </row>

	    <row>
	      <entry>&a.newbus.name;</entry>
	      <entry>Technical discussions about bus architecture</entry>
	    </row>

	    <row>
	      <entry>&a.net.name;</entry>
	      <entry>Networking discussion and TCP/IP source code</entry>
	    </row>

	    <row>
	      <entry>&a.openoffice.name;</entry>
	      <entry>Porting <application>OpenOffice.org</application> and
		<application>&staroffice;</application> to FreeBSD</entry>
	    </row>

	    <row>
	      <entry>&a.performance.name;</entry>
	      <entry>Performance tuning questions for high
		performance/load installations</entry>
	    </row>

	    <row>
	      <entry>&a.perl.name;</entry>
	      <entry>Maintenance of a number of
		<application>perl</application>-related ports</entry>
	    </row>

	    <row>
	      <entry>&a.pf.name;</entry>
	      <entry>Discussion and questions about the packet filter
		firewall system</entry>
	    </row>

	    <row>
	      <entry>&a.platforms.name;</entry>
	      <entry>Concerning ports to non &intel; architecture
		platforms</entry>
	    </row>

	    <row>
	      <entry>&a.ports.name;</entry>
	      <entry>Discussion of the Ports Collection</entry>
	    </row>

	    <row>
	      <entry>&a.ports-bugs.name;</entry>
	      <entry>Discussion of the ports bugs/PRs</entry>
	    </row>

	    <row>
	      <entry>&a.ppc.name;</entry>
	      <entry>Porting FreeBSD to the &powerpc;</entry>
	    </row>

	    <row>
	      <entry>&a.python.name;</entry>
	      <entry>FreeBSD-specific <application>Python</application> issues</entry>
	    </row>

	    <row>
	      <entry>&a.qa.name;</entry>
	      <entry>Discussion of Quality Assurance, usually pending a release</entry>
	    </row>

	    <row>
	      <entry>&a.realtime.name;</entry>
	      <entry>Development of realtime extensions to FreeBSD</entry>
	    </row>

	    <row>
	      <entry>&a.scsi.name;</entry>
	      <entry>The SCSI subsystem</entry>
	    </row>

	    <row>
	      <entry>&a.security.name;</entry>
	      <entry>Security issues affecting FreeBSD</entry>
	    </row>

	    <row>
	      <entry>&a.small.name;</entry>
	      <entry>Using FreeBSD in embedded applications</entry>
	    </row>

	    <row>
	      <entry>&a.smp.name;</entry>
	      <entry>Design discussions for [A]Symmetric
		MultiProcessing</entry>
	    </row>

	    <row>
	      <entry>&a.sparc.name;</entry>
	      <entry>Porting FreeBSD to &sparc; based systems</entry>
	    </row>

	    <row>
	      <entry>&a.standards.name;</entry>
	      <entry>FreeBSD's conformance to the C99 and the &posix;
		standards</entry>
	    </row>

	    <row>
	      <entry>&a.threads.name;</entry>
	      <entry>Threading in FreeBSD</entry>
	    </row>

	    <row>
	      <entry>&a.testing.name;</entry>
	      <entry>FreeBSD Performance and Stability Tests</entry>
	    </row>

	    <row>
	      <entry>&a.tokenring.name;</entry>
	      <entry>Support Token Ring in FreeBSD</entry>
	    </row>

	    <row>
	      <entry>&a.usb.name;</entry>
	      <entry>Discussing &os; support for USB</entry>
	    </row>

	    <row>
	      <entry>&a.vuxml.name;</entry>
	      <entry>Discussion on VuXML infrastructure</entry>
	    </row>

	    <row>
	      <entry>&a.x11.name;</entry>
	      <entry>Maintenance and support of X11 on FreeBSD</entry>
	    </row>
	  </tbody>
	</tgroup>
      </informaltable>

      <para><emphasis>Limited lists:</emphasis> The following lists are for
	more specialized (and demanding) audiences and are probably not of
        interest to the general public.  It is also a good idea to establish a
        presence in the technical lists before joining one of these limited
        lists so that you will understand the communications etiquette involved.</para>

      <informaltable frame="none" pgwide="1">
	<tgroup cols="2">
	  <thead>
	    <row>
	      <entry>List</entry>
	      <entry>Purpose</entry>
	    </row>
	  </thead>

	  <tbody>
	    <row>
	      <entry>&a.hubs.name;</entry>
	      <entry>People running mirror sites (infrastructural
		support)</entry>
	    </row>

	    <row>
	      <entry>&a.usergroups.name;</entry>
	      <entry>User group coordination</entry>
	    </row>

	    <row>
	      <entry>&a.vendors.name;</entry>
	      <entry>Vendors pre-release coordination</entry>
	    </row>

	    <row>
	      <entry>&a.www.name;</entry>
	      <entry>Maintainers of <ulink url="&url.base;/index.html">www.FreeBSD.org</ulink></entry>
	    </row>
	  </tbody>
	</tgroup>
      </informaltable>

      <para><emphasis>Digest lists:</emphasis> All of the above lists
	are available in a digest format.  Once subscribed to a list,
	you can change your digest options in your account options
	section.</para>

      <para><emphasis>CVS lists:</emphasis> The following lists are for people
	interested in seeing the log messages for changes to various areas of
	the source tree.  They are <emphasis>Read-Only</emphasis> lists and
	should not have mail sent to them.</para>

      <informaltable frame="none" pgwide="1">
	<tgroup cols="3">
	  <thead>
	    <row>
	      <entry>List</entry>
	      <entry>Source area</entry>
	      <entry>Area Description (source for)</entry>
	    </row>
	  </thead>

	  <tbody>
	    <row>
	      <entry>&a.cvsall.name;</entry>
	      <entry><filename>/usr/(CVSROOT|doc|ports|projects|src)</filename></entry>
	      <entry>All changes to any place in the tree (superset of other CVS commit lists)</entry>
	    </row>

	    <row>
	      <entry>&a.cvs-doc.name;</entry>
	      <entry><filename>/usr/(doc|www)</filename></entry>
	      <entry>All changes to the doc and www trees</entry>
	    </row>

	    <row>
	      <entry>&a.cvs-ports.name;</entry>
	      <entry><filename>/usr/ports</filename></entry>
	      <entry>All changes to the ports tree</entry>
	    </row>

	    <row>
	      <entry>&a.cvs-projects.name;</entry>
	      <entry><filename>/usr/projects</filename></entry>
	      <entry>All changes to the projects tree</entry>
	    </row>

	    <row>
	      <entry>&a.cvs-src.name;</entry>
	      <entry><filename>/usr/src</filename></entry>
	      <entry>All changes to the src tree</entry>
	    </row>
	  </tbody>
	</tgroup>
      </informaltable>
    </sect2>

    <sect2 id="eresources-subscribe">
      <title>How to Subscribe</title>

      <para>To subscribe to a list, click on the list name above or
        go to &a.mailman.lists.link;
        and click on the list that you are interested in.  The list
        page should contain all of the necessary subscription
        instructions.</para>

      <para>To actually post to a given list you simply send mail to
	<email><replaceable>listname</replaceable>@FreeBSD.org</email>.  It will then
	be redistributed to mailing list members world-wide.</para>

      <para>To unsubscribe yourself from a list, click on the URL
	found at the bottom of every email received from the list.  It
	is also possible to send an email to
	<email><replaceable>listname</replaceable>-unsubscribe@FreeBSD.org</email> to unsubscribe
	yourself.</para>

      <para>Again, we would like to request that you keep discussion in the
	technical mailing lists on a technical track. If you are only
	interested in important announcements then it is suggested that
	you join the &a.announce;, which is intended only for infrequent
	traffic.</para>
    </sect2>

    <sect2 id="eresources-charters">
      <title>List Charters</title>

      <para><emphasis>All</emphasis> FreeBSD mailing lists have certain basic
	rules which must be adhered to by anyone using them. Failure to comply
	with these guidelines will result in two (2) written warnings from the
	FreeBSD Postmaster <email>postmaster@FreeBSD.org</email>, after which,
	on a third offense, the poster will removed from all FreeBSD mailing
	lists and filtered from further posting to them. We regret that such
	rules and measures are necessary at all, but today's Internet is a
	pretty harsh environment, it would seem, and many fail to appreciate
	just how fragile some of its mechanisms are.</para>

      <para>Rules of the road:</para>

      <itemizedlist>
	<listitem>
	  <para>The topic of any posting should adhere to the basic charter of
	    the list it is posted to, e.g. if the list is about technical
	    issues then your posting should contain technical discussion.
	    Ongoing irrelevant chatter or flaming only detracts from the value
	    of the mailing list for everyone on it and will not be tolerated.
	    For free-form discussion on no particular topic, the &a.chat;
	    is freely available and should be used instead.</para>
	</listitem>

	<listitem>
	  <para>No posting should be made to more than 2 mailing lists, and
	    only to 2 when a clear and obvious need to post to both lists
	    exists.  For most lists, there is already a great deal of
	    subscriber overlap and except for the most esoteric mixes (say
	    <quote>-stable &amp; -scsi</quote>), there really is no reason to post to more
	    than one list at a time.  If a message is sent to you in such a
	    way that multiple mailing lists appear on the
	    <literal>Cc</literal> line then the <literal>Cc</literal>
	    line should also be trimmed before sending it out again.
	    <emphasis>You are still responsible for your
	      own cross-postings, no matter who the originator might have
	      been.</emphasis></para>
	</listitem>

	<listitem>
	  <para>Personal attacks and profanity (in the context of an argument)
	    are not allowed, and that includes users and developers alike.
	    Gross breaches of netiquette, like excerpting or reposting private
	    mail when permission to do so was not and would not be
	    forthcoming, are frowned upon but not specifically enforced.
	    <emphasis>However</emphasis>, there are also very few cases where
	    such content would fit within the charter of a list and it would
	    therefore probably rate a warning (or ban) on that basis
	    alone.</para>
	</listitem>

	<listitem>
	  <para>Advertising of non-FreeBSD related products or services is
	    strictly prohibited and will result in an immediate ban if it is
	    clear that the offender is advertising by spam.</para>
	</listitem>
      </itemizedlist>

      <para><emphasis>Individual list charters:</emphasis></para>

      <variablelist>

	<varlistentry>
	  <term>&a.acpi.name;</term>

	  <listitem>
	    <para><emphasis>ACPI and power management
	       development</emphasis></para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.afs.name;</term>

	  <listitem>
	    <para><emphasis>Andrew File System</emphasis></para>

	    <para>This list is for discussion on porting and using AFS from
	      CMU/Transarc</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.announce.name;</term>

	  <listitem>
	    <para><emphasis>Important events / milestones</emphasis></para>

	    <para>This is the mailing list for people interested only in
	      occasional announcements of significant FreeBSD events. This
	      includes announcements about snapshots and other releases.  It
	      contains announcements of new FreeBSD capabilities.  It may
	      contain calls for volunteers etc. This is a low volume, strictly
	      moderated mailing list.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.arch.name;</term>

	  <listitem>
	    <para><emphasis>Architecture and design
		discussions</emphasis></para>

            <para>This list is for discussion of the FreeBSD
	      architecture.  Messages will mostly be kept strictly
	      technical in nature.  Examples of suitable topics
	      are:</para>

	    <itemizedlist>
	      <listitem>
		<para>How to re-vamp the build system to have several
		  customized builds running at the same time.</para>
	      </listitem>

	      <listitem>
		<para>What needs to be fixed with VFS to make Heidemann layers
		  work.</para>
		</listitem>

	      <listitem>
		<para>How do we change the device driver interface to be able
		  to use the same drivers cleanly on many buses and
		  architectures.</para>
	      </listitem>

	      <listitem>
		<para>How to write a network driver.</para>
	      </listitem>
	    </itemizedlist>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.audit.name;</term>

	  <listitem>
	    <para><emphasis>Source code audit project</emphasis></para>

	    <para>This is the mailing list for the FreeBSD source code
	      audit project.  Although this was originally intended for
	      security-related changes, its charter has been expanded to
	      review any code changes.</para>

	    <para>This list is very heavy on patches, and is probably of no
	      interest to the average FreeBSD user.  Security discussions
	      not related to a particular code change are held on
	      freebsd-security.  Conversely, all developers are encouraged
	      to send their patches here for review, especially if they
	      touch a part of the system where a bug may adversely affect
	      the integrity of the system.</para>

<!-- I can't actually find a charter for this, but there's this email: http://www.FreeBSD.org/cgi/getmsg.cgi?fetch=223347+225804+/usr/local/www/db/text/2000/cvs-all/20001210.cvs-all -->
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.binup.name;</term>

	  <listitem>
	    <para><emphasis>FreeBSD Binary Update Project</emphasis></para>

	    <para>This list exists to provide discussion for the binary
	      update system, or <application>binup</application>.
	      Design issues, implementation details,
	      patches, bug reports, status reports, feature requests, commit
	      logs, and all other things related to
	      <application>binup</application> are fair game.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.bluetooth.name;</term>

	  <listitem>
	    <para><emphasis>&bluetooth; in FreeBSD</emphasis></para>

	    <para>This is the forum where FreeBSD's &bluetooth; users
              congregate.  Design issues, implementation details,
              patches, bug reports, status reports, feature requests,
              and all matters related to &bluetooth; are fair
              game.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.bugbusters.name;</term>

	  <listitem>
	    <para><emphasis>Coordination of the Problem Report handling effort</emphasis></para>

	    <para>The purpose of this list is to serve as a coordination and
	      discussion forum for the Bugmeister, his Bugbusters, and any other
	      parties who have a genuine interest in the PR database.  This list
	      is not for discussions about specific bugs, patches or PRs.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.bugs.name;</term>

	  <listitem>
	    <para><emphasis>Bug reports</emphasis></para>

	    <para>This is the mailing list for reporting bugs in FreeBSD.
	      Whenever possible, bugs should be submitted using the
		&man.send-pr.1;
	      command or the <ulink
		url="&url.base;/send-pr.html">WEB
		interface</ulink> to it.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.chat.name;</term>

	  <listitem>
	    <para><emphasis>Non technical items related to the FreeBSD
		community</emphasis></para>

	    <para>This list contains the overflow from the other lists about
	      non-technical, social information.  It includes discussion about
	      whether Jordan looks like a toon ferret or not, whether or not
	      to type in capitals, who is drinking too much coffee, where the
	      best beer is brewed, who is brewing beer in their basement, and
	      so on.  Occasional announcements of important events (such as
	      upcoming parties, weddings, births, new jobs, etc) can be made
	      to the technical lists, but the follow ups should be directed to
	      this -chat list.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.core.name;</term>

	  <listitem>
	    <para><emphasis>FreeBSD core team</emphasis></para>

	    <para>This is an internal mailing list for use by the core
	      members.  Messages can be sent to it when a serious
	      FreeBSD-related matter requires arbitration or high-level
	      scrutiny.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.current.name;</term>

	  <listitem>
	    <para><emphasis>Discussions about the use of
		&os.current;</emphasis></para>

	    <para>This is the mailing list for users of &os.current;.  It
	      includes warnings about new features coming out in -CURRENT that
	      will affect the users, and instructions on steps that must be
	      taken to remain -CURRENT.  Anyone running <quote>CURRENT</quote>
	      must subscribe to this list.  This is a technical mailing list
	      for which strictly technical content is expected.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.cvsweb.name;</term>

	  <listitem>
	    <para><emphasis>FreeBSD CVSweb Project</emphasis></para>

	    <para>Technical discussions about use, development and maintenance
	      of FreeBSD-CVSweb.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.doc.name;</term>

	  <listitem>
	    <para><emphasis>Documentation project</emphasis></para>

	    <para>This mailing list is for the discussion of issues and
	      projects related to the creation of documentation for FreeBSD.
	      The members of this mailing list are collectively referred to as
	      <quote>The FreeBSD Documentation Project</quote>.  It is an open
	      list; feel free to join and contribute!</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.firewire.name;</term>

	  <listitem>
	    <para><emphasis>&firewire; (iLink, IEEE 1394)</emphasis></para>

	    <para>This is a mailing list for discussion of the design
	      and implementation of a &firewire; (aka IEEE 1394 aka
	      iLink) subsystem for FreeBSD.  Relevant topics
	      specifically include the standards, bus devices and
	      their protocols, adapter boards/cards/chips sets, and
	      the architecture and implementation of code for their
	      proper support.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.fs.name;</term>

	  <listitem>
	    <para><emphasis>File systems</emphasis></para>

	    <para>Discussions concerning FreeBSD file systems.  This is a
	      technical mailing list for which strictly technical content is
	      expected.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.geom.name;</term>

	  <listitem>
	    <para><emphasis>GEOM</emphasis></para>

	    <para>Discussions specific to GEOM and related implementations.
	      This is a technical mailing list for which strictly technical
	      content is expected.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.gnome.name;</term>

	  <listitem>
	    <para><emphasis>GNOME</emphasis></para>

	    <para>Discussions concerning The <application>GNOME</application> Desktop Environment for
              FreeBSD systems.  This is a technical mailing list for
	      which strictly technical content is expected.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.ipfw.name;</term>

	  <listitem>
	    <para><emphasis>IP Firewall</emphasis></para>

	    <para>This is the forum for technical discussions concerning the
	      redesign of the IP firewall code in FreeBSD.  This is a
	      technical mailing list for which strictly technical content is
	      expected.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.ia64.name;</term>

	  <listitem>
	    <para><emphasis>Porting FreeBSD to IA64</emphasis></para>

	    <para>This is a technical mailing list for individuals
            actively working on porting FreeBSD to the IA-64 platform
            from &intel;, to bring up problems or discuss alternative
            solutions.  Individuals interested in following the
            technical discussion are also welcome.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.isdn.name;</term>

	  <listitem>
	    <para><emphasis>ISDN Communications</emphasis></para>

	    <para>This is the mailing list for people discussing the
	      development of ISDN support for FreeBSD.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.java.name;</term>

	  <listitem>
	    <para><emphasis>&java; Development</emphasis></para>

	    <para>This is the mailing list for people discussing the
	      development of significant &java; applications for FreeBSD and the
	      porting and maintenance of &jdk;s.</para>
	  </listitem>
	</varlistentry>

	<varlistentry id="eresources-charters-jobs">
	  <term>&a.jobs.name;</term>

	  <listitem>
	    <para><emphasis>Jobs offered and sought</emphasis></para>

	    <para>This is a forum for posting employment notices and
	      resumes specifically related to &os;, e.g. if you are
	      seeking &os;-related employment or have a job involving
	      &os; to advertise then this is the right place.  This is
	      <emphasis>not</emphasis> a mailing list for general
	      employment issues since adequate forums for that
	      already exist elsewhere.</para>

	    <para>Note that this list, like other <hostid role="domainname">FreeBSD.org</hostid> mailing
	      lists, is distributed worldwide.  Thus, you need to be
	      clear about location and the extent to which
	      telecommuting or assistance with relocation is
	      available.</para>

	    <para>Email should use open formats only &mdash;
	      preferably plain text, but basic Portable Document
	      Format (<acronym>PDF</acronym>), HTML, and a few others
	      are acceptable to many readers.  Closed formats such as
	      &microsoft; Word (<filename>.doc</filename>) will be
	      rejected by the mailing list server.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.kde.name;</term>

	  <listitem>
	    <para><emphasis>KDE</emphasis></para>

	    <para>Discussions concerning <application>KDE</application> on
              FreeBSD systems.  This is a technical mailing list for
	      which strictly technical content is expected.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.hackers.name;</term>

	  <listitem>
	    <para><emphasis>Technical discussions</emphasis></para>

	    <para>This is a forum for technical discussions related to
	      FreeBSD.  This is the primary technical mailing list.  It is for
	      individuals actively working on FreeBSD, to bring up problems or
	      discuss alternative solutions.  Individuals interested in
	      following the technical discussion are also welcome.  This is a
	      technical mailing list for which strictly technical content is
	      expected.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.hardware.name;</term>

	  <listitem>
	    <para><emphasis>General discussion of FreeBSD
		hardware</emphasis></para>

	    <para>General discussion about the types of hardware that FreeBSD
	      runs on, various problems and suggestions concerning what to buy
	      or avoid.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.hubs.name;</term>

	  <listitem>
	    <para><emphasis>Mirror sites</emphasis></para>

	    <para>Announcements and discussion for people who run FreeBSD
	      mirror sites.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.isp.name;</term>

	  <listitem>
	    <para><emphasis>Issues for Internet Service
		Providers</emphasis></para>

	    <para>This mailing list is for discussing topics relevant to
	      Internet Service Providers (ISPs) using FreeBSD.  This is a
	      technical mailing list for which strictly technical content is
	      expected.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.openoffice.name;</term>

	  <listitem>
	    <para><emphasis>OpenOffice.org</emphasis></para>

	    <para>Discussions concerning the porting and maintenance
	      of <application>OpenOffice.org</application> and
	      <application>&staroffice;</application>.</para>
	   </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.performance.name;</term>

	  <listitem>
	    <para><emphasis>Discussions about tuning or speeding up FreeBSD</emphasis></para>

	    <para>This mailing list exists to provide a place for
	      hackers, administrators, and/or concerned parties to
	      discuss performance related topics pertaining to
	      FreeBSD.  Acceptable topics includes talking about
	      FreeBSD installations that are either under high load,
	      are experiencing performance problems, or are pushing
	      the limits of FreeBSD.  Concerned parties that are
	      willing to work toward improving the performance of
	      FreeBSD are highly encouraged to subscribe to this list.
	      This is a highly technical list ideally suited for
	      experienced FreeBSD users, hackers, or administrators
	      interested in keeping FreeBSD fast, robust, and
	      scalable.  This list is not a question-and-answer list
	      that replaces reading through documentation, but it is a
	      place to make contributions or inquire about unanswered
	      performance related topics.</para>

	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.pf.name;</term>

	  <listitem>
	    <para><emphasis>Discussion and questions about the packet filter
		firewall system</emphasis></para>

	    <para>Discussion concerning the packet filter (pf) firewall
	      system in terms of FreeBSD. Technical discussion and user
	      questions are both welcome. This list is also a place to
	      discuss the ALTQ QoS framework.</para>

	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.platforms.name;</term>

	  <listitem>
	    <para><emphasis>Porting to Non &intel; platforms</emphasis></para>

	    <para>Cross-platform FreeBSD issues, general discussion and
	      proposals for non &intel; FreeBSD ports.  This is a technical
	      mailing list for which strictly technical content is
	      expected.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.policy.name;</term>

	  <listitem>
	    <para><emphasis>Core team policy decisions</emphasis></para>

	    <para>This is a low volume, read-only mailing list for FreeBSD
	      Core Team Policy decisions.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.ports.name;</term>

	  <listitem>
	    <para><emphasis>Discussion of
		<quote>ports</quote></emphasis></para>

	    <para>Discussions concerning FreeBSD's <quote>ports
	      collection</quote> (<filename>/usr/ports</filename>), ports infrastructure, and
	      general ports coordination efforts.  This is a technical mailing list
	      for which strictly technical content is expected.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.ports-bugs.name;</term>

	  <listitem>
	    <para><emphasis>Discussion of
		<quote>ports</quote> bugs</emphasis></para>

	    <para>Discussions concerning problem reports for FreeBSD's <quote>ports
	      collection</quote> (<filename>/usr/ports</filename>), proposed
	      ports, or modifications to ports.  This is a technical mailing list
	      for which strictly technical content is expected.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.python.name;</term>

	  <listitem>
	    <para><emphasis>Python on FreeBSD</emphasis></para>

	    <para>This is a list for discussions related to improving Python-support
	      on FreeBSD.  This is a technical mailing list.  It is for individuals
	      working on porting Python, its 3rd party modules and Zope stuff to
	      FreeBSD.  Individuals interested in following the technical discussion
	      are also welcome.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.questions.name;</term>

	  <listitem>
	    <para><emphasis>User questions</emphasis></para>

	    <para>This is the mailing list for questions about FreeBSD.  You
	      should not send <quote>how to</quote> questions to the technical
	      lists unless you consider the question to be pretty
	      technical.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.scsi.name;</term>

	  <listitem>
	    <para><emphasis>SCSI subsystem</emphasis></para>

	    <para>This is the mailing list for people working on the SCSI
	      subsystem for FreeBSD.  This is a technical mailing list for
	      which strictly technical content is expected.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.security.name;</term>

	  <listitem>
	    <para><emphasis>Security issues</emphasis></para>

	    <para>FreeBSD computer security issues (DES, Kerberos, known
	      security holes and fixes, etc).  This is a technical mailing
	      list for which strictly technical discussion is expected. Note
	      that this is not a question-and-answer list, but that
	      contributions (BOTH question AND answer) to the FAQ are
	      welcome.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.security-notifications.name;</term>

	  <listitem>
	    <para><emphasis>Security Notifications</emphasis></para>

	    <para>Notifications of FreeBSD security problems and
	      fixes. This is not a discussion list.  The discussion
	      list is FreeBSD-security.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.small.name;</term>

	  <listitem>
	    <para><emphasis>Using FreeBSD in embedded
	      applications</emphasis></para>

	    <para>This list discusses topics related to unusually small and
	      embedded FreeBSD installations.  This is a technical mailing
	      list for which strictly technical content is expected.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.stable.name;</term>

	  <listitem>
	    <para><emphasis>Discussions about the use of
		&os.stable;</emphasis></para>

	    <para>This is the mailing list for users of &os.stable;.  It
	      includes warnings about new features coming out in -STABLE that
	      will affect the users, and instructions on steps that must be
	      taken to remain -STABLE.  Anyone running <quote>STABLE</quote>
	      should subscribe to this list.  This is a technical mailing list
	      for which strictly technical content is expected.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.standards.name;</term>

	  <listitem>
	    <para><emphasis>C99 &amp; POSIX Conformance</emphasis></para>

	    <para>This is a forum for technical discussions related to
	      FreeBSD Conformance to the C99 and the POSIX standards.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.usb.name;</term>

	  <listitem>
	    <para><emphasis>Discussing &os; support for
	      USB</emphasis></para>

	    <para>This is a mailing list for technical discussions
	      related to &os; support for USB.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.usergroups.name;</term>

	  <listitem>
	    <para><emphasis>User Group Coordination List</emphasis></para>

	    <para>This is the mailing list for the coordinators from each of
	      the  local area Users Groups to discuss matters with each other
	      and a  designated individual from the Core Team.  This mail list
	      should be limited to meeting synopsis and coordination of
	      projects that span User Groups.</para>
	  </listitem>
	</varlistentry>

	<varlistentry>
	  <term>&a.vendors.name;</term>

	  <listitem>
	    <para><emphasis>Vendors</emphasis></para>

	    <para>Coordination discussions between The FreeBSD Project and
	      Vendors of software and hardware for FreeBSD.</para>
	  </listitem>
	</varlistentry>

      </variablelist>
    </sect2>
    <sect2 id="eresources-mailfiltering">
      <title>Filtering on the Mailing Lists</title>

      <para>The &os; mailing lists are filtered in multiple ways to
        avoid the distribution of spam, viruses, and other unwanted emails.
        The filtering actions described in this section do not include all
        those used to protect the mailing lists.</para>

      <para>Only certain types of attachments are allowed on the
	mailing lists.  All attachments with a MIME content type not
	found in the list below will be stripped before an email is
	distributed on the mailing lists.</para>

      <itemizedlist>
	<listitem>
	  <para>application/octet-stream</para>
	</listitem>

	<listitem>
	  <para>application/pdf</para>
	</listitem>

	<listitem>
	  <para>application/pgp-signature</para>
	</listitem>

	<listitem>
	  <para>application/x-pkcs7-signature</para>
	</listitem>

	<listitem>
	  <para>message/rfc822</para>
	</listitem>

	<listitem>
	  <para>multipart/alternative</para>
	</listitem>

	<listitem>
	  <para>multipart/related</para>
	</listitem>

	<listitem>
	  <para>multipart/signed</para>
	</listitem>

	<listitem>
	  <para>text/html</para>
	</listitem>

	<listitem>
	  <para>text/plain</para>
	</listitem>

	<listitem>
	  <para>text/x-diff</para>
	</listitem>

	<listitem>
	  <para>text/x-patch</para>
	</listitem>
      </itemizedlist>

      <note>
	<para>Some of the mailing lists might allow attachments of
	  other MIME content types, but the above list should be
	  applicable for most of the mailing lists.</para>
      </note>

      <para>If an email contains both an HTML and a plain text version,
	the HTML version will be removed.  If an email contains only an
	HTML version, it will be converted to plain text.</para>
    </sect2>
  </sect1>

  <sect1 id="eresources-news">
    <title>Usenet Newsgroups</title>

    <para>In addition to two FreeBSD specific newsgroups, there are many
      others in which FreeBSD is discussed or are otherwise relevant to
      FreeBSD users.  <ulink
	url="http://minnie.tuhs.org/BSD-info/bsdnews_search.html">Keyword
	searchable archives</ulink> are available for some of these newsgroups
      from courtesy of Warren Toomey <email>wkt@cs.adfa.edu.au</email>.</para>

    <sect2>
      <title>BSD Specific Newsgroups</title>

      <itemizedlist>
	<listitem>
	  <para><ulink
	      url="news:comp.unix.bsd.freebsd.announce">comp.unix.bsd.freebsd.announce</ulink></para>
	</listitem>

	<listitem>
	  <para><ulink
	      url="news:comp.unix.bsd.freebsd.misc">comp.unix.bsd.freebsd.misc</ulink></para>
	</listitem>

	<listitem>
	  <para><ulink
	      url="news:de.comp.os.unix.bsd">de.comp.os.unix.bsd</ulink> (German)</para>
	</listitem>

	<listitem>
	  <para><ulink
	    url="news:fr.comp.os.bsd">fr.comp.os.bsd</ulink> (French)</para>
	</listitem>

	<listitem>
	  <para><ulink
	    url="news:it.comp.os.freebsd">it.comp.os.freebsd</ulink> (Italian)</para>
	</listitem>
      </itemizedlist>
    </sect2>

    <sect2>
      <title>Other &unix; Newsgroups of Interest</title>

      <itemizedlist>
	<listitem>
	  <para><ulink url="news:comp.unix">comp.unix</ulink></para>
	</listitem>

	<listitem>
	  <para><ulink
	      url="news:comp.unix.questions">comp.unix.questions</ulink></para>
	</listitem>

	<listitem>
	  <para><ulink
	      url="news:comp.unix.admin">comp.unix.admin</ulink></para>
	</listitem>

	<listitem>
	  <para><ulink
	      url="news:comp.unix.programmer">comp.unix.programmer</ulink></para>
	</listitem>

	<listitem>
	  <para><ulink
	      url="news:comp.unix.shell">comp.unix.shell</ulink></para>
	</listitem>

	<listitem>
	  <para><ulink
	      url="news:comp.unix.user-friendly">comp.unix.user-friendly</ulink></para>
	</listitem>

	<listitem>
	  <para><ulink
	      url="news:comp.security.unix">comp.security.unix</ulink></para>
	</listitem>

	<listitem>
	  <para><ulink
	      url="news:comp.sources.unix">comp.sources.unix</ulink></para>
	</listitem>

	<listitem>
	  <para><ulink
	      url="news:comp.unix.advocacy">comp.unix.advocacy</ulink></para>
	</listitem>

	<listitem>
	  <para><ulink
	      url="news:comp.unix.misc">comp.unix.misc</ulink></para>
	</listitem>

	<listitem>
	  <para><ulink
	      url="news:comp.bugs.4bsd">comp.bugs.4bsd</ulink></para>
	</listitem>

	<listitem>
	  <para><ulink
	      url="news:comp.bugs.4bsd.ucb-fixes">comp.bugs.4bsd.ucb-fixes</ulink></para>
	</listitem>

	<listitem>
	  <para><ulink
	      url="news:comp.unix.bsd">comp.unix.bsd</ulink></para>
	</listitem>
      </itemizedlist>
    </sect2>

    <sect2>
      <title>X Window System</title>

      <itemizedlist>
	<listitem>
	  <para><ulink
	      url="news:comp.windows.x.i386unix">comp.windows.x.i386unix</ulink></para>
	</listitem>

	<listitem>
	  <para><ulink
	      url="news:comp.windows.x">comp.windows.x</ulink></para>
	</listitem>

	<listitem>
	  <para><ulink
	      url="news:comp.windows.x.apps">comp.windows.x.apps</ulink></para>
	</listitem>

	<listitem>
	  <para><ulink
	      url="news:comp.windows.x.announce">comp.windows.x.announce</ulink></para>
	</listitem>

	<listitem>
	  <para><ulink
	      url="news:comp.windows.x.intrinsics">comp.windows.x.intrinsics</ulink></para>
	</listitem>

	<listitem>
	  <para><ulink
	      url="news:comp.windows.x.motif">comp.windows.x.motif</ulink></para>
	</listitem>

	<listitem>
	  <para><ulink
	      url="news:comp.windows.x.pex">comp.windows.x.pex</ulink></para>
	</listitem>

	<listitem>
	  <para><ulink
	      url="news:comp.emulators.ms-windows.wine">comp.emulators.ms-windows.wine</ulink></para>
	</listitem>
      </itemizedlist>
    </sect2>
  </sect1>

  <sect1 id="eresources-web">
    <title>World Wide Web Servers</title>

    &chap.eresources.www.inc;
  </sect1>

  <sect1 id="eresources-email">
    <title>Email Addresses</title>

    <para>The following user groups provide FreeBSD related email addresses
      for their members.  The listed administrator reserves the right to
      revoke the address if it is abused in any way.</para>

    <informaltable frame="none" pgwide="1">
      <tgroup cols="4">
        <thead>
	  <row>
	    <entry>Domain</entry>
	    <entry>Facilities</entry>
	    <entry>User Group</entry>
	    <entry>Administrator</entry>
          </row>
	</thead>

	<tbody>
	  <row>
	    <entry>ukug.uk.FreeBSD.org</entry>
	    <entry>Forwarding only</entry>
	    <entry><email>freebsd-users@uk.FreeBSD.org</email></entry>
	    <entry>Lee Johnston
	      <email>lee@uk.FreeBSD.org</email></entry>
	  </row>
	</tbody>
      </tgroup>
    </informaltable>
  </sect1>

  <sect1 id="eresources-shell">
    <title>Shell Accounts</title>

    <para>The following user groups provide shell accounts for people who are
      actively supporting the FreeBSD project.  The listed administrator
      reserves the right to cancel the account if it is abused in any
      way.</para>

    <informaltable frame="none" pgwide="1">
      <tgroup cols="4">
	<thead>
	  <row>
	    <entry>Host</entry>
	    <entry>Access</entry>
	    <entry>Facilities</entry>
	    <entry>Administrator</entry>
          </row>
	</thead>

	<tbody>
	  <row>
	    <entry>dogma.freebsd-uk.eu.org</entry>
	    <entry>Telnet/FTP/SSH</entry>
	    <entry>Email, Web space, Anonymous FTP</entry>
            <entry>Lee Johnston
		<email>lee@uk.FreeBSD.org</email></entry>
	  </row>
	</tbody>
      </tgroup>
    </informaltable>
  </sect1>
</appendix>

<!--
     Local Variables:
     mode: sgml
     sgml-declaration: "../appendix.decl"
     sgml-indent-data: t
     sgml-omittag: nil
     sgml-always-quote-attributes: t
     sgml-parent-document: ("../book.sgml" "part" "appendix")
     End:
-->
