cxf-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Robert Liguori (JIRA)" <j...@apache.org>
Subject [jira] Updated: (CXF-3055) Refining help page for utilities, as well as expanding (adding) switches where necessary
Date Wed, 12 Jan 2011 18:06:46 GMT

     [ https://issues.apache.org/jira/browse/CXF-3055?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]

Robert Liguori updated CXF-3055:
--------------------------------

    Comment: was deleted

(was: Apache CXF 2.3.0 Command Usages Documentation and Implementation Analysis
This attached document identifies that there are currently three separately defined usage
representations for the Apache CXF tools.  Ideally, all resources should be identical, and
the source help (ie. file -h) needs to be accurate.  Also, there is the GNU standard, where
if implemented correctly would encourage improvement/refinements to the options (i.e. -h and
--help vs. -h and -help).  The GNU standard is listed at the end of each command section in
the document to emphasize the importance of using this standard or a similar one in establishing
the usage of commands (at least, in my opinion). 
)

> Refining help page for utilities, as well as expanding (adding) switches where necessary
> ----------------------------------------------------------------------------------------
>
>                 Key: CXF-3055
>                 URL: https://issues.apache.org/jira/browse/CXF-3055
>             Project: CXF
>          Issue Type: Improvement
>          Components: Tooling
>    Affects Versions: 2.3.0
>            Reporter: Robert Liguori
>            Priority: Minor
>         Attachments: usages_of_cxf_commands.doc
>
>   Original Estimate: 4h
>  Remaining Estimate: 4h
>
> Consider the "JavaToWS.java" file of the java2ws utility...
> For this utility:
> -V and -verbose are added in the associated file as valid switches, however, only -verbose
is shown in the java2ws help (java2ws -h).
> Consider adding "-V" to the help page of the java2ws utility.
> Also, consider adding the following (below) to the help and general functionality of
scripts (i.e., wsdl2java, wsdl2js, java2js, java2ws, xsd2wsdl, wsdl2java, wsdl2soap, wsdl2corba,
wsdl2service, wsdlvalidator), WHERE APPLICABLE:
> -h, --help 
> -v, --version
> -V, --verbose
> -q, --quiet
> Reference: http://www.gnu.org/prep/standards/standards.html#Command_002dLine-Interfaces

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


Mime
View raw message