On Wed, 28 Oct 2015, Sven Schreiber wrote:
the doc for 'fcast' is slightly confusing IMO with respect to the
optional [steps-ahead] argument. Buried inside the help text there's the
explanation: "Note that the steps-ahead argument should be given only in
conjunction with the --rolling option."
But in the top-line synopsis of the command this proviso is not hinted
at, instead the argument looks like a regular option (which logically
could well replace the startobs/endobs pair). I don't know if there is a
man-page like syntax for the docs, because then it would also be wrong I
guess, strictly speaking.
So I propose to replace the line
"[ startobs endobs ] [ steps-ahead ] [ varname ]"
"[ startobs endobs ] [ varname ] | [ steps-ahead ] <see --rolling
or something like that.
OK, "something like that": In current git I've exploited the
"variants" apparatus, which is shown for certain commands, to try to
make it clearer that the steps-ahead argument is tied to the
--rolling option (as of now, at any rate).