vmote 2003/07/18 09:39:18 Modified: src/documentation/content/xdocs faq.xml gethelp.xml Log: Recast "Understanding FOP's Compliance" into a more general discussion of limitations in general. Add a "When will feature X be implemented" FAQ to point to the discussion of limitations. Revision Changes Path 1.38 +6 -0 xml-fop/src/documentation/content/xdocs/faq.xml Index: faq.xml =================================================================== RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/faq.xml,v retrieving revision 1.37 retrieving revision 1.38 diff -u -r1.37 -r1.38 --- faq.xml 15 Jul 2003 01:12:33 -0000 1.37 +++ faq.xml 18 Jul 2003 16:39:17 -0000 1.38 @@ -110,6 +110,12 @@ </p> </answer> </faq> + <faq id="when"> + <question>When will feature X be implemented?</question> + <answer> + <p>The short answer is "Don't ask." For more details, see <link href="gethelp.html#limitations">Understand FOP's Limitations</link>.</p> + </answer> + </faq> <faq id="contribute"> <question>How can I contribute?</question> <answer> 1.9 +10 -6 xml-fop/src/documentation/content/xdocs/gethelp.xml Index: gethelp.xml =================================================================== RCS file: /home/cvs/xml-fop/src/documentation/content/xdocs/gethelp.xml,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- gethelp.xml 15 May 2003 16:28:01 -0000 1.8 +++ gethelp.xml 18 Jul 2003 16:39:18 -0000 1.9 @@ -18,14 +18,18 @@ We have included several useful links on our <link href="resources.html">Resources</link> page that may help you get started. </p> </section> - <section id="compliance"> - <title>Review FOP's Standards Compliance</title> - <p>FOP is a work in progress, and does not yet fully comply with the W3C XSL-FO standard. + <section id="limitations"> + <title>Understand FOP's Limitations</title> + <p>FOP is a work in progress, and has some limitations.</p> + <p>FOP does not yet fully comply with the W3C XSL-FO standard. The developers track which standard requirements have been implemented, and have documented these capabilities on the <link href="compliance.html">Compliance</link> page. -If this document appears to be in error, continue down this checklist so that either the document or the software can be corrected. -Otherwise, please do not submit mailing list questions or bug reports regarding features documented in the standard. -Please especially do not submit questions asking when a particular feature will be implemented. +FOP has other limitations regarding specific output formats, graphic formats, etc. +These limitations are noted in appropriate places in the documentation. +If these documents appear to be in error, continue down this checklist so that either the document or the software can be corrected. +Otherwise, please do not submit mailing list questions or bug reports regarding features documented in the standard, or documented as limitations in other parts of the documentation.</p> + <p>Please especially do not submit questions asking when a particular feature will be implemented. There are too many unknowns to make even a reasonable estimate. +Every time a developer stops to answer such a question, the answer will inevitably be "I don't know", but the time taken to respond is time spent away from development. The only sure way to get a feature implemented is to <link href="#how-to-help">pitch in and help</link>.</p> </section> <section id="doc">
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]