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 31549 - Support cross-API links when browsing offline
Summary: Support cross-API links when browsing offline
Status: RESOLVED FIXED
Alias: None
Product: apisupport
Classification: Unclassified
Component: API docs (show other bugs)
Version: 3.x
Hardware: All All
: P4 blocker (vote)
Assignee: Jaroslav Tulach
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2003-02-27 20:09 UTC by Jesse Glick
Modified: 2005-09-05 09:51 UTC (History)
1 user (show)

See Also:
Issue Type: ENHANCEMENT
Exception Reporter:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Jesse Glick 2003-02-27 20:09:19 UTC
Currently links between APIs refer to the
http://www.netbeans.org/download/dev/javadoc/
website. This is fine when browsing them online to
begin with, but annoying when browsing them
offline (from within NB using the
apisupport/apidocs module). Possibilities:

1. Have apisupport/apidocs register a URLMapper to
convert URLs with the prefix
http://www.netbeans.org/download/dev/javadoc/ to
the proper nbfs: URLs. Problems: (a) URLMapper
provides no URL -> URL facility. (b) Not at all
clear how to make this work w/ externalbrowser +
httpserver - would need to convert to and from
internal representation? Very ugly.

2. Make the javadoc module add an optional
URL-valued "mirror" to its javadoc DTD, indicating
what online prefix this doc set mirrors. Then in
its environment provider for the DTD, filter the
returned filesystem (MFS can be a filter) as
follows: for any file object whose content type is
text/html, override the length and input stream
methods to get the real content, then go through
the HTML and rewrite links. Any links (just <a
href="..."> I guess) which pointed to a URL with a
prefix in the mirror list of a mounted javadoc FS,
would be written to point to the file object in
that other FS (using URLMapper.EXTERNAL I guess).
This is a cleaner solution but probably more work.
Comment 1 Jesse Glick 2005-04-28 05:40:13 UTC
I think Yarda is working on this, somehow.
Comment 2 Jaroslav Tulach 2005-04-28 15:45:23 UTC
All javadocs now use relative links to refer to each other. So the support is  
there. We just need to verify that it is used correctly.