Commandline help text not correct (e.g., "-f,--fetch <FILE>" does not use a file)

[baderas]

JabRef version 3.5 Windows 10 x64

Steps to reproduce:

1. java -jar JabRef-3.5.jar -h
2. Look at output

See http://help.jabref.org/en/CommandLine

<FILE> is always used as argument name. This is wrong for some command line items, for example -f,--fetch <FILE> is used as "--fetch=Medline:cancer". The correct help entry would be -f, --fetch <SearchTerm> with an explanation how <SearchTerm> must be used.
For some arguments a filename and some additional information (separated by comma, e.g., for -i) can be given. <FILE> is also not correct there.

Same problem exists for:

-d,--prdef <FILE>
 -i,--import <FILE>
    --importToOpen <FILE> 
-m,--exportMatches <FILE> 
-o,--output <FILE> 

[lenhard]

Let me add that fetching alone will not do much. It will fetch, but the results will cease to exist when the invocation terminates. To get actual output, the fetch command should be chained with -o.

Having said that, the documentation can certainly be improved. @baderas: Could you provide a pull request? Improving the textual output of the command line is certainly a good entry point.

[koppor]

We think that the command line should be --fetch=Medline:cancer test.bib

[lenhard]

I just noticed that this issue is in a sense a duplicate of #1850. I am closing the older one and we can track further discussion here.

[dhananjaya2007]

If no one is working on this issue, may I fix it? Thanks

[Siedlerchr]

@dhananjaya2007 Sure go ahead

[davidemdot]

What do you think about this output?

[davidemdot]

The point is that Apache Commons (library currently used) prints the argument(s) within the symbols "<" and ">". So, if we want to show the CLI help like above, it would be easy. In another case, I can program a new code for this.

[tobiasdiez]

@davidemdot Looks good to me. The argument to prdef should be KEY and -m needs a better description. Moreover, I like the example given for -fetch in the description. For me this is easier to understand than e.g. the format for import or aux.

[Siedlerchr]

Thanks to @davidemdot this issue is now fixed in the lastest master.

We would like to ask you to use a development build from https://builds.jabref.org/master and report back if it works for you. Please remember to make a backup of your library before trying-out this version.