diff options
Diffstat (limited to 'en_US.ISO8859-1/articles/mailing-list-faq/article.xml')
| -rw-r--r-- | en_US.ISO8859-1/articles/mailing-list-faq/article.xml | 138 |
1 files changed, 60 insertions, 78 deletions
diff --git a/en_US.ISO8859-1/articles/mailing-list-faq/article.xml b/en_US.ISO8859-1/articles/mailing-list-faq/article.xml index d1423db9ca..6fc2bcbea0 100644 --- a/en_US.ISO8859-1/articles/mailing-list-faq/article.xml +++ b/en_US.ISO8859-1/articles/mailing-list-faq/article.xml @@ -1,18 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V4.5-Based Extension//EN" - "../../../share/xml/freebsd45.dtd"> - +<!DOCTYPE article PUBLIC "-//FreeBSD//DTD DocBook XML V5.0-Based Extension//EN" + "../../../share/xml/freebsd50.dtd"> <!-- $FreeBSD$ --> <!-- The FreeBSD Documentation Project --> - -<article lang='en'> - <articleinfo> - <title>Frequently Asked Questions About The &os; Mailing Lists</title> +<article xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:lang="en"> + <info><title>Frequently Asked Questions About The &os; Mailing Lists</title> + <authorgroup> - <author> - <surname>The &os; Documentation Project</surname> - </author> + <author><personname><surname>The &os; Documentation Project</surname></personname></author> </authorgroup> <copyright> @@ -29,19 +25,16 @@ <para>This is the FAQ for the &os; mailing lists. If you are interested in helping with this project, send email to the &a.doc;. The latest version of this document is always available from the - <ulink - url="http://www.FreeBSD.org/doc/en_US.ISO8859-1/articles/mailing-list-faq/index.html">&os; - World Wide Web server</ulink>. It may also be downloaded as - one large <ulink url="article.html">HTML</ulink> file with HTTP - or as plain text, PostScript, PDF, etc. from the <ulink - url="ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/">&os; FTP - server</ulink>. You may also want to <ulink - url="&url.base;/search/index.html">Search the - FAQ</ulink>.</para> + <link xlink:href="http://www.FreeBSD.org/doc/en_US.ISO8859-1/articles/mailing-list-faq/index.html">&os; + World Wide Web server</link>. It may also be downloaded as + one large <link xlink:href="article.html">HTML</link> file with HTTP + or as plain text, PostScript, PDF, etc. from the <link xlink:href="ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/">&os; FTP + server</link>. You may also want to <link xlink:href="&url.base;/search/index.html">Search the + FAQ</link>.</para> </abstract> - </articleinfo> + </info> - <sect1 id="introduction"> + <sect1 xml:id="introduction"> <title>Introduction</title> <para>As is usual with FAQs, this document aims to cover the @@ -59,7 +52,7 @@ <qandaset> <qandaentry> - <question id="purpose"> + <question xml:id="purpose"> <para>What is the purpose of the &os; mailing lists?</para> </question> @@ -71,21 +64,20 @@ </qandaentry> <qandaentry> - <question id="audience"> + <question xml:id="audience"> <para>Who is the audience for the &os; mailing lists?</para> </question> <answer> <para>This depends on charter of each individual list. Some lists are more oriented to developers; some are more oriented - towards the &os; community as a whole. Please see <ulink - url="http://lists.FreeBSD.org/mailman/listinfo">this list</ulink> + towards the &os; community as a whole. Please see <link xlink:href="http://lists.FreeBSD.org/mailman/listinfo">this list</link> for the current summary.</para> </answer> </qandaentry> <qandaentry> - <question id="participation-who"> + <question xml:id="participation-who"> <para>Are the &os; mailing lists open for anyone to participate?</para> </question> @@ -111,20 +103,19 @@ </qandaentry> <qandaentry> - <question id="subscribe"> + <question xml:id="subscribe"> <para>How can I subscribe?</para> </question> <answer> - <para>You can use <ulink - url="http://lists.FreeBSD.org/mailman/listinfo"> - the Mailman web interface</ulink> to subscribe to any + <para>You can use <link xlink:href="http://lists.FreeBSD.org/mailman/listinfo"> + the Mailman web interface</link> to subscribe to any of the public lists.</para> </answer> </qandaentry> <qandaentry> - <question id="unsubscribe"> + <question xml:id="unsubscribe"> <para>How can I unsubscribe?</para> </question> @@ -143,31 +134,30 @@ </qandaentry> <qandaentry> - <question id="archives"> + <question xml:id="archives"> <para>Are archives available?</para> </question> <answer> <para>Yes. Threaded archives are available - <ulink url="http://docs.FreeBSD.org/mail/">here</ulink>.</para> + <link xlink:href="http://docs.FreeBSD.org/mail/">here</link>.</para> </answer> </qandaentry> <qandaentry> - <question id="digest"> + <question xml:id="digest"> <para>Are mailing lists available in a digest format?</para> </question> <answer> - <para>Yes. See <ulink - url="http://lists.FreeBSD.org/mailman/listinfo"> - the Mailman web interface</ulink>.</para> + <para>Yes. See <link xlink:href="http://lists.FreeBSD.org/mailman/listinfo"> + the Mailman web interface</link>.</para> </answer> </qandaentry> </qandaset> </sect1> - <sect1 id="etiquette"> + <sect1 xml:id="etiquette"> <title>Mailing List Etiquette</title> <para>Participation in the mailing lists, like participation @@ -177,7 +167,7 @@ <qandaset> <qandaentry> - <question id="before-posting"> + <question xml:id="before-posting"> <para>What should I do before I post?</para> </question> @@ -187,23 +177,18 @@ you may first need to familiarize yourself with the software, and all the social history around it, by reading the numerous - <ulink url="&url.base;/docs/books.html">books and articles</ulink> + <link xlink:href="&url.base;/docs/books.html">books and articles</link> that are available. Items of particular interest - include the <ulink - url="&url.books.faq;/index.html"> - &os; Frequently Asked Questions (FAQ)</ulink> document, - the <ulink - url="&url.books.handbook;/index.html"> - &os; Handbook</ulink>, - and the articles <ulink - url="&url.articles.freebsd-questions;/article.html"> - How to get best results from the FreeBSD-questions mailing list</ulink>, - <ulink - url="&url.articles.explaining-bsd;/article.html"> - Explaining BSD</ulink>, - and <ulink - url="&url.articles.new-users;/article.html"> - &os; First Steps</ulink>.</para> + include the <link xlink:href="&url.books.faq;/index.html"> + &os; Frequently Asked Questions (FAQ)</link> document, + the <link xlink:href="&url.books.handbook;/index.html"> + &os; Handbook</link>, + and the articles <link xlink:href="&url.articles.freebsd-questions;/article.html"> + How to get best results from the FreeBSD-questions mailing list</link>, + <link xlink:href="&url.articles.explaining-bsd;/article.html"> + Explaining BSD</link>, + and <link xlink:href="&url.articles.new-users;/article.html"> + &os; First Steps</link>.</para> <para>It is always considered bad form to ask a question that is already answered in the above documents. This is not because @@ -219,7 +204,7 @@ </qandaentry> <qandaentry> - <question id="inappropriate"> + <question xml:id="inappropriate"> <para>What constitutes an inappropriate posting?</para> </question> @@ -245,7 +230,7 @@ </qandaentry> <qandaentry> - <question id="etiquette-posting"> + <question xml:id="etiquette-posting"> <para>What is considered proper etiquette when posting to the mailing lists?</para> </question> @@ -284,8 +269,8 @@ <para>Please use an appropriate human language for a particular mailing list. Many non-English mailing lists are - <ulink url="&url.base;/community/mailinglists.html"> - available</ulink>.</para> + <link xlink:href="&url.base;/community/mailinglists.html"> + available</link>.</para> <para>For the ones that are not, we do appreciate that many people do not speak English as their first language, @@ -299,8 +284,8 @@ <listitem> <para>Please use a standards-compliant Mail User Agent (MUA). A lot of badly formatted messages come from - <ulink url="http://www.lemis.com/email.html">bad mailers - or badly configured mailers</ulink>. The following mailers + <link xlink:href="http://www.lemis.com/email.html">bad mailers + or badly configured mailers</link>. The following mailers are known to send out badly formatted messages without you finding out about them:</para> @@ -360,8 +345,8 @@ <filename>Makefiles</filename>, where <literal>tab</literal> is a significant character. This is a very common, and very annoying, problem with submissions to the - <ulink url="&url.base;/support.html#gnats"> - GNATS Problem Reports database</ulink>. + <link xlink:href="&url.base;/support.html#gnats"> + GNATS Problem Reports database</link>. <filename>Makefiles</filename> with tabs changed to either spaces, or the annoying <literal>=3B</literal> escape sequence, create a great deal of aggravation for @@ -372,7 +357,7 @@ </qandaentry> <qandaentry> - <question id="etiquette-replying"> + <question xml:id="etiquette-replying"> <para>What are the special etiquette consideration when replying to an existing posting on the mailing lists?</para> </question> @@ -431,7 +416,7 @@ </qandaset> </sect1> - <sect1 id="recurring"> + <sect1 xml:id="recurring"> <title>Recurring Topics On The Mailing Lists</title> <para>Participation in the mailing lists, like participation @@ -445,12 +430,11 @@ and probably save yourself being flamed in the process.</para> <para>The best method to avoid this is to familiarize yourself - with the <ulink url="http://docs.FreeBSD.org/mail/"> - mailing list archives</ulink>, + with the <link xlink:href="http://docs.FreeBSD.org/mail/"> + mailing list archives</link>, to help yourself understand the background of - what has gone before. In this, the <ulink - url="http://www.FreeBSD.org/search/search.html#mailinglists"> - mailing list search interface</ulink> + what has gone before. In this, the <link xlink:href="http://www.FreeBSD.org/search/search.html#mailinglists"> + mailing list search interface</link> is invaluable. (If that method does not yield useful results, please supplement it with a search with your favorite major search engine).</para> @@ -469,16 +453,15 @@ to help avoid these recurring topics.</para> </sect1> - <sect1 id="bikeshed"> + <sect1 xml:id="bikeshed"> <title>What Is A "Bikeshed"?</title> <para>Literally, a <literal>bikeshed</literal> is a small outdoor shelter into which one may store one's two-wheeled form of transportation. However, in &os; parlance, the term refers to topics that are simple enough that (nearly) anyone can offer an opinion about, and often (nearly) everyone does. The - genesis of this term is explained in more detail <ulink - url="&url.books.faq;/misc.html#BIKESHED-PAINTING"> - in this document</ulink>. You simply must have a working + genesis of this term is explained in more detail <link xlink:href="&url.books.faq;/misc.html#BIKESHED-PAINTING"> + in this document</link>. You simply must have a working knowledge of this concept before posting to any &os; mailing list.</para> @@ -491,7 +474,7 @@ Thanks.</para> </sect1> - <sect1 id="acknowledgments"> + <sect1 xml:id="acknowledgments"> <title>Acknowledgments</title> <variablelist> @@ -499,9 +482,8 @@ <term>&a.grog.email;</term> <listitem> <para>Original author of most of the material on mailing - list etiquette, taken from the article on <ulink - url="&url.articles.freebsd-questions;/article.html"> - How to get best results from the FreeBSD-questions mailing list</ulink>.</para> + list etiquette, taken from the article on <link xlink:href="&url.articles.freebsd-questions;/article.html"> + How to get best results from the FreeBSD-questions mailing list</link>.</para> </listitem> </varlistentry> |