[
https://issues.apache.org/jira/browse/PDFBOX-2602?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17264312#comment-17264312
]
Maruan Sahyoun commented on PDFBOX-2602:
----------------------------------------
I understand that this is a change for ones familiar with 2.0. But for most it
will be a one time change as switching between versions IMHO is not a typical
use case. The main reasons for changing are
- make pdfbox-app a real CLI and not a wrapper around individual tools which it
has been before
- establish a set of commands instead of using class names as command names
- follow common CLI guide lines which means lower case names
- use options instead of parameters to reduce amibguity and also have a common
pattern for repeatable options
...
Again it's understood that switching back and forth between 2.0 and 3.0 for
testing is now more difficult. That affects people like yourself but also
Tilman, myself and others doing PDFBox development. But the target audience for
the app is our users for whom the change (and others to come) shall make it
easier.
Now, the names etc. are not carved in stone. So if there is a lot of push back
during 3.0 alpha and beta releases we will take that into account.
> Enhance command line tools
> --------------------------
>
> Key: PDFBOX-2602
> URL: https://issues.apache.org/jira/browse/PDFBOX-2602
> Project: PDFBox
> Issue Type: Bug
> Components: Utilities
> Affects Versions: 1.8.8, 2.0.0
> Reporter: Maruan Sahyoun
> Assignee: Maruan Sahyoun
> Priority: Minor
> Fix For: 3.0.0 PDFBox
>
>
> The command line tools shall be enhanced to have the same behavior across all
> tools.
> From the discussion on the dev mailing list
> - add an -h option to print the usage
> - print the usage to System.err and use an exit code of 1 if there was an
> invalid command line parameter
> - print messages on exceptions to System.err
> - rethrow the exception so java can handle it if it will terminate afterwards
> anyway
> - use an exit code of 1if rethrowing doesn't make sense
> Additional input:
> https://clig.dev/
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@pdfbox.apache.org
For additional commands, e-mail: dev-h...@pdfbox.apache.org
