From: Bart Schaefer <schaefer@brasslantern.com>
To: "Zsh Workers" <zsh-workers@sunsite.dk>
Subject: Re: Suggestion for a new doc style
Date: Sun, 28 Dec 2008 17:46:21 -0800 [thread overview]
Message-ID: <081228174621.ZM19203@torch.brasslantern.com> (raw)
In-Reply-To: <2d460de70812280352l53c56b27qea97dbb4659c709b@mail.gmail.com>
On Dec 28, 12:52pm, Richard Hartmann wrote:
}
} Thus, I wanted to suggest that all _new_ docs that ware written
} have a term like '(introduced in x.y.z)' appended to them.
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.
There's a reason for the ChangeLog file.
next prev parent reply other threads:[~2008-12-29 1:46 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2008-12-28 11:52 Richard Hartmann
2008-12-29 1:46 ` Bart Schaefer [this message]
2008-12-29 2:14 ` Richard Hartmann
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=081228174621.ZM19203@torch.brasslantern.com \
--to=schaefer@brasslantern.com \
--cc=zsh-workers@sunsite.dk \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.vuxu.org/mirror/zsh/
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).