diff options
| author | William Victor Mote <vmote@apache.org> | 2003-05-15 15:57:45 +0000 |
|---|---|---|
| committer | William Victor Mote <vmote@apache.org> | 2003-05-15 15:57:45 +0000 |
| commit | a671b91bc0fcc9d52a89ffe549226fe5ef1093ce (patch) | |
| tree | 879c6115d1f74db5d0918b446eb2d5b77781b567 | |
| parent | 4fda9c395c14d06e5fc80f68c85d84846d8a04c2 (diff) | |
| download | xmlgraphics-fop-a671b91bc0fcc9d52a89ffe549226fe5ef1093ce.tar.gz xmlgraphics-fop-a671b91bc0fcc9d52a89ffe549226fe5ef1093ce.zip | |
Put mailing list information on its own page.
git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@196433 13f79535-47bb-0310-9956-ffa450edef68
| -rw-r--r-- | src/documentation/content/xdocs/book.xml | 1 | ||||
| -rw-r--r-- | src/documentation/content/xdocs/maillist.xml | 92 | ||||
| -rw-r--r-- | src/documentation/content/xdocs/resources.xml | 87 |
3 files changed, 94 insertions, 86 deletions
diff --git a/src/documentation/content/xdocs/book.xml b/src/documentation/content/xdocs/book.xml index c9ef14c49..afd087834 100644 --- a/src/documentation/content/xdocs/book.xml +++ b/src/documentation/content/xdocs/book.xml @@ -36,6 +36,7 @@ <menu-item label="FAQs" href="faq.html"/> <menu-item label="XSL-FO" href="fo.html"/> <menu-item label="Examples" href="examples.html"/> + <menu-item label="Mailing Lists" href="maillist.html"/> <menu-item label="Bugs" href="bugs.html"/> <menu-item label="License" href="license.html"/> <menu-item label="Other" href="resources.html"/> diff --git a/src/documentation/content/xdocs/maillist.xml b/src/documentation/content/xdocs/maillist.xml new file mode 100644 index 000000000..3b35e1e04 --- /dev/null +++ b/src/documentation/content/xdocs/maillist.xml @@ -0,0 +1,92 @@ +<?xml version="1.0" standalone="no"?> +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" + "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/resources/schema/dtd/document-v11.dtd"> +<document> + <header> + <title>FOP: Mailing List Resources</title> + </header> + <body> + <section id="general"> + <title>General Information</title> + <p>Before posting questions to any list, review "<jump href="http://www.catb.org/~esr/faqs/smart-questions.html">How To Ask Questions The Smart Way</jump>".</p> + <p>Be sure to set your email client to send plain text email messages to any mailing lists. +Please do <em>not</em> send html or rtf email, as they do not work well with the archive engines. +If you are using Microsoft Outlook, this setting can be found at the "Mail Format" tab of the Tools/Options menu.</p> + <p>For help in understanding email acronyms, see the <jump href="http://www.lingo2word.com/lists/acronym_listA.html">Lingo2Word Acronym List</jump>, or the <jump href="http://www.keno.org/web_design/acronyms.htm">Keno Internet Services Internet Glossary</jump>.</p> + </section> + <section id="fop-user"> + <title>FOP User Mailing List</title> + <p>Use this forum to discuss topics of interest to FOP users.</p> + <section id="fop-user-archive"> + <title>Archives</title> + <p>To review the archives, you have several options:</p> + <ul> + <li>The <jump href="http://marc.theaimsgroup.com/?l=fop-user&r=1&w=2">Mailing list ARChives </jump> (MARC) at the AIMS group (search).</li> + <li>The <jump href="http://nagoya.apache.org/eyebrowse/SummarizeList?listName=fop-user@xml.apache.org">Apache Eyebrowse</jump> archive (search, list by date, author, subject, or thread).</li> + <li>The <link href="http://xml.apache.org/mail/fop-user">Apache Mailing List archive</link> (gzip files).</li> + </ul> + </section> + <section id="fop-user-subscribe"> + <title>Subscription Information</title> + <ul> + <li>See <link href="http://xml.apache.org/mail.html#fop-user">Apache XML Mailing Lists</link> for detailed subscription information.</li> + <li>To subscribe (digest only): Send email to <link href="mailto:fop-user-digest-subscribe@xml.apache.org">fop-user-digest-subscribe@xml.apache.org</link>.</li> + <li>To subscribe fully: Send email to <link href="mailto:fop-user-subscribe@xml.apache.org">fop-user-subscribe@xml.apache.org</link>.</li> + <li>For standard help: Send email to <link href="mailto:fop-user-help@xml.apache.org">fop-user-help@xml.apache.org</link>.</li> + <li>To unsubscribe: Send email to <link href="mailto:fop-user-unsubscribe@xml.apache.org">fop-user-unsubscribe@xml.apache.org</link>.</li> + </ul> + </section> + <section id="fop-user-policy"> + <title>Submitting a Question</title> + <p>FOP support is primarily <em>self-service</em>. The FOP User Mailing List serves as a backup to the self-service documentation for cases where either the documentation is deficient or where users have unusual circumstances. FOP developers and users are happy to help answer questions that are <em>appropriate to the forum</em> (i.e. FOP-specific), and that are <em>submitted after appropriate preparation</em>. To ensure that your question is not <strong>abusive</strong> of this policy, please use the following checklist:</p> + <ul> + <li>Have you followed the <link href="gethelp.html">Getting Help</link> checklist? If not, please do so before submitting your question.</li> + <li>Is your question appropriate to the forum? If it is really an XSL-FO question, XSLT question, or PDF question, please see the other resources on this page that are intended to help you get those questions answered.</li> + <li>Have you read <link href="#mailing-lists-general">Mailing List General Information</link>? If not please do so before proceeding.</li> + <li>Have you stated the version of FOP you are using? Please do so.</li> + <li>Have you included any detailed error messages? Please do so.</li> + <li>Does a proper understanding of your question require inclusion of XSLT code, DocBook source, or other semantic XML? If so, the question is <em>almost certainly not appropriate to this list</em>. In general, the only input documents that are appropriate on this list are XSL-FO snippets. See <link href="running.html#running_xalan">Running Xalan</link> for instructions about capturing the XSL-FO document that is actually submitted to FOP. If you haven't examined the XSL-FO document yourself, then you are not yet prepared to formulate a FOP-specific question.</li> + <li>If you are providing one or more XSL-FO snippets: + <ul> + <li>Have you reduced them to the shortest possible complete, <strong>self-contained</strong> document that demonstrates the problem? Please do so.</li> + <li>Have you removed images that are not an integral part of the question? Please do so.</li> + <li>Have you filtered out confidential material? Please do so.</li> + </ul> + </li> + <li>If you are including a stack trace: + <ul> + <li>Is it helpful in finding the problem? If not, please do not submit it.</li> + <li>Have you included only those portions that are relevant to the question? If not, please do so.</li> + </ul> + </li> + <li>Are you attaching large PDF files or screen shots to your message? If so, please consider attaching a minimal, appropriate B&W GIF, JPG or PNG that conveys the necessary information instead.</li> + </ul> + </section> + </section> + <section id="w3c-xslfo"> + <title>XSL-FO Mailing List (at W3C)</title> + <p>Use this forum to ask general XSL-FO questions.</p> + <ul> + <li>To review the archive: <jump href="http://lists.w3.org/Archives/Public/www-xsl-fo/">W3C XSL-FO Archives</jump>.</li> + <li>Before posting questions to any list, see "<link href="#mailing-lists-general">General Information</link>".</li> + <li>Subscription administration information can be found at <jump href="http://www.w3.org/Mail/Request">W3C Mailing List Administrativia</jump>. +After reviewing the instructions there, send your subscribe or unsubscribe request to <link href="mailto:www-xsl-fo-request@w3.org">www-xsl-fo-request@w3.org</link>.</li> + </ul> + </section> + <section id="yahoogroups-xslfo"> + <title>XSL-FO Mailing List (at YahooGroups)</title> + <p>Use this forum to ask general XSL-FO questions.</p> + <ul> + <li>Before posting questions to any list, see "<link href="#mailing-lists-general">General Information</link>".</li> + <li>The home page for this groups is <jump href="http://groups.yahoo.com/group/XSL-FO">XSL-FO - discussion of XSL Formatting Objects</jump>.</li> + </ul> + </section> + <section id="xslt-mulberry"> + <title>XSLT List (Mulberry Tech)</title> + <ul> + <li>Before posting questions to any list, see "<link href="#mailing-lists-general">General Information</link>".</li> + <li>Information for using and subscribing can be found at <jump href="http://www.mulberrytech.com/xsl/xsl-list">XSL-List -- Open Forum on XSL</jump>.</li> + </ul> + </section> + </body> +</document> diff --git a/src/documentation/content/xdocs/resources.xml b/src/documentation/content/xdocs/resources.xml index 915651e5e..0d27b4e49 100644 --- a/src/documentation/content/xdocs/resources.xml +++ b/src/documentation/content/xdocs/resources.xml @@ -4,95 +4,10 @@ <!-- FOP Relevant Specifications and links --> <document> <header> - <title>Resources</title> + <title>FOP: Other Resources</title> <subtitle>Resources useful for developing and using FOP</subtitle> </header> <body> - <section id="mailing-lists"> - <title>Mailing Lists and Archives</title> - <section id="mailing-lists-general"> - <title>General Information</title> - <p>Before posting questions to any list, review "<jump href="http://www.catb.org/~esr/faqs/smart-questions.html">How To Ask Questions The Smart Way</jump>".</p> - <p>Be sure to set your email client to send plain text email messages to any mailing lists. -Please do <em>not</em> send html or rtf email, as they do not work well with the archive engines. -If you are using Microsoft Outlook, this setting can be found at the "Mail Format" tab of the Tools/Options menu.</p> - <p>For help in understanding email acronyms, see the <jump href="http://www.lingo2word.com/lists/acronym_listA.html">Lingo2Word Acronym List</jump>, or the <jump href="http://www.keno.org/web_design/acronyms.htm">Keno Internet Services Internet Glossary</jump>.</p> - </section> - <section id="mailing-lists-fop-user"> - <title>FOP User Mailing List</title> - <p>Use this forum to discuss topics of interest to FOP users.</p> - <section id="ml-fop-user-archive"> - <title>Archives</title> - <p>To review the archives, you have several options:</p> - <ul> - <li>The <jump href="http://marc.theaimsgroup.com/?l=fop-user&r=1&w=2">Mailing list ARChives </jump> (MARC) at the AIMS group (search).</li> - <li>The <jump href="http://nagoya.apache.org/eyebrowse/SummarizeList?listName=fop-user@xml.apache.org">Apache Eyebrowse</jump> archive (search, list by date, author, subject, or thread).</li> - <li>The <link href="http://xml.apache.org/mail/fop-user">Apache Mailing List archive</link> (gzip files).</li> - </ul> - </section> - <section id="ml-fop-user-subscribe"> - <title>Subscription Information</title> - <ul> - <li>See <link href="http://xml.apache.org/mail.html#fop-user">Apache XML Mailing Lists</link> for detailed subscription information.</li> - <li>To subscribe (digest only): Send email to <link href="mailto:fop-user-digest-subscribe@xml.apache.org">fop-user-digest-subscribe@xml.apache.org</link>.</li> - <li>To subscribe fully: Send email to <link href="mailto:fop-user-subscribe@xml.apache.org">fop-user-subscribe@xml.apache.org</link>.</li> - <li>For standard help: Send email to <link href="mailto:fop-user-help@xml.apache.org">fop-user-help@xml.apache.org</link>.</li> - <li>To unsubscribe: Send email to <link href="mailto:fop-user-unsubscribe@xml.apache.org">fop-user-unsubscribe@xml.apache.org</link>.</li> - </ul> - </section> - <section id="ml-fop-user-policy"> - <title>Sumitting a Question</title> - <p>FOP support is primarily <em>self-service</em>. The FOP User Mailing List serves as a backup to the self-service documentation for cases where either the documentation is deficient or where users have unusual circumstances. FOP developers and users are happy to help answer questions that are <em>appropriate to the forum</em> (i.e. FOP-specific), and that are <em>submitted after appropriate preparation</em>. To ensure that your question is not <strong>abusive</strong> of this policy, please use the following checklist:</p> - <ul> - <li>Have you followed the <link href="gethelp.html">Getting Help</link> checklist? If not, please do so before submitting your question.</li> - <li>Is your question appropriate to the forum? If it is really an XSL-FO question, XSLT question, or PDF question, please see the other resources on this page that are intended to help you get those questions answered.</li> - <li>Have you read <link href="#mailing-lists-general">Mailing List General Information</link>? If not please do so before proceeding.</li> - <li>Have you stated the version of FOP you are using? Please do so.</li> - <li>Have you included any detailed error messages? Please do so.</li> - <li>Does a proper understanding of your question require inclusion of XSLT code, DocBook source, or other semantic XML? If so, the question is <em>almost certainly not appropriate to this list</em>. In general, the only input documents that are appropriate on this list are XSL-FO snippets. See <link href="running.html#running_xalan">Running Xalan</link> for instructions about capturing the XSL-FO document that is actually submitted to FOP. If you haven't examined the XSL-FO document yourself, then you are not yet prepared to formulate a FOP-specific question.</li> - <li>If you are providing one or more XSL-FO snippets: - <ul> - <li>Have you reduced them to the shortest possible complete, <strong>self-contained</strong> document that demonstrates the problem? Please do so.</li> - <li>Have you removed images that are not an integral part of the question? Please do so.</li> - <li>Have you filtered out confidential material? Please do so.</li> - </ul> - </li> - <li>If you are including a stack trace: - <ul> - <li>Is it helpful in finding the problem? If not, please do not submit it.</li> - <li>Have you included only those portions that are relevant to the question? If not, please do so.</li> - </ul> - </li> - <li>Are you attaching large PDF files or screen shots to your message? If so, please consider attaching a minimal, appropriate B&W GIF, JPG or PNG that conveys the necessary information instead.</li> - </ul> - </section> - </section> - <section id="mailing-lists-w3c-xslfo"> - <title>XSL-FO Mailing List (at W3C)</title> - <p>Use this forum to ask general XSL-FO questions.</p> - <ul> - <li>To review the archive: <jump href="http://lists.w3.org/Archives/Public/www-xsl-fo/">W3C XSL-FO Archives</jump>.</li> - <li>Before posting questions to any list, see "<link href="#mailing-lists-general">General Information</link>".</li> - <li>Subscription administration information can be found at <jump href="http://www.w3.org/Mail/Request">W3C Mailing List Administrativia</jump>. -After reviewing the instructions there, send your subscribe or unsubscribe request to <link href="mailto:www-xsl-fo-request@w3.org">www-xsl-fo-request@w3.org</link>.</li> - </ul> - </section> - <section id="mailing-lists-yahoogroups-xslfo"> - <title>XSL-FO Mailing List (at YahooGroups)</title> - <p>Use this forum to ask general XSL-FO questions.</p> - <ul> - <li>Before posting questions to any list, see "<link href="#mailing-lists-general">General Information</link>".</li> - <li>The home page for this groups is <jump href="http://groups.yahoo.com/group/XSL-FO">XSL-FO - discussion of XSL Formatting Objects</jump>.</li> - </ul> - </section> - <section id="mailing-lists-xslt-mulberry"> - <title>XSLT List (Mulberry Tech)</title> - <ul> - <li>Before posting questions to any list, see "<link href="#mailing-lists-general">General Information</link>".</li> - <li>Information for using and subscribing can be found at <jump href="http://www.mulberrytech.com/xsl/xsl-list">XSL-List -- Open Forum on XSL</jump>.</li> - </ul> - </section> - </section> <section id="specs"> <title>Specifications</title> <section id="specs-xslfo"> |