commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From d...@multitask.com.au
Subject Re: [math] documentation principles
Date Sat, 17 May 2003 12:15:24 GMT
Tables are a known problem, but the PDF gen should work still....which 
maven version is this?

It works ok for me on 1.0-beta-10-SNAPSHOT.
--
dIon Gillard, Multitask Consulting
Blog:      http://www.freeroller.net/page/dion/Weblog
Work:      http://www.multitask.com.au


"Juozas Baliuka" <baliuka@centras.lt> wrote on 17/05/2003 05:05:40 PM:

> 
> Yes, it has pdf target, but I do not think it works:
> 
> xdoc:init:
> 
> pdf:init:
> 
> fo:fo:
>     [echo] Generating C:\home\voruta/target/docs/project.fo ...
>     [java]
>     [java] (Location of error unknown)XSLT Error
> (javax.xml.transform.Transforme
> rConfigurationException): javax.xml.transform.TransformerException:
> java.net.Unk
> nownHostException: C
> 
> BUILD FAILED
> Java returned: -1
> Total time:  14 seconds
> 
> It seems it tries to parse filename as URL.
>  I saw some pdfs generated by maven, possible it works on linux,
> but all generated docs are without tables.
> 
> 
> > Tim,
> >
> > fwiw, Maven also has a facility to convert xdoc to PDF.
> > --
> > dIon Gillard, Multitask Consulting
> > Blog:      http://www.freeroller.net/page/dion/Weblog
> > Work:      http://www.multitask.com.au
> >
> >
> > tobrien@transolutions.net (O'brien, Tim) wrote on 17/05/2003 04:13:00 
AM:
> >
> > > On Fri, 2003-05-16 at 13:00, Phil Steitz wrote:
> > > > --- robert burrell donkin
> > > > <robertburrelldonkin@blueyonder.co.uk> wrote:
> > >
> > > > > On Thursday, May 15, 2003, at 10:34 PM, Phil Steitz
> > > > We can look into this as we get further along.  For
> > > > now, I assume it is OK to add links to external
> > > > sources as appropriate in the javadoc.
> > >
> > > Not to sound like a Maven partisan, but linkcheck is integrated as a
> > > Maven report, 
http://jakarta.apache.org/commons/codec/linkcheck.html.  I
> > > think it is fine to add references to external documentation as long 
as
> > > we make sure that our links are working - i.e. make getting 
linkcheck
> > > down to zero errors a condition for a release.
> > >
> > > ( Question, so why doesn't codec have a zero length linkcheck?  I 
plead
> > > guilty. )
> > >
> > > > Here again, something to think about as we get further
> > > > along. One last point before letting this drop (for
> > > > now).  Mathematical documentation in HTML is painful,
> > > > trying to embed it in javadoc is cruel and unusual
> > > > punishment. This is another reason to externalize the
> > > > user's guide.  The eventual user's guide will need to
> > > > include images and/or possibly be distributed as pdf,
> > > > tex, or postcript.  Probably should not have just
> > > > opened up that can of worms...Something to think about
> > > > down the road.
> > >
> > > I remember that Forrest has a nice little feature of converting your
> > > xdoc to PDF - click on the PDF link on http://xml.apache.org. 
Although
> > > it seems a little twisted, we could use Maven for site generation, 
and
> > > Forrest for documentation - unless I'm missing some Maven plugin 
that
> > > generates PDF output.
> > >
> > >
> > >
> > >
> > > 
---------------------------------------------------------------------
> > > To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> > > For additional commands, e-mail: commons-dev-help@jakarta.apache.org
> > >
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> > For additional commands, e-mail: commons-dev-help@jakarta.apache.org
> >
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: commons-dev-help@jakarta.apache.org
> 


---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Mime
View raw message