You are viewing a plain text version of this content. The canonical link for it is here.
Posted to batik-users@xmlgraphics.apache.org by Alan Deikman <Al...@znyx.com> on 2009/03/31 20:33:24 UTC

javadoc links to w3.org broken?

I have noticed that in the javadoc that comes with Batik, all the links 
to www.w3.org are broken.   Is there a plan to fix this?  

Also, so far I haven't found where they are supposed to be pointing to.

-- 
Alan Deikman



---------------------------------------------------------------------
To unsubscribe, e-mail: batik-users-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: batik-users-help@xmlgraphics.apache.org


Re: javadoc links to w3.org broken?

Posted by Cameron McCormack <ca...@mcc.id.au>.
Cameron McCormack:
> > I’ll try republishing the javadoc with the above changes right now.

Alan Deikman:
> Where can that be downloaded?   I don't see it at the main page.

You can view the javadocs at:

  http://xmlgraphics.apache.org/batik/javadoc/

There’s no downloadable ZIP file of nightly builds of the javadocs.
You’ll need to check out the sources from svn and build the javadocs
yourself if you want them on your machine.

-- 
Cameron McCormack ≝ http://mcc.id.au/

---------------------------------------------------------------------
To unsubscribe, e-mail: batik-users-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: batik-users-help@xmlgraphics.apache.org


Re: javadoc links to w3.org broken?

Posted by Alan Deikman <Al...@znyx.com>.
Cameron McCormack wrote:
> I’ll try republishing the javadoc with the above changes right now.
>   
Where can that be downloaded?   I don't see it at the main page.

-- 
Alan Deikman



---------------------------------------------------------------------
To unsubscribe, e-mail: batik-users-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: batik-users-help@xmlgraphics.apache.org


Re: javadoc links to w3.org broken?

Posted by Cameron McCormack <ca...@mcc.id.au>.
Hi Alan, Helder.

Alan Deikman:
> > I have noticed that in the javadoc that comes with Batik, all the links to
> > www.w3.org are broken.   Is there a plan to fix this?

Helder Magalhães:
> Not all, at least some [1] seem to be working. ;-)
> 
> The DOM package [2] seems to be missing the whole SVG subtree, though...

Since removing the org.w3c.dom.svg interfaces from the Batik source
tree, and instead referencing xml-apis-ext.jar from Apache XML Commons,
there haven’t been links to those interfaces.  I tried to get the
Javadoc published somewhere on www.w3.org, just like the DOM Level 2
ones are, but to no avail yet.  When SVG 1.1 Second Edition is published
(within a couple of months, I expect), hopefully the Javadocs will be
published too, and we can get the Batik ones to link to w3.org.

> As we're at it (speaking of JavaDoc):
>  * The footer [3] seems to be corrupted (probably the copyright
> character is being used directly, whereas the HTML entity (&copy;)
> should probably be used instead;

The character is specified as &#169; in build.xml.  I guess it is an
encoding issue somewhere, but not sure where.  I’ll try using the
-docencoding option to the javadoc tool to ensure that the output is
UTF-8.

>  * The footer could hold a link to the ASF homepage [5] (something
> like '<a href="http://www.apache.org/">Apache Software
> Foundation</a>').

That should be easy enough to do.

> Should these minor changes be put in a patch?

I’ll try republishing the javadoc with the above changes right now.

-- 
Cameron McCormack ≝ http://mcc.id.au/

---------------------------------------------------------------------
To unsubscribe, e-mail: batik-users-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: batik-users-help@xmlgraphics.apache.org


Re: javadoc links to w3.org broken?

Posted by Helder Magalhães <he...@gmail.com>.
Hi Alan,


> I have noticed that in the javadoc that comes with Batik, all the links to
> www.w3.org are broken.   Is there a plan to fix this?

Not all, at least some [1] seem to be working. ;-)

The DOM package [2] seems to be missing the whole SVG subtree, though...


> Also, so far I haven't found where they are supposed to be pointing to.

According to a previous thread in the mailing list [3], Cameron
intended to do something about this: are there any updates?


As we're at it (speaking of JavaDoc):
 * The footer [3] seems to be corrupted (probably the copyright
character is being used directly, whereas the HTML entity (&copy;)
should probably be used instead;
 * The footer could hold a link to the ASF homepage [5] (something
like '<a href="http://www.apache.org/">Apache Software
Foundation</a>').

Should these minor changes be put in a patch?


Regards,
 Helder


[1] http://xmlgraphics.apache.org/batik/javadoc/org/apache/batik/dom/package-summary.html
[2] http://www.w3.org/2003/01/dom2-javadoc/org/w3c/dom/
[3] http://www.nabble.com/introducing-myself%2C-and-a-few-questions-ts12286928.html#a12326387
[4] Copyright ? 2008 Apache Software Foundation. All Rights Reserved.
[5] http://www.apache.org/

---------------------------------------------------------------------
To unsubscribe, e-mail: batik-users-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: batik-users-help@xmlgraphics.apache.org