Bug 255895 - [javadoc] Javadoc Location for library JAR cannot be a workspace folder
Summary: [javadoc] Javadoc Location for library JAR cannot be a workspace folder
Status: NEW
Alias: None
Product: JDT
Classification: Eclipse Project
Component: Core (show other bugs)
Version: 3.4   Edit
Hardware: PC Linux
: P3 enhancement (vote)
Target Milestone: ---   Edit
Assignee: JDT-Core-Inbox CLA
QA Contact:
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2008-11-19 15:49 EST by Chris Conway CLA
Modified: 2008-11-20 05:52 EST (History)
0 users

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Chris Conway CLA 2008-11-19 15:49:49 EST 
I have the documentation for a library accessible as a linked folder (with the value attached to a path variable) within a project. I want to associate the JAR file with the documentation directory, but the options for Javadoc Location in the file Properties are: (1) a directory URL, or (2) a JAR/ZIP file (either external or within the workspace. There is no way to specify a directory within the workspace.

Using a file:// URL with an absolute pathname would defeat the purpose of the linked folder. Perhaps there are "workspace URLs" (the example URL "file:/c:/myworkspace/myproject/doc" would seem to imply otherwise), but the UI provides no way for the user to build one by browsing the workspace.

There's no user-visible reason there should be any distinction between a folder and an archive for the purposes of attaching documentation to a library.
Comment 1 Jerome Lanneluc CLA 2008-11-20 05:52:13 EST 
Indeed we don't support workspace relative URLs for javadoc.