| the Apache XML site |

| Home |

| Community |

| Samples |

# History of Changes

PDF

- Version 0.5.1 (2003-10-06)
- Version 0.5 (2003-09-13)
- Version 0.4 (2003-02-12)
- Version 0.3 (2003-01-30)
- Version 0.2 (2002-11-16)
- Version 0.2rc1 (2002-11-13)

### Version 0.5.1 (2003-10-06)

- Upgrade to Cocoon 2.1.2, which fixes a bug that caused some pages in a site not to be rendered from the command-line, and has some cosmetic improvements. (JT) Fixes FOR-66, FOR-62.
- In skinconf.xml, made project-description optional to keep compatibility with 0.4. (JT)
- Added obfuscate-mail-links skinconf.xml option, on by default. (JT) Fixes FOR-67.
- Fix forrest-site tables bug that broke Opera (JT) Fixes FOR-65.
- forrest.antproxy.xml script now properly fails when Cocoon fails (JT)
- Fixed URLs for comma-separated bug keys in status.xml (JT)
- Fix bugs in forrest.bat|sh scripts encountered when used in odd environments (perl and Win9x). (JT) Fixes FOR-47, FOR-48.
- The 'forrest' command no longer sources /etc/antrc and ~/.antrc, which solves problems on some *nix distributions. (JT)

### Version 0.5 (2003-09-13)

- adding @label support for notes and warning. (SN)
- Fixed java.lang.reflect.InvocationTargetException caused by catalog HTTP lookup. (DC)
- Fix character return on line feed for fresh-site on the zip distribution (JJP) Fixes FOR-31.
- New property "bugtracking-url" to allow a bug tracking systems other than bugzilla. (JJP)
- Added a "forrest clean" task that removes the project build directory. (JJP) Thanks to Eirik Bjørsnøs.
- In the forrest-site skin and derivatives, display the author and version at the bottom of the page, as krysalis-site does. Also added parsing for CVS Revision tags, so <version>$Revision: 1.213.2.14 $</version> can be used. (JT)
- Added ability to have version-specific overridden sitemaps. For example, src/documentation/sitemap-0.5.xmap will be used by Forrest 0.5 in preference to any others present in the same directory. This means a site with overridden sitemaps can build with Cocoon versions expecting different sitemap formats. (JT)
- Added email template for html content in common skin. (JJP) Thanks to Dave Brondsema.
- Support for version, type and notice on html format. (JJP) Thanks to Eirik Bjørsnøs.
- Style information on the common skin. (JJP) Fixes FOR-34.
- build directory created in wrong directories. (JJP) Thanks to Ross Gardler. Fixes FOR-46.
- On fresh-site: Synchronize size for group and project logo. Added description on site.xml elements so it displays tooltip. (JJP)
- Remove errors for fopx:bookmarks element. (JJP) Fixes FOR-43.
- Add description to {group, project} logo. (JJP) Fixes FOR-23.
- Switched off skinconf.rnc validation to promote better forwards-compat. (JT)
- Upgraded to Cocoon 30/08/2003, now with ability to exclude URLs from being processed, in cli.xconf. (JT)
- Add "title" attribute to menu item links using the "description" attribute from entries in site.xml or book.xml (DC) Thanks to Ralf Hauser. Fixes FOR-20.
- The generated Tables of Contents can be configured to show a certain number of section levels. Default is two levels. Level 0 means show no ToC at all. See the fresh-site skinconf.xml for example usage. (DC) Thanks to Ramón Prades.
- New 'expand-dtd' target for generating monolithic DTDs suitable for use in catalog-ignorant XML editors such as IDEA. (JT)
- Allow images to scale on pdf output. (JJP) Thanks to J.Pietschmann.
- Comma separated bugs have a link to bugzilla systems. (JJP) Thanks to Joerg Heinicke.
- Docbook table header is shifted one column. (JJP) Thanks to Ringo de Smet.
- ihtml now works again. Had to add a jtidy configuration that prevented it to output tidies html to the pipeline, thus making the stylesheet unusable. Also had to fix the sitemap schema. (NKB)
- Cleanup maps:components definitions on sub-maps. Remove indent attr from the xsl:output as it is define on serializer. Move xsl:output for *2document.xsl to "xml-document" serializer. (JJP)
- abstract element was ignored for html output. (JJP) Thanks to Eirik Bjørsnøs. Fixes FOR-51.
- Unescape strings, so they display properly on the trail for all skins. (JJP) Thanks to Ramón Prades.
- Use sync task to clean the tmp directory for xdocs. (JJP) Thanks to Dave Brondsema. Fixes FOR-49.
- Now the Krysalis skin has javascript-collapsable menus. (NKB)
- site.xml changes now picked up without requiring a reload of the webapp. (JT)
- Updated to Cocoon 20/7/03, and use the new command-line (cli.xconf), which makes Forrest static rendering more than twice as fast as before. (JT)
- New Icons. (NKB) Thanks to Frederic Robesyn.
- Added a text2document.xsl stylesheet. Convert to unix format so it stop EOL character. Simplify so it does not use chaperon format. format. (JJP) Thanks to Dave Brondsema.
- Stopped the rewriting of extensions. (JT)
- Updated Cocoon to -D "2003/06/22 12:00". This fixes a bug where files with unknown extensions were written with 'null' appended to their filename. (JT)
- Allow any sort of content inside resources/, which will be made available to the sitemap but not automatically copied to the generated site output. (JT)
- Add a flag for email obfuscation, and turn it off by default. (JT)
- Fixed bug that showed the krysalis-site skin in IE browsers from a remote site to start with a font size of 100. Also made the font size script kick in at the start of the page rendering, as before it resized only after all the page was loaded, which was not nice to say the least. (NKB)
- Added alternative menu/tab selection algorithm, that uses tab attributes in site.xml instead of relying on physical site structure (directories). (JT)
- In PDFs, section titles are no longer numbered/reduced in size indefinitely. (JT)
- Upgraded FOP from 0.20.4 to 0.20.5. (JT)
- Upgraded Cocoon to M2. (JT)
- Make FAQ 'Questions' section more legible, and avoid duplicate numbering in FAQ PDF. (JT)
- Links to subdirectories no longer blow up the command-line rendering. (JT)
- The 'backcopy' command will now copy all types of custom content (*.xmap, skinconf.xml, xdocs, images, stylesheets, DTDs). (JT)
- Add a @indexfile attribute to tabs.xml, so that the user can specify which file the tab links to. (JT)
- Enable link rewriting for *.ehtml files. (JT)
- Enable link rewriting for images and figures (@src attribute). (JT)
- Add <elaborate> to the FAQ <question> element, which lets one provide some background (elaboration) in the FAQ body without cluttering the FAQ list. (JT)
- Allow plain text (instead of just block-level elements) in the FAQ's <answer> element. (JT)
- Added a forrest.maxmemory property specifying the maximum amount of memory allocated to the JVM. Useful for rendering large PDFs. Added forrest.jvmargs property for other JVM options. (JT)
- Get breadcrumbs working in Mac IE 5, and don't capitalize the first letter of each link in the forrest-site skin. (JT) Thanks to Stefan Bodewig.
- Fixed bug where absolute paths to images were created in the build/site directory. (JT)
- Get the Wiki syntax support working again. (JT)
- Created new document-v12 DTD module, containing all DTD improvements made since 0.4 was released, and use it to define new v12 versions of all DTDs (document, howto, faq, etc). The doc-v12 DTD removes many restrictions in the DTD that were found to be unnecessary, and is closer to the HTML content model. A list of changes can be found in the doc-v12 sample page. (JT)
- Fixed rendering of images in PDF for images not located in the resources/images dir. (SN)
- Add automatic (doctype-triggered) handling of todo and changes XML files, regardless of file name or location in the directory tree. The root changes.html and todo.html files are still generated from status.xml. (JT)
- On the forrestbar, added a community menu, made 'AskSam' a resources submenu, moved the search part to the right. (NKB)
- In skins/common/xslt/html/tab2menu.xsl, renamed template 'unselected-tab-href' to 'calculate-tab-href', potentially breaking 3rd party skins. (JT)
- Fix menu bug where links with #fragment identifiers wouldn't display. (JT)
- Get images in PDFs working with FOP 0.20.x. This requires the user to download jimi.jar from Sun and place it in the lib/core (src distro) or WEB-INF/lib (binary distro) directory. (JT)
- On krysalis skin: fixed print css, also using text instead of logos and adding the footer, and changed link colors to blues and red for active links. (NKB)
- On krysalis skin: fixed left navigation bar icons and sizing using divs instead of list elements, made all links underlined, added space to the bottom of the page text, and changed font increase-decrease links to buttons. (NKB)
- On krysalis skin: users can select font size, reworked left-bar inclusion of page section titles, made them only one level deep, moved buttons after the left navbar, added publish date on top right navbar. For both Forrest and krysalis skins, added single background pixel line below unselected tabs and made selected tab more prominent. (NKB)
- Fixed java.lang.NoClassDefFoundError: javax/servlet/ServletInputStream error. (JT) Thanks to Juan Jose Pablos.
- Enabled multiple output links on each page (print - pdf - xml) They can be enabled by adding the relative disable-*-link elements and setting them to false. (NKB)
- Allow users to determine which URLs Forrest should ignore, by overriding stylesheets/filterlinks.xsl (and other stylesheets in that directory). (JT)
- Upgraded to 2003-03-11 version of Cocoon (JT)
- Docbook stylesheet improvements. (JT)
- Forrestbar is now Phoenix compatible. (NKB)
- Added links for both possible local forrests (port 8080 and 8888), and make them configurable in properties.xml. Thanks to Mark Vovsi for pointing it out. (NKB)
- Fix a bug with forrest.antproxy.xml introduced in 0.4, which caused unresolved '${project.home}' variables. (JT)
- Refactored the "transform-to-document" sitemap resource to do the the xinclude, linkrewriter, and idgen steps. (NKB)
- Added XInclude capability to the documents. Remember to disable validations for files with xincludes as the xinclude is not performed during validation. (NKB)
- Added DocBook 4.2 and simplified DocBook 1.0 to the schemas and to the validation catalogue. Added Docbook and simplified Docbook rendering capability for documents. (NKB)

### Version 0.4 (2003-02-12)

- Use meaningful fragment identifiers in krysalis-skin. (JT)
- Correctly ignore @role='pdf' credits in HTML (JT)
- krysalis-site skin now works better with multi-level menus. (NKB)
- Added the CSS validation logo, fixed all skins' CSS to validate, minor fixes due to the switch to full HTML-loose DTD. (NKB)
- Normalize space in acronym titles. (JT)
- Make the forrestbot shell script work under Cygwin. (MP)
- Got skins working in the forrestbot. (JT)
- Added a minimal template skin. (JT)
- The problem with starting a new forked JVM is that all properties get lost. This makes it able to use one forrest.properties for all multiple projects, and just create the docs from there. (NKB) Thanks to Berin Loritsch.
- The menu is now limited to only pages in the current subdirectory and below. (JT) Thanks to Bernhard Brandmair.
- Added the cwiki stylesheets that were missing and an example in the fresh site seed. (NKB) Thanks to Cathy Zura.
- Make the forrest-site and krysalis-site skins more printer friendly by using CSS media type to hide navigations. the avalon-tigris skin already works well, the forrest-site one still needs tweaking. (NKB)
- Use full loose DTD specification for html pages. This also makes the avalon-tigris skin show the same in Mozilla and IE. (NKB)
- Switched all loglevels to ERROR. (NKB)
- Added page for ForrestBar on the site with a simple link and an autoinstall link to the forrestbar.xpi generated by Gump every day. (NKB)
- Correctly serve swf files. (JT)
- Fix site: and ext: rewriting in book.xml, ihtml, ehtml and cwiki files in subdirectories. (JT)

### Version 0.3 (2003-01-30)

- If build/webapp/content/xdocs/* is more recent than src/* equivalent, forrest webapp won't clobber it. A new forrest backcopy command will copy build/webapp/content/xdocs content back to src/documentation/content/xdocs. (JT)
- forrest-site skin is now HTML 4.0.1 compliant. The compliancy validator logo can be switched off with a skinconf.xml element. (JT)
- Indirectly referenced files in skins (eg images in CSSurl()'s) are now copied across to the rendered site. Previously, we relied on spidering to cover the URI space, which has proved insufficient. (JT)
- Lots of FAQ improvements:
  - Improved URI space by using @id attributes as the #fragment-identifier for <faq> and <part> elements.
  - Number FAQ entries and categories
  - Added back-links from FAQ entries to the menu
  - Process tags in <question> in menu entries
  - Indent FAQ text
  - FAQ sample added to seed project
  Thanks to Joerg Pietschmann and Ralf Hauser for the suggestions. (JT)
- On avalon-tigris skin it's now possible to add a mysite.css file to customize the style. An example that can be used is from chaperon.sf.net. Also added a rounded corner to paragraphs, and many minor fixes. (NKB) Thanks to Stefan Michels.
- Fixed the annoying link highlighting on the krysalis skin due to the border. Removed the border, now it highlights fine. (NKB)
- Added <acronym> tag. (JT)
- Added a means to override the check for existing content:

      forrest seed -Dskip.contentcheck=yes

  Thanks to Tom Klaasen. (JT)
- Added the possibility to use svg files instead png images. That is, if an image is found in the images dir that is svg and the browsers requests a png with the same name, the png is created from the svg automatically with batik. (NKB)
- Added the possibility to use wiki files in xdocs instead of xml files. They must have a .cwiki extension, and follow the chaperon wiki format ATM. (NKB)
- Updated part of the editor so that it now can save files in wiki format. Still needs more work. (NKB)
- Updated Batik Block so that now PNGs can be created correctly from SVG. (NKB)
- Added "Edit Page" button to edit the current page in Composer. Still needs an icon. (NKB)
- Added the possibility to use html files in xdocs instead of xml files. They must have an .ihtml extension. (NKB)
- HTML fragment identifiers for sections are now meaningfully named, based on the section title, rather than document-id()-generated characters. (JT)
- Fixed site regeneration bugs where changing the skin in forrest.properties had no effect after the first build. (JT)
- Added copyright statement to PDF footer (10pt, light-grey text). if a skinconf.xml 'credit' element has a role='pdf' attribute, this text will be used instead. Thanks to Keiron Liddle. (JT)
- Now all files in src/documentation/content (except xdocs) and src/documentation/resources/images are copied across when Forrest generates a static site. This fixes the problem when an unparseable file links to another, and Cocoon can't crawl (and hence copy) the linked-to file. An example of this are CSS url('foo.png') image refs (so krysalis-site will now work properly). Also, large batches of pregenerated files like Javadocs will now be copied across instead of individually traversed. (JT)
- New site.xml file in content/xdocs. This is used to implement <link href="site:internalURI"> 'semantic' links, <link href="ext:externalURI"> aliases to external links, and renders book.xml files obsolete. See Menus and Linking for more info. (JT)
- Updated some documentation, especially Forrestbot Introduction (DC)
- Now files present in the content dir are correctly linked and copied verbatim by the CLI. The wellknown files are given with the correct mime-type, and links in html and xml are followed. (NKB)
- Update to 2002-12-26 Cocoon. (JT)
- Tweaked forrestbar, added a sub-project menu for Jakarta, fixed download link and added submenu for tools and gump. (NKB)
- Added rss capability to changes generation. (NKB)
- Added latest krysalis-site skin, using common templates where possible. There is a changes2rss stylesheet that still needs sitemap changes to run. (NKB)
- Now even the selected tab retains a link, to be able to easily select the main page of that tab even if it is "current". (NKB)
- Fixed a bug in the search form where there was no space between search term and 'site:' term. Search form also no longer requires Javascript. (JT) Thanks to Nick Chalko.
- Allow special handling of tab hrefs with #anchor references in them. By default, such menu links are always clickable. (JT)
- Fixed a bug where the no menu entry is 'selected' when in subdirectories. (JT)
- Updated avalon-tigris skin by merging what was in CVS here and what was used in Avalon with its Cocoon-generated site. The visual effect is the same to the current framework and Exalibur Avalon sites. (NKB)
- Now error reporting in shbat CLI runs should work and show the cause of the error; before it was just reporting [broken link]. (NKB)
- Updated latest Cocoon jars: chain metamodule name set to "forrest", and it is used instead of the default one. (NKB)
- Fixed a bug where multiple menu entries are highlighted if the filenames share a common prefix. (JT)
- Allow configuration of a project local-catalog and the entity resolver verbosity level, via forrest.properties configuration. This replaces tokens in the default cocoon.xconf (DC)
- Fixed a bug in forrest.bat, which would fail if run from a different drive to that Forrest was installed in. (JT) Thanks to Omar Belhaj.
- Fix bug where the webapp would break due to missing XML jars under JDK 1.2/1.3. (JT)
- Moved credit and host logos to bottom left corner on forrest-site skin. (JT)
- Make the seed project use the correct 'built with Apache Forrest' logo instead of Cocoon + Centipede logos. (JT)
- Rewrite skins to share a common block of XSLT, which is used via <xsl:import>. This should make skin maintenance much easier. (JT)
- Removed the 'basic' skin, to be shortly replaced with something much more maintainable. (JT)
- Removed some images (built-with-cocoon.gif, centipede-logo-small.gif) from the skins, and moved them to src/documentation/resources/images, as they are Forrest-specific. (JT)
- Added enhancements to status.xml to comply with the needs for a complete status file, like other "STATUS" text files at Apache. Stylesheets not yet done. (NKB)
- Added buttons for nightly Gump runs and local forrest. Corrected and completed existing interface, and made buttons flat (the bar is slimmer too). We need icons for the new buttons. (NKB)

### Version 0.2 (2002-11-16)

- Fixed bug where validation of xdocs was not descending into sub-directories. (DC)
- Fixed bug where changes to the breadcrumb links in skinconf.xml were ignored until the Forrest binary was rebuilt, or the project build/tmp/ deleted. (JT)
- Webapp now works under JDK 1.3 (parsers weren't being copied) (JT)

### Version 0.2rc1 (2002-11-13)

- Added a convert dir in the resources with stylesheets and buildfile to help convert Anakia and Maven-based sites. (NKB)
- Validate project sitemaps and choice of skin (JT)
- Validation of important core configuration files at build-time using RELAX NG. (DC)
- New document Community Resources including draft "Apache Statistics". (DC)
- Fixed selected menu link (meant to be inactive and yellow) (JT)
- Now an id attribute on any XML element below <body> will be rendered as an anchor which can be linked to. (JT)
- Fixed webapp redirect problems under Tomcat and (sometimes) under Jetty. (JT)
- Added alpha system for editing content in the webapp. To try it do "forrest run" and point the browser to http://localhost:8888/edit/ . (NKB)
- Added avalon-tigris skin. (JT) Thanks to Peter Donald.
- Removed unmaintained skins: avalon-site, jakarta-site, xml-apache-site, (JT)
- Removed the dependency that the default "site" target had on clean-site. It means that running "forrest" will not delete the current files in ./build/site/** . (NKB)
- Now Cocoon serves a file directly if the filename matches the one in ./src/documentation/contents/** . (NKB)
- Put the internal matches in a separate pipeline with internal-only="true". (NKB)
- Now site builds do not delete files in build/site that are included in the Ant list of default excludes, like CVS info. (NKB)
- Included Jetty in the shbat distro. type "forrest run" to have the ./build/webapp dir contents be run in a local web server, starting from http://localhost:8888/index.html . (NKB)
- Added a docbook2document.xsl stylesheet to library/xslt. (JT) Thanks to Kevin Ross.
- XML validation is now fully configurable through a hierarchical set of forrest.validation.*{includes,excludes,failonerror} properties. (JT)
- Validate XSLTs in user skins and resources/stylesheets directories. (JT)
- Added new document Standards Compliance Thanks to Robert Koberg. (DC)
- Added Jing "RELAX NG validator in Java" and initial grammar for skinconf.xml files. These config files now get validated during the build. (DC)
- Enhanced forrest-site skin's tabs. Any URL (not just directories) can now be tabbed with a new 'href' attribute. There is an improved 'longest match' algorithm for deciding which tab is on which is more robust than the old one. (JT)
- Fixed a bug where having a tabs.xml link to a file not otherwise mentioned in book.xml caused a broken link. See forrest-dev discussion (JT)
- Fixed all broken links in the Forrest site. (JT)
- Simplified the sitemap-stylesheet contract. Instead of 'dir' and 'resource' parameters with varying meaning, there is just one 'path' parameter. (JT)
- Allow user to specify what XML files to validate via forrest.validate.{includes,excludes} properties. (JT)
- Fixed broken PDFs in most subdirectories. (JT)
- Added a subdirectory to the template site and fixed all broken links. (JT)
- XML doc files are now validated before rendering with the 'validate' target. Uses OASIS catalogs provided by Forrest, optionally augmented by user project catalogs. (JT)
- shbat distribution no longer requires Ant to be preinstalled. Now, nothing but a Java installation is needed. (JT)
- Building Forrest no longer requires a network connection (for downloading Centipede). It is buildable by typing 'ant' or with the provided build scripts. (JT)
- Fixed ClassNotFoundException when running on JDK1.4.x (JT)
- Allow xml:space='preserve' attribute on <p> element, which preserves space without the changed font and block display that <code> uses. (JT)
- Fixed a bug where the log files weren't being created. Thanks to Vladimir Bossicard for reporting. (JT)
- User projects can now override the default cocoon.xconf and logkit.xconf files, by placing these files in src/documentation/conf (JT)
- PDFs for faq, changes and todo now work. (JT)
- "Change History" images (update.jpg, add.jpg etc) are now provided by default by Forrest (in images/), and need not be supplied by user projects. (JT)
- User projects can now add custom classes and jars to Forrest doc builds. Useful for custom sitemap components, or overriding Forrest-provided jars. (JT)
- The locations where Forrest expects doc files to be is now configurable via properties, that can be set in forrest.properties. (JT)
- User projects may now specify their own sitemap, overriding the Forrest-provided one. (JT)
- Made forrest-site skin fully generic, usable with any project. Skins are configured through an external 'skinconf.xml' file, specified by the project. (JT)
- Fixed bug where multiple copies of the same image where generated, one for each directory. Now all image links are page-relative, leading to a single copy. (JT)
- Fixed tab links, which were previously hardcoded and forrest-specific. They are now page-relative. tabs.xml file entries no longer have to end in '/'. (JT)
- Added new document Your Project - getting started with using Forrest (DC)
- Added to the "forrest-site" skin the ability to split source code larger than 80 chars in two or more lines. (NKB)
- Replace the "forrest-site" skin with the new "bert" skin. (DC) Thanks to Bert Van Kets.
- Added the forrestbot - infrastructure and configuration for remote project building. (SN) Thanks to Marc Portier.
- Added breadcrumb trail script from the Avalon site skin. (NKB) Thanks to Leo Simons.
- Updated Cocoon to 2.1-dev to use xsltc and new CLI status messages. Logs are in the build/work/WEB-INF/logs directory and the list of broken links is in the build directory. (NKB)
- added NekoDTD-based DTD documentation using a custom Cocoon Generator (SN)
- draft forrest toolbar for Mozilla (NKB)
- Initial import of Libre facility - replacement for */book.xml (SN) Thanks to Marc Portier.
- Added a draft DTD for the Gump Descriptor forrest.xgump (SN)
- Forrest website is being automatically built and published to krysalis.org (NKB)
- Designed a new skin for the Forrest documents. Particular attention to cross-browser issues. (BK)
- Added initial "Dream List" by harvesting statements from the forrest-dev mail list. (DC)
- Added simple xsl stylesheet for forrest.xgump. In IE6 and Mozilla 6 it renders using this, in older ones it uses the more simplifies CSS version. (NKB)
- Added Forrest to Gump runs. (NKB)
- Added preliminary version of a scarab-like skin. (NKB)
- Added simple css stylesheet for forrest.xgump. In IE and Mozilla 6 it renders. (NKB)
- Fixed links in Forrest home page and added: contributing, mailing list, list archives, who we are. (NKB)
- Updated Centipede stuff to latest changes: - added lib/endorsed dir for endorsed jars that are put in global calsspath - changed the build scripts to not make direct reference to jar files - added "examples" dir in src and creation of examples jar in buils - added "testmodule" target to be run before committing stuff - added "gump" build to be run by Gump (NKB)
- Merged forrest needed info in forrest.xgump. (NKB)
- Updated project descriptor: now it should be usable by Gump. Added basic Forrest descriptor. (NKB)
- Refactored site generation stuff to use skins; still need to integrate with xforrest descriptor. Added jakarta-site, xml-apache-site, cocoon-printer skins. (NKB)
- Imported Centipede as a build system. (SN)
- Ensure that initial DTDs are valid and that the initial XML instances can be validated using these DTDs and OASIS Catalogs. (DC) Thanks to Steven Noels.
- Initial Import (SM)

Copyright © 2002-2003 The Apache Software Foundation. All rights reserved.