<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Sep 27, 2016 at 9:15 AM, Margherita Di Leo <span dir="ltr"><<a href="mailto:diregola@gmail.com" target="_blank">diregola@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr">Hi,<br><div class="gmail_extra"><br><div class="gmail_quote"><span class="gmail-">On Tue, Sep 27, 2016 at 7:13 AM, Moritz Lennert <span dir="ltr"><<a href="mailto:mlennert@club.worldonline.be" target="_blank">mlennert@club.worldonline.be</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><span>On 26/09/16 23:50, Vaclav Petras wrote:<br>
</span><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><span>
<br>
On Mon, Sep 26, 2016 at 5:24 PM, Veronica Andreo <<a href="mailto:veroandreo@gmail.com" target="_blank">veroandreo@gmail.com</a><br></span><span>
<mailto:<a href="mailto:veroandreo@gmail.com" target="_blank">veroandreo@gmail.com</a>>> wrote:<br>
<br>
    I'm with MaDi in that if I see a very long list of flags and<br>
    parameters in the terminal when using --h, i just go to the<br>
    manual... I just use --h in CLI for a quick recalling of<br>
    flags/options... A reduced list of most commonly used flags would be<br>
    nice, but still keep the possibility to get the advanced<br>
    flags/parameters as well, if the user needs more info...<br>
<br>
<br>
If the --help is just for scanning and the issue is that it simply too<br>
long, hiding some parameters is not the only option we have. For many<br>
(and more in the future hopefully) parameters we have (short) label and<br>
(longer) description. --help prints both (if both are present, that's at<br>
least 2 lines per parameter). Additionally, if the option has predefined<br>
values which have descriptions, there is one line for each of those. So,<br>
the question is would it be helpful (at least as a first step) if --help<br>
would print less information for each parameter but still provided all<br>
parameters?<br>
</span></blockquote>
<br>
In line with your other mail where you caution about "hiding" useful information, how about not changing the --help output, but rather adding a "--simple-help" or somthing like this which would output a simplified help.</blockquote><div><br></div></span><div>+1.</div></div></div></div></blockquote><div><br><br></div><div>For inspiration, looking at gdal: <a href="http://www.gdal.org/ogr2ogr.html">http://www.gdal.org/ogr2ogr.html</a><br><br>$ ogr2ogr --help-general<br>Generic GDAL/OGR utility command options:<br>[...]<br><br>$ ogr2ogr --help<br>Usage: ogr2ogr [--help-general] [-skipfailures] [-append] [-update]<br>               [-select field_list] [-where restricted_where]<br>               [-progress] [-sql <sql statement>] [-dialect dialect]<br>               [-preserve_fid] [-fid FID]<br>               [-spat xmin ymin xmax ymax] [-geomfield field]<br>               [-a_srs srs_def] [-t_srs srs_def] [-s_srs srs_def]<br>               [-f format_name] [-overwrite] [[-dsco NAME=VALUE] ...]<br>               dst_datasource_name src_datasource_name<br>               [-lco NAME=VALUE] [-nln name] [-nlt type] [-dim 2|3|layer_dim] [layer [layer ...]]<br><br>Advanced options :<br>[...]<br>Note: ogr2ogr --long-usage for full help.<br><br>$ ogr2ogr --long-usage<br>Usage: ogr2ogr [--help-general] [-skipfailures] [-append] [-update]<br>              [...]<br><br>Advanced options :<br>               [...]<br><br> -f format_name: output file format name, possible values are:<br>              [...]<br><br></div></div><br clear="all"><br>-- <br><div class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><font color="#666666">Margherita Di Leo</font></div></div></div></div></div></div></div></div></div>
</div></div>