# commons-dev mailing list archives

##### Site index · List index
Message view
Top
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.
--
Blog:      http://www.freeroller.net/page/dion/Weblog

"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
> >
> >
> > 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,
> > > 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
> > > down to zero errors a condition for a release.
> > >
> > > ( Question, so why doesn't codec have a zero length linkcheck?  I
> > > 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