# Changes

dIon Gillard
Vincent Massol
Arnaud Heritier
Vincent Siveton

## 1.10 in SVN

Update dependencies to match ones in maven 1.1 core and to unify them between plugins. The following dependencies are updated :

- commons-jelly v1.0-RC1 -> v1.0
- commons-logging v1.0.3 -> v1.0.4
- maven-model v3.0.0 -> v3.0.1

(update, MAVEN-1712, aheritier)
maven.ui.navcol.width
has no effect. (fix, MPXDOC-178, ltheussl, due to Phil Steitz)
When there's no user provided documentation, some generated docs don't get copied to site. (fix, MPXDOC-176, ltheussl)
Menus with `type="header"` are not processed by `site.jsl`. (fix, MPXDOC-175, ltheussl, due to Phil Steitz)
Unclear error message when `<currentVersion/>` in `project.xml` file not defined. (fix, MPXDOC-174, ltheussl)
Perform JSL transforms on xdocs only when they have changed. (add, MPXDOC-141, ltheussl, due to M. Sean Gilligan)
Add xdoc tag library documentation to the plugin site. (add, MPXDOC-169, ltheussl)
Fix `xdoc:validate`. (fix, MPXDOC-87, ltheussl)
One cannot call xdoc:copy-user-resources directly. (fix, MPXDOC-106, ltheussl, due to Jerome Lacoste)
Add support for more powered-by banners. (add, MPXDOC-126, ltheussl, due to Maarten Coene)
Support global theme. (add, MPXDOC-80, ltheussl, due to Joerg Schaible)
Add a navigation bar. (add, MPXDOC-24, ltheussl, due to Gilles Dodinet)
Add an optional id tag to sub/sections, so they can be referenced. (add, MPXDOC-158, ltheussl)
Add a property to override `navigation.xml`. (add, MPXDOC-144, ltheussl)
Show organization in header even if logo not set. (add, MPXDOC-127, ltheussl, due to Shinobu Kawai Yoshida)
Ampersands in navigation.xml being escaped twice. (fix, MPXDOC-47, ltheussl)
Ampersand in section/subsection not correct. (fix, MPXDOC-133, ltheussl)
Downloads report cannot be disabled for child projects. (fix, MPXDOC-104, ltheussl, due to Rafal Krzewski)

## 1.9.2 2005-09-05

Dependencies comment (MPXDOC-129) feature disappeared. (fix, MPXDOC-163, aheritier)
Special characters in menu ids aren't escaped. (fix, MPXDOC-162, aheritier, due to Lukas Theussl)
Add documentation about "external links" and "new windows". (fix, MPXDOC-156, aheritier, due to Jeff Jensen)
Xdoc plugin >= 1.9 not compatible with older customised site.jsl. (fix, MPXDOC-155, aheritier, due to Lukas Theussl)
System locale setting makes test cases fail. (fix, MPXDOC-154, aheritier, due to Juan F. Codagnone,Vincent Siveton,Lukas Theussl)
cvs-usage link not shown in project-info page (fix, MPXDOC-152, vsiveton, due to Arnaud Heritier)
i18n : menu tag in xdoc does not work with "key" translated text id. (fix, MPXDOC-151, aheritier)
maven.xdoc.date.format does not seem to have any effect. (fix, MPXDOC-150, aheritier, due to Ignacio G. Mac Dowell)
<DT> is appearing same way as subsection. Fix layout for the FAQ plugin. (fix, MPXDOC-149, aheritier, due to Lukas Theussl)
Fixed bundles expression. (fix, MPXDOC-148, vsiveton, due to Incze Lajos)
Missing "Project Reports" header in the generated menu. (fix, MPXDOC-147, aheritier)
Allow i18n links. (add, MPXDOC-131, aheritier, due to Ignacio G. Mac Dowell)
i18n : html code removed from bundles. (fix, aheritier)
i18n : doc title wasn't printed in breadcrumbs. (fix, aheritier)
breadcrumbs : add a link to the site on the project name. (update, aheritier)

## 1.9.1 2005-06-16

Don't override the Maven library. This makes the plugin compatible with both Maven 1.0.2 and Maven 1.1 (fix, brett)

## 1.9 2005-06-09

Fix cvs usage entry in "project Info" menu. Add it if the repository element is defined in the pom (and not if the URL of the repository is defined). (fix, aheritier)
Added internationalization support. (add, MPXDOC-128, brett, due to Vincent Siveton)
NullPointerException with optionals pom items missing. (fix, MPXDOC-136, aheritier, due to Vincent Siveton)
A link starting with https wasn't considered as an external link. (fix, MPXDOC-132, aheritier, due to Ignacio G. Mac Dowell)
Add a `comment`property for dependencies (add, MPXDOC-129, felipeal, due to Miguel Griffa)
Added maven.xdoc.copy.excludes property which lists the files to exclude from the resources copy. This defaults to any images currently unused by Maven. Additionally, if you are not using the classic theme, maven.xdoc.copy.excludes.classic is used to eliminate images only for the classic theme (add, brett)
Added new tag `<escapeXml>`. (add, MPXDOC-118, felipeal)
Maven xdoc plugin clean up generated velocity log as part of calling clean. (add, MPXDOC-124, epugh, due to Shinobu Kawai)
New property (maven.xdoc.xml.copy) to copy only and not transform some xml files provided in the ${maven.docs.src} directory. (add, MPXDOC-123, aheritier)
Make compatible with Maven 1.1 (update, brett)
Show version if maven.xdoc.date=right (fix, MPXDOC-117, aheritier, due to Dennis Lundberg)
Allow header images and links to use relative paths (fix, MPXDOC-115, aheritier, due to Brent Worden)
Added dt css style (add, MPFAQ-11, carlos)
Add a legend for the symbols in the xdoc, disabled by setting `maven.xdoc.legend=false` (add, brett)
Add a support for "hierarchical" site navigation in breadcrumbs (add, michal)

## 1.8 2004-07-10

Add an externalLink attribute to a report to use if link is not present (add, brett)
Added a link to the release notes in the download report. Note that this link is only created if the project has a `xdocs/changes.xml`file. (add, vmassol)
Add instructions to checkout with maven to cvs-usage page (add, MPXDOC-112, carlos)

## 1.7.2 2004-06-25

Correct ampersand handling in hrefs. (fix, MPXDOC-92, brett)
Build and run plugin against the installed version of Maven (fix, brett)

## 1.7.1 2004-05-19

Fix bad target in links generated in reports overview page. (fix, MPXDOC-102, aheritier, due to Rafal Krzewski)

## 1.7 2004-05-12

- Items in navigation.xml and reports can define a target attribute.
- Items in links can use an img attribute to create an icon.
- New CSS class named "externalLink" used for links with an url beginning with 'http://'.
- New CSS class named "newWindow" used for links with target='_blank'.

(add, MPXDOC-97, aheritier, due to Fabrizio Giustina, Harald Ommang)
Exclude .fml files from copy to target directory (fix, brett)
Add a "classic" theme CSS (add, brett)
Added new download report along with a new link in the Maven generated documentation. This new link will only appear if you have defined the new `maven.xdoc.distributionUrl`property. There is also a new `maven.xdoc.distributionType`property that indicates what type of artifact your project is delivering. It defaults to "jar". (add, vmassol)
The xdoc plugin now supports generating custom reports using Jelly. It was previously only supporting Velocity. Simply name your report templates with a ".jelly" extension. (add, vmassol)
Allow reports to be generated even if they aren't linked from the "project reports" section by giving an empty link attribute to the register report tag. (fix, MPXDOC-98, brett, due to fabrizio giustina)
Only show "CVS Access Behind a Firewall" section if using CVS. (fix, MPXDOC-90, brett, due to Corey Tripp)
wrong lists generated for not expandable menu items. Some changes in patch were already put in place by brett. (fix, MPXDOC-96, brett, due to fabrizio giustina)
Fix issues with DOM classes and jdk1.3 (fix, dion)
jslToSite fix, escapeNameTokens improvement (fix, MPXDOC-95, brett, due to fabrizio giustina)
make anchor tags not wrap text, but sit in front of it (fix, MPXDOC-63, brett)
indent nested menus in navigation (fix, MPXDOC-78, brett, due to Chad McHenry)
remove changes-report.xml which was generating over the top of the actual report. This information already exists in the changes plugin documentation. (fix, brett)
fix processing of a href links (fix, MPXDOC-82, brett)
fix URI problems (fix, MPXDOC-84, brett)
html tags not passed through for source and pre tags (fix, MPXDOC-89, dion)

## 1.6 2004-03-10

Fix google search form flow issues (fix, dion)

## 1.5 2004-02-03

- generated site is valid tableless XHTML with a fully css layout.
- Html elements are now used properly: link lists are ul, titles are h1, h2, etc.
- invalid html produced for sections "name" elements is now fixed, escaping unvalid chars (replaced by "_").
- Hrefs for local links (starting with "#") are fixed accordingly during transformation
- whitespace in output has been dramatically reduced (only preserved in sensitive elements such as pre, script, style
- fixes layout during loading in internet explorer: empty images in the nav bar are popping up with the default blue border and text is initially unstyled.
- No empty images are used anymore ("handles" for nav bar are created using css)
- xdoc:copy-user-resources also copies resource from maven.gen.docs and not only from maven.docs.src: this allows for reporting plugins to generate images without copying them directly to maven.docs.dest
- users can add links _after_ the standard project info/project reports section setting the "type" attribute to "footer" for the menu element ($nav/body/menu[@type='footer'])
- development process URL is not included if maven.xdoc.developmentProcessUrl is empty
- xhtml fix: missing "alt" attribute for images (required in xhtml) is added automatically

(fix, MPXDOC-77, dion)
Remove the need for ${pom} interpolation in properties. The use of the maven:property tag is now used to glean a default property. (update, jvanzyl)
Removed unneeded ant and grant dependencies. (update, dion)
Document maven.xdoc.jsl. (fix, MAVEN-965, dion)
Evenly space breadcrumbs, customize separator. (fix, MAVEN-966, dion)
Better timezone calcs. (fix, MAVEN-962, dion)
Bad docs entries for maven.docs.dest and maven.gen.docs. (fix, MAVEN-961, dion)
Add details on date format. (fix, MAVEN-964, dion)
Fix excess whitespace. (fix, MAVEN-940, dion)
Fixed empty scm repository and issue tracking URL still being added to the project navigation. (fix, dion)

## 1.4 2003-09-29

cvs-usage.xml breaks on non-cvs scm URL (fix, MAVEN-756, dion)
Move xdoc faqs over from the wiki (update, dion)
update to commons-jelly-20030902.160215 (update, dion)
Move maven.docs.* and maven.gen.docs to defaults.properties instead of xdoc plugin (fix, dion)
Fix the broken build if repository/connection is not present. (fix, MAVEN-698, evenisse)
Fixed bug where top level xdocs were using xdocs/navigation.xml instead of the generated one when it was available. (fix, dion)
Dependency report was completely rewritten. Report generator is now aware of notion of type and groupId. In addition URL and Description (which was also added to the report) of the dependency can be taken from the POM if there is one in the local repository (update, michal)
Documentation of goals ported to new dedicated format (fix, michal)
update to maven 1.0-beta-10 (update, dion)
update to velocity 1.4-dev (update, dion)
Upgrade to dom4j 1.4 (update, dion)
Add xml declaration to generated report. Fixed for character encoding. (fix, evenisse)
Added the google search on navbar (fix, MAVEN-554, dion, due to Tim Anderson)
remove the space in anchors. (fix, MAVEN-322, evenisse, due to Paulo Silveira)
suppress highlight on hover on mozilla on named anchors. (fix, MAVEN-419, evenisse, due to Mark Wilkinson)

## 1.3 Unknown

target encoding can be set for files generated from POM. (add, MAVEN-383, michal, due to Kuisong Tong)
Added a target to validate the navigation.xml files from the schema (add, dion)
Added Cactus reports to Project Reports (add, vmassol)
Added new `$gen-xdocs`variable in the Velocity context used to generate the templates files. It points to the location where generated xdocs are located. (add, vmassol)
Added maven.xdoc.development-process-url properties. (update, evenisse)
Added Javadoc report to Project Reports (add, dion)
Fix table widths of changelog and changes reports (fix, dion)
Fix for Maven-124, the navbar was out of sync with maven-reports.xml (fix, dion)

## 1.2 2002-10-01

Created link with development process page if development-process.xml exist in xdocs directory, otherwise a link with development process page on Maven site. (update, evenisse)
Added documentation for the new changes report. (add, dion)
Added the new changes report. (add, vmassol)
Added an id column for committers on the team-list page. (add, vmassol)