[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Documentation for "Clone Buffers" (corrected version)
From: |
Karl Berry |
Subject: |
Re: Documentation for "Clone Buffers" (corrected version) |
Date: |
Sun, 14 Mar 2004 14:58:27 -0500 |
the one who divided (info)Advanced up into @unnumberedsubsec the way
Sorry, I didn't realize the @unnumberedsubsec's were pre-existing.
apparently whoever wrote it thought that it looked better than the
I think ignorance is a much more likely explanation.
info.texi to make reading it in hardcopy useful. So I believe the
Although not all parts of info.texi make sense in print, others do, and
more will in the future (about the Info file format, when I write it).
particular, we could replace @unnumberedsubsec with @subheading. I do
Please do. It's not a matter of looks (it'll look the same). It's a
matter of good structure and good style.
Actually, making normal @nodes/@subsections of Advanced for those
different topics seems desirable to me, now that I look at it again. I
don't see any reason why they should all be dumped together in one node
when they are independent. Each one is about a node's worth on its own.
would at least provide complete documentation in that docstring, on
It's not my place, but I can't imagine why a more complete docstring
would be objectionable.
So what about this revised patch:
I think it's fine.
Thanks,
k
- Re: Documentation for "Clone Buffers" (corrected version), (continued)
- Re: Documentation for "Clone Buffers" (corrected version), David Kastrup, 2004/03/10
- Re: Documentation for "Clone Buffers" (corrected version), Alan Mackenzie, 2004/03/11
- Re: Documentation for "Clone Buffers" (corrected version), Luc Teirlinck, 2004/03/12
- Re: Documentation for "Clone Buffers" (corrected version), Luc Teirlinck, 2004/03/13
- Re: Documentation for "Clone Buffers" (corrected version), Karl Berry, 2004/03/12
- Re: Documentation for "Clone Buffers" (corrected version), Luc Teirlinck, 2004/03/13
- Re: Documentation for "Clone Buffers" (corrected version), Eli Zaretskii, 2004/03/14
- Re: Documentation for "Clone Buffers" (corrected version), Luc Teirlinck, 2004/03/14
- Re: Documentation for "Clone Buffers" (corrected version), Eli Zaretskii, 2004/03/14
- Re: Documentation for "Clone Buffers" (corrected version), Luc Teirlinck, 2004/03/14
- Re: Documentation for "Clone Buffers" (corrected version),
Karl Berry <=
- Re: Documentation for "Clone Buffers" (corrected version), Luc Teirlinck, 2004/03/14
- Re: Documentation for "Clone Buffers" (corrected version), Eli Zaretskii, 2004/03/15
- Re: Documentation for "Clone Buffers" (corrected version), Luc Teirlinck, 2004/03/15
- Re: Documentation for "Clone Buffers" (corrected version), Eli Zaretskii, 2004/03/16
- Re: Documentation for "Clone Buffers" (corrected version), Luc Teirlinck, 2004/03/15
- Re: Documentation for "Clone Buffers" (corrected version), Richard Stallman, 2004/03/16
- Re: Documentation for "Clone Buffers" (corrected version), Karl Berry, 2004/03/14
- Re: Documentation for "Clone Buffers" (corrected version), Eli Zaretskii, 2004/03/14
- Re: Documentation for "Clone Buffers" (corrected version), Richard Stallman, 2004/03/15
Re: Documentation for "Clone Buffers" (corrected version), Miles Bader, 2004/03/12