Cocoon Documentation

# Things To Do for Cocoon 1.x

<DOCUMENT>
<DEVS> </DEVS>

## high

- [code] Fix caching bug with Lynx. (assigned to RDG)
- [code] Track down cause of multiple PDF problems. (assigned to RDG)
- [docs] Fix dead links in docs. (assigned to RDG)
- [code] Fix XSP string escaping bug, e.g. in util:include-expr
- [code] Fix cache problem with SSI and JSP including [first-pass patch is in bug report]
- [design] Need better exception-handling architecture - converting exceptions to strings in taglibs may not be best solution.
- [samples] Update xinclude samples for new spec. (assigned to DB)

## medium

- [code] Add StoredProcedure support to esql. (assigned to DB)
- [build] Work out how to integrate inline XSP docs (such as inline esql docs) into the build docs procedure. (assigned to RDG)
- [code] Fix remaining caching bugs. Cleanup caching code, which is messy. (assigned to RDG)
- [code] Better HTTP support and conformance (assigned to RDG)
- [docs] Write a full guide to logicsheets, including: (1) What they are and how they work - explaining why XSP results can't be assigned to XSLT variables; (2) What all the supplied logicsheets do (long-term aim: document every tag and every attribute); (3) How to write your own and use it; (4) How to specify logicsheet execution order with the as-yet-undocumented <?xml-logicsheet?> processing instruction. Partial contributions welcome! :-) (assigned to RDG)
- [code] Fix stylesheet-chaining bug. (assigned to RDG)
- [code] Add a working version of JQ's multiline string template to util logicsheet. (assigned to RDG)
- [docs] Cleanup and improve documentation. (in progress.)
- [code] Add standard WEB-INF/classes and WEB-INF/lib to XSP classpath.
- [code] Class auto-reloading for XSP pages (code written; just needs to be merged in and documented.) (assigned to RDG)
- [docs] Ensure that all HTML docs are not too wide for screen/printer width (as appropriate - there are separate directories for screen and printer docs).
- [docs] FAQ (particularly) and XSP docs are too long lengthwise. Split them up. Their length (or complexity) causes extremely slow rendering on Netscape 4.x and recent Mozilla builds.

## low

- [code] Taglib (not part of esql) to dynamically specify connection parameters (with or without connection pooling).
- [code] Make handle.errors.internally return a suitable HTTP error code.
- [code] Add hooks for user-defined error-handling (better than just handle.errors.internally flag in cocoon.properties).
- [docs] Make <connect> tags work correctly when xdocs are transformed to HTML docs.
- [code] Add GroupingProcessor which makes it easy to group elements together in bundles of N (this is messy in XSLT). (assigned to RDG)
- [code] Semi-portable (to C2) XSP redirect semantics (topic for xsp-dev list).
- [code] Make cocoon.properties (i.e. Configurations objects) easily accessible from XSP. (assigned to RDG)
- [code] Fix redundant XSP namespace declarations output quirk. (assigned to RDG)
- [docs] Make authors appear on all HTML docs (where appropriate).
- [code] Fix Jikes compilation error reporting bug.
- [code] Make cache more configurable (e.g. to turn off per-user-agent caching, maybe for specific pages only). However, Mark Washeim thinks that this offers only "trivial" overhead reduction, even on large sites.
- [code] Selection based on domain name not just user agent.
- [code] Better error reporting for typos in stylesheet URIs.
- [code] XSP logicsheet dependency tracking.
- [code] Provide optional conversion from Java line numbers back to XSP line numbers, to aid debugging XSP pages.

## wish

- [code] Add Jeremy Quinn's multiline get-nested-content template to all relevant logicsheets.
- [code] Automated test suite - maybe build upon samples and JMeter??
- [design] Work out best way of breaking the 64K method barrier in XSP. (The ESQL logicsheet already tries to address this by executing queries in separate methods.)
- [code] More powerful request taglib, e.g. list of parameters are read into local variables.
- [code] More logicsheets for common requirements, e.g. upload logicsheet. (see infozone, turbine, etc. for examples; O'Reilly is NOT open source) - but first fix tomcat+apache+cocoon upload bug.
- [code] Support disable-output-escaping for MathML using IBM TechExplorer and other uses.

</DOCUMENT>

Copyright © 1999-2001 The Apache Software Foundation.
All rights reserved.