commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Matt Benson <>
Subject Re: [jxpath/all] Maven site help
Date Fri, 03 Aug 2007 17:56:12 GMT

--- Niall Pemberton <> wrote:

> On 8/3/07, Matt Benson <> wrote:
> >   Though I am an avid reader of fantasy fiction, I
> > don't think magic has much place in the realm of
> > software development.  For this reason I
> despair--and
> > I say this in awareness that I may offend some
> > folks--whenever I am forced to work with Maven.  I
> can
> > never figure out what's going on, and any
> > documentation I find doesn't tell me what I need
> to
> > know, at least (to be fair) not in such a way that
> I
> > recognize the datum that will help me when I see
> it.
> >
> >   From this perspective, will someone please
> recommend
> > a resource that will tell me in no uncertain terms
> > is going on with a Maven site and/or particularly
> your
> > "average" Apache Commons site?  I want to bring
> the
> > JXPath site more in line with e.g. IO/Lang for the
> 1.3
> > release but am at a loss to determine how to
> invoke
> > some of the black magic necessary to accomplish
> this.
> Not quite sure what you want - JXPath site doesn't
> look that out of
> line with what lang/io look like. You only have a
> maven1 build ATM -
> if you're happy to stick with that then the file
> that controls the
> menu is xdocs/navigation.xml - all the other xml
> files in the xdocs
> directory get converted to html pages - so if you
> create a
> xdocs/foo.xml - it will generate a foo.html page and
> you can add menu
> reference to foo.html in your navigation.xml to put
> a link on the
> menu.
> If you want to use maven2 - then you need some other
> bits (which I'm
> happy to help with if you want).
> Perhaps you could be more specific about what
> your're trying to achieve though.

I hadn't wanted to get too specific because I thought
it would be more valuable for me to find the
resource(s) that would enlighten me in a general way. 
In this particular case I have just now been able to
find the answer to a problem by comparing files; this led to my discovery of
the maven.xdoc.includeProjectDocumentation property. 
After having found this I was able to Google for it
and find the part of the Maven 1.x xdoc plugin
documentation that describes it.  I had already been
to the plugin's docs and failed to recognize its
properties link as belonging to the plugin itself.  So
maybe part of my problem is unfamiliarity with the
manual.  I guess I will present future issues on a
case-by-case basis.


> Niall
> > Thanks,
> > Matt
> To unsubscribe, e-mail:
> For additional commands, e-mail:

Boardwalk for $500? In 2007? Ha! Play Monopoly Here and Now (it's updated for today's economy)
at Yahoo! Games.  

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message