Le lundi 14 mai 2007 à 11:05 +0200, Claude Brisson a écrit :
> For instance (I'm a maven newbie), once I've got a pom.xml and I run mvn
> on it, what is supposed to happen? For now, it says:
> 
> Installing /home/claude/projects/velocity/dvsl/pom.xml
> to 
> /home/claude/.m2/repository/org/apache/dvsl/dvsl/1.0-BETA1/dvsl-1.0-BETA1.pom
> 
> Is that all we expect from it? Is there a page describing the whole
> maven/pom.xml standard process somewhere on apache?

Responding to myself after having digged a bit through mail archives...

I understand much better the function of the pom.xml. Among other
things, it is responsible for the deployment of the archive and the
site. /trunk/pom.xml should countain a version number labelized
"x.y-SNAPSHOT" and the released pom.xml should contain the actual
released version number. Ok. (btw, Anakia and Texen version in
trunk/pom.xml should now be 1.1-SNAPSHOT, I guess. Well, not a big
deal).

So now, coming to the docs generation. I know almost nothing about
mave-site-plugin, but as I understand it, this plugin is supposed to
take care of the xdocs. But those xdocs were never validated against
this plugin but rather with DVSL itself and it seems that there are
small differences that make maven unhappy.

Maybe we'll switch to DocBook one day but until then what I suggest is
to configure the pom.xml so that it calls "ant docs" to generate the
docs (using DVSL itself!). Is it feasible? Otherwise I'm afraid it'd be
rather tedious to try to tweak the xdocs to keep both DVSL and
maven-site-plugin happy, plus I don't have any experience with the
latter.

FYI, when I tried "mvn site" locally it more or less generated something
(after having downloaded tons of things, started three instances of
Velocity-1.4, issued some warnings, and finally hung...), but generated
files had a bad layout. Last lines were:

[INFO] Setting property: classpath.resource.loader.class => 
'org.codehaus.plexus.velocity.ContextClassLoaderResourceLoader'.
[INFO] Setting property: velocimacro.messages.on => 'false'.
[INFO] Setting property: resource.loader => 'classpath'.
[INFO] Setting property: resource.manager.logwhenfound => 'false'.
[INFO] [site:site]
[INFO] artifact org.apache.maven.skins:maven-default-skin: checking for updates 
from central
Downloading: 
http://repo1.maven.org/maven2/org/apache/maven/skins/maven-default-skin/1.0/maven-default-skin-1.0.jar
7K downloaded
[INFO] Skipped "Project License" report, file "license.html" already exists for 
the English version.
[ERROR] VM #displayTree: error : too few arguments to macro. Wanted 2 got 0
[ERROR] VM #menuItem: error : too few arguments to macro. Wanted 1 got 0
[INFO] Generate "Dependencies" report.
[INFO] Generate "Issue Tracking" report.
[INFO] Generate "Project Summary" report.
[INFO] Generate "Source Repository" report.
[INFO] Generate "Jira Report" report.
log4j:WARN No appenders could be found for logger 
(org.apache.commons.httpclient.HttpClient).
log4j:WARN Please initialize the log4j system properly.
[INFO] JIRA lives at: https://issues.apache.org/jira
[INFO] The JIRA URL https://issues.apache.org/jira/browse/DVSL doesn't include 
a pid, trying to extract it from JIRA.
[INFO] Successfully reached JIRA.
[INFO] Downloading 
https://issues.apache.org/jira/secure/IssueNavigator.jspa?view=rss&pid=12310670sorter/field=issuekey&sorter/order=ASC&tempMax=100&reset=true&decorator=none
[INFO] Downloading successful


  Claude



---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to