[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.


reply via email to

[Prev in Thread] Current Thread [Next in Thread]