Zsh Mailing List Archive
Messages sorted by: Reverse Date, Date, Thread, Author

Re: Suggestion for a new doc style



On Mon, Dec 29, 2008 at 02:46, Bart Schaefer <schaefer@xxxxxxxxxxxxxxxx> wrote:

> If this is done (and I'm not at all sure it should be) I think it
> should be wrapped up in appropriate yodl conditionals so that it only
> appears in the HTML version. The only value of such an annotation is
> when the manual you're reading doesn't match your version of the shell,
> which ordinarily can happen only if you're reading the docs online.
> Otherwise the doc you have corresponds to the shell you have, and it
> would be unnecessary (and to me annoying) to have a continuous history
> lesson embedded in the manual.

I usually edit my RC files on my three main boxes, but I sync them to a
lot of other hosts. In that case, it would be handy to see when something
was introduced directly.


> There's a reason for the ChangeLog file.

True, and it's not hard to use it. Yet, I think the other way would be more
convenient.


Richard



Messages sorted by: Reverse Date, Date, Thread, Author