Title: Apache(tm) FOP: Mailing List Resources

[fopLatest-runningXalan]: 2.5/running.html#check-input

#Apache™ FOP: Mailing List Resources

## General Information { #general}

Before posting questions to any list:

- Review the [Jakarta Mailing Lists - Guidelines](http://jakarta.apache.org/site/mail.html) for general principles about mailing lists.

- Review "[How To Ask Questions The Smart Way](http://www.catb.org/~esr/faqs/smart-questions.html)".

- Send only *plain text* email messages to any mailing lists. Please do *not* 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.

- Use a mail client that respects the *References* and/or *In-Reply-To* mail header entries. This is important for mail clients that can display threads as trees. **Compliant mail clients** include Microsoft Outlook, Becky!, KMail, Apple Mail, Ximian Evolution, Mozilla (version 1.2 or greater). Non-compliant mail clients include Microsoft Exchange, Lotus Notes, Internet Mail Service (MUA or MTA), and dtmail.

For help in understanding email acronyms, see the [Lingo2Word Acronym List](http://www.lingo2word.com/lists/acronym_listA.html), or the [Keno Internet Services Internet Glossary](http://www.keno.org/web_design/acronyms.htm).

## Apache™ FOP Users Mailing List { #fop-user}

Use this forum to discuss topics of interest to FOP users.

### Archives { #fop-user-archive}

To review the archives, you have several options:
[nabbleLink]: http://apache-fop.1065347.n5.nabble.com/FOP-Users-f3.html
[gmaneLink]:  http://dir.gmane.org/gmane.text.xml.fop.user

- The [Apache Mailing List archive](http://mail-archives.apache.org/mod_mbox/xmlgraphics-fop-users/) (mod_mbox archive, no full-text search, yet).

- The [Mailing list ARChives](http://marc.info/?l=fop-user&r=1&w=2) (MARC) at the AIMS group.

- The [Mail Archive](http://www.mail-archive.com/fop-users%40xmlgraphics.apache.org/).

- The [GMANE archive][gmaneLink].

- The [Nabble archive][nabbleLink] (only posts after May 2005).

- The [MarkMail archive](http://fop-users.markmail.org/).

<note>If you don't like mailing lists and prefer a forum-like system, have a look at [GMANE][gmaneLink] or [Nabble][nabbleLink]. They allow you to post to the mailing list without having to subscribe.</note>

### Subscription Information { #fop-user-subscribe}

- See [Apache XML Graphics Mailing Lists](http://xmlgraphics.apache.org/mail.html) for detailed subscription information.

- To subscribe (digest only): Send email to [fop-users-digest-subscribe@xmlgraphics.apache.org](mailto:fop-users-digest-subscribe@xmlgraphics.apache.org).

- To **subscribe** fully: Send email to [fop-users-subscribe@xmlgraphics.apache.org](mailto:fop-users-subscribe@xmlgraphics.apache.org).

- To receive information about the mailing list: Send email to [fop-users-help@xmlgraphics.apache.org](mailto:fop-users-help@xmlgraphics.apache.org).

- To **unsubscribe**: Send email to [fop-users-unsubscribe@xmlgraphics.apache.org](mailto:fop-users-unsubscribe@xmlgraphics.apache.org).

<note>You can find the developer mailing list on the [Development pages](dev/index.html#mail-fop-dev).</note>

### Submitting a Question { #fop-user-policy}

FOP support is primarily *self-service* . 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 *appropriate to the forum* (i.e. FOP-specific), and that are *submitted after appropriate preparation*. To ensure that your question is not **abusive** of this policy, please use the following checklist:

- Have you followed the [Getting Help](gethelp.html) checklist? If not, please do so before submitting your question.

- 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.

- Have you read [Mailing List General Information](#general) ? If not please do so before proceeding.

- Have you stated the version of FOP you are using? Please do so. Usually, it's a good idea to state the JDK/JRE version and the operating system you're using, too.

- Have you included any detailed error messages? Please do so.

- Does a proper understanding of your question require inclusion of XSLT code, DocBook source, or other semantic XML? If so, the question is *almost certainly not appropriate to this list*. In general, the only input documents that are appropriate on this list are XSL-FO snippets. See [Running Xalan][fopLatest-runningXalan] 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.

- If you are providing one or more XSL-FO snippets:

    - Have you reduced them to the shortest possible complete, **self-contained** document that demonstrates the problem? Please do so.

    - Have you removed images that are not an integral part of the question? Please do so.

    - Have you filtered out confidential material? Please do so.


- If you are including a stack trace:

    - Is it helpful in finding the problem? If not, please do not submit it.

    - Have you included only those portions that are relevant to the question? If not, please do so.


- 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. A good alternative is to put the files on a web server.

## XSL-FO Mailing List (at W3C) { #w3c-xslfo}

Use this forum to ask general XSL-FO questions.


- To review the archive: [W3C XSL-FO Archives](http://lists.w3.org/Archives/Public/www-xsl-fo/).

- Before posting questions to any list, see "[General Information](#general)".

- Subscription administration information can be found at [W3C Mailing List Administrativia](http://www.w3.org/Mail/Request). After reviewing the instructions there, send your subscribe or unsubscribe request to [www-xsl-fo-request@w3.org](mailto:www-xsl-fo-request@w3.org).

## XSL-FO Mailing List (at YahooGroups) { #yahoogroups-xslfo}

Use this forum to ask general XSL-FO questions.


- Before posting questions to any list, see "[General Information](#general)".

- The home page for this groups is [XSL-FO - discussion of XSL Formatting Objects](http://groups.yahoo.com/group/XSL-FO).

## XSLT List (Mulberry Tech) { #xslt-mulberry}


- Before posting questions to any list, see "[General Information](#general)".

- Information for using and subscribing can be found at [XSL-List -- Open Forum on XSL](http://www.mulberrytech.com/xsl/xsl-list).