<div dir="ltr"><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Sep 26, 2016 at 5:50 PM, Vaclav Petras <span dir="ltr"><<a target="_blank" href="mailto:wenzeslaus@gmail.com">wenzeslaus@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">If the --help is just for scanning and the issue is that it simply too long, hiding some parameters is not the only option we have. For many (and more in the future hopefully) parameters we have (short) label and (longer) description. --help prints both (if both are present, that's at least 2 lines per parameter). Additionally, if the option has predefined values which have descriptions, there is one line for each of those. So, the question is would it be helpful (at least as a first step) if --help would print less information for each parameter but still provided all parameters?</blockquote></div><br>Additionally, the label and description is also for the module itself, so when we have label, we don't need to show description, that's -1 line for r.slope.aspect. Then we can remove keywords, that's -3 lines. Then we have the standard/long flags. (These might be similar to the general options from `ogr2ogr --help-general` which Madi posted.) They are the same all the time, except for --o, so that's -4 or -3 for the old ones (depending on module) and -2 for the recently added flags (--qq --ui). They still can be in `Usage:` section or they may not. There is also an empty line at the beginning, we can remove it as well because don't go for beauty and the `Description:` title is also not necessary, so we could remove that as well, that's -2 lines. That would be 12 lines total. (I have 55 lines in the terminal windows I'm using right now, so 12 seems to be quite a lot).<br><br></div><div class="gmail_extra">In GUI or even in the manual, we could put the standard/long flags to a separate section as well. <br></div><div class="gmail_extra"><br>> r.slope.aspect --help<br><br>Description:<br> Generates raster maps of slope, aspect, curvatures and partial derivatives from an elevation raster map.<br> Aspect is calculated counterclockwise from east.<br><br>Keywords:<br> raster, terrain, aspect, slope, curvature<br><br>Usage:<br> r.slope.aspect [-a] elevation=name [slope=name] [aspect=name]<br>   [format=string] [precision=string] [pcurvature=name] [tcurvature=name]<br>   [dx=name] [dy=name] [dxx=name] [dyy=name] [dxy=name] [zscale=value]<br>   [min_slope=value] [--overwrite] [--help] [--verbose] [--quiet] [--ui]<br><br>Flags:<br>  -a   Do not align the current region to the raster elevation map<br> --o   Allow output files to overwrite existing files<br> --h   Print usage summary<br> --v   Verbose module output<br> --q   Quiet module output<br> --qq  Super quiet module output<br> --ui  Force launching GUI dialog<br><br></div></div>