Bug 105685 - [doc] jnlp doc improvement
Summary: [doc] jnlp doc improvement
Status: CLOSED WONTFIX
Alias: None
Product: Platform
Classification: Eclipse Project
Component: Runtime (show other bugs)
Version: 3.1   Edit
Hardware: Macintosh All
: P3 normal (vote)
Target Milestone: ---   Edit
Assignee: platform-runtime-inbox CLA
QA Contact:
URL:
Whiteboard: stalebug
Keywords: Documentation
Depends on:
Blocks:
 
Reported: 2005-08-01 13:04 EDT by Pascal Rapicault CLA
Modified: 2021-11-22 12:32 EST (History)
0 users

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Pascal Rapicault CLA 2005-08-01 13:04:17 EDT
This is a post from the newsgroup. It suggests some improvements to the doc for jnlp.
===========

First of all, THANK YOU to Pascal for writing the new Java Web Start  documentation for Eclipse 3.1RC3. 
It helps to have all the concepts tied  together like this.

However, I do have some constructive feedback for the documentation. Is  this newsgroup the most 
effective way to send comments, or would it be  more appropriate to post the comments in Bugzilla Bug 
94141?

Either way, I guess it won't hurt to post them to the newsgroup. Here goes:

In Step 1:
* Is "wrappering" the correct word in this context?  Would "wrapper" be  more concise?
* The instructions say: "Create a feature including all the features that  are listed in your product 
definition."  Does this refer to just the  plug-ins that are unique to our product, or all the dependencies 
as well?
* The instructions say: "Copy in a folder of your feature the  startup.jar."  Does this mean: "Copy the 
startup.jar file into your  feature's folder"?
* When we add the "root=" line to build.properties, should we specify the  absolute path, or the relative 
path?  If relative, should the folder just  be "." (dot)?

In Step 2:
* At the phrase "You need to use keytool", you may wish to add a hyperlink  to  http://java.sun.com/
j2se/1.5.0/docs/guide/javaws/developersguide/development.html#signing  which provides an 
excellent overview of how to use keytool.
* "File > Export > Features" should be "File > Export > Deployable  Features"

In Step 3:
* No questions.

In the section "Plug-ins based application"
* This section is very confusing to me (maybe it's just me!).  I thought  _all_ of the instructions thus far 
were specifically for plugin-based  (RCP) applications.  Why a separate section for it?  Weren't we told to  
create a wrappering feature in Step 1?  Are we supposed to create a second  wrappering feature, 
different from the first?  Any additional words of  clarification for this section would be very 
appreciated.

In general:
* Every occurrence of the word "than" in the document can be safely  replaced with "as".

I hope this helps for RC4 and beyond!  Please let me know if you have any  questions or want 
clarification on any of my comments herein posted.

Thanks,
Geoff
Comment 1 Pascal Rapicault CLA 2006-06-01 17:28:42 EDT
I could not get to it for 3.2, changing milestone.
Comment 2 Eclipse Webmaster CLA 2019-09-06 16:16:54 EDT
This bug hasn't had any activity in quite some time. Maybe the problem got resolved, was a duplicate of something else, or became less pressing for some reason - or maybe it's still relevant but just hasn't been looked at yet.

If you have further information on the current state of the bug, please add it. The information can be, for example, that the problem still occurs, that you still want the feature, that more information is needed, or that the bug is (for whatever reason) no longer relevant.
Comment 3 Eclipse Genie CLA 2021-11-22 12:32:49 EST
This bug hasn't had any activity in quite some time. Maybe the problem got resolved, was a duplicate of something else, or became less pressing for some reason - or maybe it's still relevant but just hasn't been looked at yet. As such, we're closing this bug.

If you have further information on the current state of the bug, please add it and reopen this bug. The information can be, for example, that the problem still occurs, that you still want the feature, that more information is needed, or that the bug is (for whatever reason) no longer relevant.

--
The automated Eclipse Genie.