jira.codehaus.org

  • Log In Access more options
    • Online Help
    • Keyboard Shortcuts
    • About JIRA
    • JIRA Credits
    • What?s New
  • Dashboards Access more options (Alt+d)
  • Projects Access more options (Alt+p)
  • Issues Access more options (Alt+i)
  • uDIG
  • UDIG-1102

Startup should handle the most common arguments: -h --help / -v --version

  • Log In
  • Views
    • XML
    • Word
    • Printable

Details

  • Type: Improvement Improvement
  • Status: Reopened Reopened
  • Priority: Minor Minor
  • Resolution: Unresolved
  • Affects Version/s: UDIG 1.1.RC5, UDIG 1.2.M3
  • Fix Version/s: UDIG 1.3.2
  • Component/s: installing and running udig
  • Labels:
    None
  • Environment:
    Gnu: Ubuntu feisty with gcj

Description

The default binary should handle some simple commandline semantics to help users diagnose problems and look for solutions.

Help:
This should explain the usage of the 'udig' launcher, such as any flags for determining the location of the workspace.

Version:
Return a descriptor of the JRE, its config and the version of uDig.

--adrian

  • Options
    • Sort By Name
    • Sort By Date
    • Ascending
    • Descending
    • Download All

Attachments

  1. Text File
    UDIGApplication.patch
    13/Mar/09 10:38 PM
    1 kB
    John Hudson

Issue Links

is duplicated by

Bug - A problem which impairs or prevents the functions of the product. UDIG-1227 Udig needs a --help command-line flag with a list of possible flags

  • Minor - Minor loss of function, or other problem where easy workaround is present.
  • Closed - The issue is considered finished, the resolution is correct. Issues which are not closed can be reopened.

Activity

Ascending order - Click to sort in descending order
  • All
  • Comments
  • History
  • Activity
Hide
Permalink
Jody Garnett added a comment - 06/Mar/09 7:13 AM
We need to look at the UDIGApplication and check if we can access command line parameters; if not we should mark this as WONTFIX.

But I think we can:
- http://dev.eclipse.org/newslists/news.eclipse.platform.rcp/msg29215.html

We use the Apache Commons CLI for our command line parsing. It works nicely
for us, was easy to implement and maintain.

Take a look at Platform.getCommandLineArgs() usage in IDEWorkbenchAdvisor to
see what is available in the Eclipse framework. It is a simple
implementation that does the job.

David Kyle
http://richclientplatform.blogspot.com
Show
Jody Garnett added a comment - 06/Mar/09 7:13 AM We need to look at the UDIGApplication and check if we can access command line parameters; if not we should mark this as WONTFIX. But I think we can: - http://dev.eclipse.org/newslists/news.eclipse.platform.rcp/msg29215.html We use the Apache Commons CLI for our command line parsing. It works nicely for us, was easy to implement and maintain. Take a look at Platform.getCommandLineArgs() usage in IDEWorkbenchAdvisor to see what is available in the Eclipse framework. It is a simple implementation that does the job. David Kyle http://richclientplatform.blogspot.com
Hide
Permalink
John Hudson added a comment - 13/Mar/09 10:37 PM
This is quite simple using the above links I have added a snippet of code (see attached .patch file) which looks for "--help", "-h", "--version" or "-v" and System.outs upon finding any of these as command line arguments.

This patch is not a complete fix.
Show
John Hudson added a comment - 13/Mar/09 10:37 PM This is quite simple using the above links I have added a snippet of code (see attached .patch file) which looks for "--help", "-h", "--version" or "-v" and System.outs upon finding any of these as command line arguments. This patch is not a complete fix.
Hide
Permalink
John Hudson added a comment - 13/Mar/09 10:38 PM
Foundation of work, this can be used to gather the command line arguments and display appropriate output for each.
Show
John Hudson added a comment - 13/Mar/09 10:38 PM Foundation of work, this can be used to gather the command line arguments and display appropriate output for each.
Hide
Permalink
Andrea Antonello added a comment - 14/Mar/09 5:03 AM
the help looks like:


NAME
udig

SYNOPSIS
udig.exe [OPTIONS] [-vmargs [VM_OPTIONS]]

DESCRIPTION
uDig is an open source (LGPL) desktop application framework, built with Eclipse Rich Client (RCP) technology.

OPTIONS
--help, -h
Print this help and exit.

--version, -v
Print version number and exit.

-data <workspacePath>
Sets the path of the workspace on which to run udig.

-nl locale
Defines the name of the locale on which uDig is running (ex. -nl IT will force uDig to run with Italian user interface).

-clean
Cleans cached data used by the OSGi framework and Eclipse runtime.
Try to run Eclipse once with this option if you observe startup errors after
install, update, or using a shared configuration.

-consoleLog -debug
Mirrors all errors to standard output. Usefull to find odd behaviours and report them to developers.

-vm <vmPath>
The location of Java Runtime Environment (JRE) to use to run uDig.

VM_OPTIONS
-Xmx<memory size>
Set maximum Java heap size (ex. -Xmx1200m sets it to 1200 megabytes).



and the version like:

Version Information:
uDig version: 1.2M3
Java VM: 1.6.0_11
OS: Windows Vista x86


Closing issue
Show
Andrea Antonello added a comment - 14/Mar/09 5:03 AM the help looks like: NAME udig SYNOPSIS udig.exe [OPTIONS] [-vmargs [VM_OPTIONS]] DESCRIPTION uDig is an open source (LGPL) desktop application framework, built with Eclipse Rich Client (RCP) technology. OPTIONS --help, -h Print this help and exit. --version, -v Print version number and exit. -data <workspacePath> Sets the path of the workspace on which to run udig. -nl locale Defines the name of the locale on which uDig is running (ex. -nl IT will force uDig to run with Italian user interface). -clean Cleans cached data used by the OSGi framework and Eclipse runtime. Try to run Eclipse once with this option if you observe startup errors after install, update, or using a shared configuration. -consoleLog -debug Mirrors all errors to standard output. Usefull to find odd behaviours and report them to developers. -vm <vmPath> The location of Java Runtime Environment (JRE) to use to run uDig. VM_OPTIONS -Xmx<memory size> Set maximum Java heap size (ex. -Xmx1200m sets it to 1200 megabytes). and the version like: Version Information: uDig version: 1.2M3 Java VM: 1.6.0_11 OS: Windows Vista x86 Closing issue
Hide
Permalink
Jody Garnett added a comment - 25/Mar/09 7:32 PM - edited
This is not working for me on windows? I checked the source code and the patch has been applied.

It is kind of doing something: when I run "udig.exe -h" the splash screen shows; and then the application stops - but the help text is not displayed anywhere. I went and checked the logs (on the off chance standard out was used and that is where the information was being sent; but I did not see anything there).
Show
Jody Garnett added a comment - 25/Mar/09 7:32 PM - edited This is not working for me on windows? I checked the source code and the patch has been applied. It is kind of doing something: when I run "udig.exe -h" the splash screen shows; and then the application stops - but the help text is not displayed anywhere. I went and checked the logs (on the off chance standard out was used and that is where the information was being sent; but I did not see anything there).
Hide
Permalink
Jody Garnett added a comment - 04/Mar/10 5:03 PM
Andrea still no progress on this for windows; could you do a windows specific test and open up a text file using notepad that has the help instructions? Could we somehow ask the user to press a key when they are done reading (so the CMD window does not close right away?)

If you really don't care mark this issue as closed; windows users are not likely to open the command line.
Show
Jody Garnett added a comment - 04/Mar/10 5:03 PM Andrea still no progress on this for windows; could you do a windows specific test and open up a text file using notepad that has the help instructions? Could we somehow ask the user to press a key when they are done reading (so the CMD window does not close right away?) If you really don't care mark this issue as closed; windows users are not likely to open the command line.

People

  • Assignee:
    Andrea Antonello
    Reporter:
    Adrian Custer
Vote (0)
Watch (0)

Dates

  • Created:
    21/Nov/06 3:50 AM
    Updated:
    21/Dec/11 7:48 AM
  • Atlassian JIRA (v5.0.4#731-sha1:3aa7374)
  • Report a problem
  • Powered by a free Atlassian JIRA open source license for Codehaus. Try JIRA - bug tracking software for your team.