The following issue has been updated:
Updater: Martin Skopp (mailto:[EMAIL PROTECTED])
Date: Fri, 22 Aug 2003 3:30 AM
Comment:
First of all: The "Attach File" option was no longer available after my first file
upload!!! I had to cheat JIRA a little to manage this second upload...
Ok, here's my second patch.
a) it respects a new property maven.javadoc.mode.online,
b) fixes offline mode not working (you missed to remove lines 80-86, dion)
c) add documentation on new property
Patch was generated by "cvs diff -wu" from directory src/plugins-build/javadoc. Hope
the patch works this time. If one likes to have the full file, send a short mail.
Changes:
Attachment changed to src_plugins-build_javadoc.patch
---------------------------------------------------------------------
For a full history of the issue, see:
http://jira.codehaus.org/secure/ViewIssue.jspa?key=MAVEN-694&page=history
---------------------------------------------------------------------
View the issue:
http://jira.codehaus.org/secure/ViewIssue.jspa?key=MAVEN-694
Here is an overview of the issue:
---------------------------------------------------------------------
Key: MAVEN-694
Summary: add offline javadoc generation
Type: Improvement
Status: Closed
Priority: Major
Resolution: FIXED
Time Spent: Unknown
Remaining: 2 hours
Project: maven
Components:
plugin-javadoc
Fix Fors:
1.1
Versions:
1.0-beta-10
maven-new-unreleased
1.0-final
1.0-rc1
1.1
Assignee:
Reporter: Martin Skopp
Created: Tue, 19 Aug 2003 2:30 AM
Updated: Fri, 22 Aug 2003 3:30 AM
Environment: all
Description:
I am willing to assist but have no commit rights.
So if a committer takes this issue, feel free to contact me to split work...
This feature request splits into several parts, see also Thread "About Javadoc links"
@maven-user.
i) Add "javadoc -linkoffline" usage
=================================
Extends javadoc plugin to respect a new property "maven.javadoc.offlineLinks" when in
offline mode (maven.mode.online=false).
ii) Add option to generate offline javadoc even when online
===========================================================
Could be extremely useful for users behind a proxy (see Simons post) OR laptop users
which work online in the office, but like to generate all javadoc API with OFFLINE
links, since they frequently travel and have all the APIs on their own harddrive - so
they want to have OFFLINE links instead of ONLINE links.
I suggest a new property
maven.javadoc.mode.online=false|true
with default value =maven.mode.online !
Martin Skopp <[EMAIL PROTECTED]>
Original posts for your reference:
------------------------------------------------
Paul Libbrecht <[EMAIL PROTECTED]>
Date:? Wed, 13 Aug 2003 11:31:10 +0200
I realized however that it would be good if a user could override such a
link-offline/link-online for each packages. The reason is that a local javadoc is
quite often available and it makes lots of sense for a javadoc to actually get linked
to other local javadocs.
Could there be properties such as:
maven.javadoc-plugin.links.<projectName>.url =
maven.javadoc-plugin.links.<projectName>.offlineUrl =
This way, people only interested into building their snapshot of a
javadoc of a local project could do so in user-level properties...
------------------------------------------------
Martin Skopp <[EMAIL PROTECTED]>:
There's already this "maven.javadoc.links" property where you specify
the link-ONLINE urls, packages seperated by comma.
Sad thing is that the javadoc plugins ignores the link-ONLINE completely
when in offline mode:
--- SNIP ---
??????? <j:when test="${maven.mode.online}"/>
??????? <j:otherwise>
????????? <j:set var="maven.javadoc.links" value=""/>
??????? </j:otherwise>
--- SNIP ---
IMHO a property "maven.javadoc.offlineLinks" could be helpful.? And the javadoc plugin
needs to respect it...
Offline javadoc links could be VERY helpful, e.g. when you travel with
your laptop and you like to read the API doc...
------------------------------------------------
Simon Matic Langford <[EMAIL PROTECTED]>
we'd actually like to do the offline links even when online, as javadoc can't go
through a proxy.
Good idea, that would make one additional property
javadoc.mode.online=false...
---------------------------------------------------------------------
JIRA INFORMATION:
This message is automatically generated by JIRA.
If you think it was sent incorrectly contact one of the administrators:
http://jira.codehaus.org/secure/Administrators.jspa
If you want more information on JIRA, or have a bug to report see:
http://www.atlassian.com/software/jira
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
