[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: @seealso placement
From: |
Graham Percival |
Subject: |
Re: @seealso placement |
Date: |
Tue, 9 Nov 2010 18:19:31 +0000 |
User-agent: |
Mutt/1.5.20 (2009-06-14) |
On Tue, Nov 09, 2010 at 09:46:24AM -0800, Mark Polesky wrote:
> Should @seealso go at the end of an @unnumberedsubsubsec, or
> only at the end of the entire @subsection?
On line 1001 in Documentation/contributor/doc-work.itely, please
change "documentation sections" into... err...
"documentation portions" ? something like that.
If that part of the docs is dealing with @unnumberedsubsubsec --
such as Notation 1+2 -- then they go at the end of the
@unnumberedsubsubsec. If that part of the docs is dealing with
something else (such as parts of Usage, Learning, etc), then they
go at the end of the smallest unit of @node. Hmm, maybe it's best
to say "the order of headings inside each @node of the
documentation" ?
Anyway, I hope the intent is clear; if you could clarify it in the
Contributor's Guide, that would be nice.
- Graham