United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
Bug ID: 5036373 Tool doc for 'java' should document Windows-specific command arg processing
5036373 : Tool doc for 'java' should document Windows-specific command arg processing

Details
Type:
Enhancement
Submit Date:
2004-04-22
Status:
Open
Updated Date:
2013-02-20
Project Name:
JDK
Resolved Date:
Component:
docs
OS:
windows_2000
Sub-Component:
guides
CPU:
x86
Priority:
P4
Resolution:
Unresolved
Affected Versions:
1.4.2
Targeted Versions:
8

Related Reports
Relates:
Relates:
Relates:
Relates:

Sub Tasks

Description
Name: rmT116609			Date: 04/22/2004


A DESCRIPTION OF THE PROBLEM :
On Windows, the JRE does clever things with the command-line arguments passed
to the Java application.  For example,

      java some.class *.java

will do wildcard expansion on "*.java", and call the Java app's 'main' method
with a list of file names.

The problem is that this is not documented ... at least not in the obvious place.

EXPECTED VERSUS ACTUAL BEHAVIOR :
EXPECTED -
A description of how the 'java' command on Windows preprocesses the command
line arguments before they are passed to the Java app's main method.

The following should be covered:

  1)  the wildcard characters supported, and what they mean
  2)  any restrictions on wildcarding
  3)  how quotes are handled; e.g. handling mismatched quotes, quote stripping,
       inhibition of wildcarding within quotes.
  4)  any other mechanisms that modifiy the "java" command's handling of args
       in the Windows context.

URL OF FAULTY DOCUMENTATION :
http://java.sun.com/j2se/1.4.2/docs/tooldocs/windows/java.html
(Incident Review ID: 233540) 
======================================================================

                                    

Comments
EVALUATION

Perhaps we can mention that the java command on Windows preprocesses the command
line arguments before they are passed to the Java app's main method.
If necessary, someone with a Windows system would need to research this.
Assigning to you, Doug, to say if we should document or not.
###@###.### 2004-04-23
                                     
2004-04-23



Hardware and Software, Engineered to Work Together