The following comment has been added to this issue:
Author: Simon Matic Langford
Created: Thu, 21 Aug 2003 1:09 PM
Body:
Martin,
(almost) looks fine.
i say almost, in that when you're behind an authentication proxy, maven will still go
through it, only javadoc won't. Thus, we run maven in online mode, but want the
javadoc to run in offline mode (as per my post)! what happened to the
javadoc.mode.online property? that would be perfect.
other than that it looks great :-)
simon
---------------------------------------------------------------------
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: Unassigned
Priority: Major
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: Thu, 21 Aug 2003 12:04 PM
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]
