You are viewing a plain text version of this content. The canonical link for it is here.
Posted to fop-commits@xmlgraphics.apache.org by vm...@apache.org on 2003/05/15 17:57:45 UTC
cvs commit: xml-fop/src/documentation/content/xdocs maillist.xml book.xml resources.xml
vmote 2003/05/15 08:57:45
Modified: src/documentation/content/xdocs book.xml resources.xml
Added: src/documentation/content/xdocs maillist.xml
Log:
Put mailing list information on its own page.
Revision Changes Path
1.22 +1 -0 xml-fop/src/documentation/content/xdocs/book.xml
Index: book.xml
===================================================================
RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/book.xml,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- book.xml 14 May 2003 15:08:00 -0000 1.21
+++ book.xml 15 May 2003 15:57:45 -0000 1.22
@@ -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"/>
1.25 +1 -86 xml-fop/src/documentation/content/xdocs/resources.xml
Index: resources.xml
===================================================================
RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/resources.xml,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- resources.xml 15 May 2003 15:39:27 -0000 1.24
+++ resources.xml 15 May 2003 15:57:45 -0000 1.25
@@ -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">
1.1 xml-fop/src/documentation/content/xdocs/maillist.xml
Index: maillist.xml
===================================================================
<?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>
---------------------------------------------------------------------
To unsubscribe, e-mail: fop-cvs-unsubscribe@xml.apache.org
For additional commands, e-mail: fop-cvs-help@xml.apache.org