Hello everyone,

In order to start resolving the CLI argument conflicts from
https://issues.apache.org/jira/browse/SOLR-17383, we started to deprecate
(in 9.X) and remove or change (in 10.0/main) the overlapping arguments. I
would like to use this thread for tracking each conflict resolution.

A conflict may be a bug or limitation of the CLI, but also just a
possible misinterpretation for new users. Therefore, we should decide for
each conflict what action we should take for the upcoming versions of Solr.
The current state can be tracked at
https://docs.google.com/spreadsheets/d/1ws44kN51WnGwQzOXc8KKRQ93TMgHSqIGb02MRWFel_U/edit?usp=sharing
(work in progress).

Starting with -h, it is currently used for printing the help information
(equivalent to --help) and for providing a hostname in RunExampleTool.java
(equivalent to --host, in 9.X and main).
I created https://issues.apache.org/jira/browse/SOLR-17423, which proposes
the deprecation of -h for hostname in the context of RunExampleTool, and
the removal of it in future major releases (10.0 ongoing).

If there are any objections, please let us know.

Best,
Christos

On Fri, Jul 26, 2024 at 9:36 PM Christos Malliaridis <
c.malliari...@gmail.com> wrote:

> Hello devs,
>
> I would like to get some attention on overlapping arguments that I have
> found and documented in SOLR-17383
> <https://issues.apache.org/jira/browse/SOLR-17383>. This was one of my
> "bad experiences" when I started working with Solr, so I think it may be
> more important than I thought.
>
> With the great work and progress of Eric Pugh moving parts of the scripts
> to Java and my contribution in finding usages of deprecated arguments, I
> got even more curious to identify and document the overlapping arguments in
> both short and long terms.
>
> I am not sure what would be the best way to address this, but I think we
> can improve some arguments in various ways, now that we have already
> started deprecating the usage of specific arguments and argument formats.
>
> Now that we have moved the argument parsing to Java, we could eventually
> make use of Java's inheritance and leverage some arguments like the Solr
> URL, --help or --verbose to make them available in all cases if applicable.
>
> Best,
> - Christos
>

Reply via email to