This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 62090 - Broken links in javadoc
Summary: Broken links in javadoc
Status: VERIFIED FIXED
Alias: None
Product: java
Classification: Unclassified
Component: Unsupported (show other bugs)
Version: 5.x
Hardware: All All
: P2 blocker (vote)
Assignee: Martin Matula
URL:
Keywords:
Depends on:
Blocks: 62058
  Show dependency tree
 
Reported: 2005-08-10 16:39 UTC by Marian Mirilovic
Modified: 2005-09-05 10:05 UTC (History)
0 users

See Also:
Issue Type: DEFECT
Exception Reporter:


Attachments
broken links (1.25 KB, text/plain)
2005-08-10 16:39 UTC, Marian Mirilovic
Details

Note You need to log in before you can comment on or make changes to this bug.
Description Marian Mirilovic 2005-08-10 16:39:33 UTC
Please fix broken links in javadoc (see attachment - sources from sources
09/08/2005 ).
For more details see issue 62058.
Comment 1 Marian Mirilovic 2005-08-10 16:39:49 UTC
Created attachment 23675 [details]
broken links
Comment 2 Martin Matula 2005-08-18 16:11:59 UTC
I'll look at it.
Comment 3 Martin Matula 2005-08-19 18:25:25 UTC
Seems to happen due to the fact that the javadoc infrastructure tries to be too
smart and automatically generates links to javadoc of modules that do not have
any (e.g. javax.jmi.reflect). I don't see this described anywhere. I don't know
how to fix this. Reassigning to nbbuild.
Comment 4 Jesse Glick 2005-08-19 22:03:05 UTC
Yarda's stylesheet. Generates


<tr class="tabler">
<td><a
name="java-javax.jmi.reflect">javax.jmi.reflect</a></td><td>Imported</td><td><a
href="http://openide.netbeans.org/tutorial/api-design.html#category-private">Private</a></td><td><a
href="@javax-jmi-reflect@/overview-summary.html">
                            .../overview-summary.html</a>
<p></p>
<p></p>
                The module is needed for compilation. 
            
                The module is used during runtime. 
                <p></p>
</td>
</tr>


For this case, it should skip the URL, or use an external URL such as

http://java.sun.com/products/jmi/jmi-1_0-fr-doc/overview-summary.html

But I don't know how to make it do this generally for all lib wrapper modules.
Comment 5 Jesse Glick 2005-08-19 22:05:25 UTC
*** Issue 62107 has been marked as a duplicate of this issue. ***
Comment 6 Jesse Glick 2005-08-19 22:07:34 UTC
*** Issue 62083 has been marked as a duplicate of this issue. ***
Comment 7 Jesse Glick 2005-08-19 22:09:53 UTC
*** Issue 62086 has been marked as a duplicate of this issue. ***
Comment 8 Jaroslav Tulach 2005-08-22 11:57:42 UTC
Guys you are right, the description of what to do with <defaultanswer/> was 
not available. I have just updated the docs:  
http://www.netbeans.org/source/browse/openide/www/tutorial/api.html?r1=1.48&r2=1.49  
So I believe there is a way to fix the problem on your side.  
  
I have a feeling (but I may be wrong) that there is nothing on side of the 
Arch ant task to do. How could I find out that a record in <project> is not in 
fact published on netbeans.org at the time of processing the one module? 
 
I am reassigning back to javadoc owner for now. 
Comment 9 Jesse Glick 2005-08-22 21:18:05 UTC
I'm the Javadoc owner? You wrote the stylesheet which is producing the bad
links. Maybe you can just hardcode a list of modules to not link to. Or to hack
{replaces,properties,links}.xml by manually adding entries like

<replacefilter token="@javax-jmi-reflect@"
value="http://java.sun.com/products/jmi/jmi-1_0-fr-doc"/>

Would that work?
Comment 10 Jaroslav Tulach 2005-08-23 15:37:07 UTC
Well, the owner was the owner of the module. I have not noticed it has been  
reassigned to nbbuild.  
  
Manually adding entries is good idea and probably possible fix, if you both 
think it is good idea, let's add them there. 
Comment 11 Martin Matula 2005-08-24 14:59:59 UTC
Fixed. (for mdrapi, refactoring, javacore, javamodel)

Checking in refactoring/arch/arch-refactoring.xml;
/cvs/refactoring/arch/arch-refactoring.xml,v  <--  arch-refactoring.xml
new revision: 1.20; previous revision: 1.19
done
Checking in java/javacore/arch/arch-javacore.xml;
/cvs/java/javacore/arch/arch-javacore.xml,v  <--  arch-javacore.xml
new revision: 1.23; previous revision: 1.22
done
Checking in java/javamodel/arch/arch-javamodel.xml;
/cvs/java/javamodel/arch/arch-javamodel.xml,v  <--  arch-javamodel.xml
new revision: 1.10; previous revision: 1.9
done
Checking in mdr/mdrapi/arch/arch-mdr.xml;
/cvs/mdr/mdrapi/arch/arch-mdr.xml,v  <--  arch-mdr.xml
new revision: 1.10; previous revision: 1.9
done
Comment 12 Marian Mirilovic 2005-08-26 12:33:46 UTC
verified in NB.dev(200508251800)