From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: karl@freefriends.org (Karl Berry) Newsgroups: gmane.emacs.devel Subject: Re: Documentation for "Clone Buffers" (corrected version) Date: Sun, 14 Mar 2004 14:58:27 -0500 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <200403141958.i2EJwRK01078@f7.net> References: <200403141817.i2EIH5M03101@raven.dms.auburn.edu> NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1079294398 21258 80.91.224.253 (14 Mar 2004 19:59:58 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 14 Mar 2004 19:59:58 +0000 (UTC) Cc: acm@muc.de, eliz@elta.co.il, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Sun Mar 14 20:59:53 2004 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1B2bm5-0000k2-00 for ; Sun, 14 Mar 2004 20:59:53 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1B2bm5-00080X-00 for ; Sun, 14 Mar 2004 20:59:53 +0100 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.30) id 1B2blv-0000Mb-IH for emacs-devel@quimby.gnus.org; Sun, 14 Mar 2004 14:59:43 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.30) id 1B2blO-0000M0-Is for emacs-devel@gnu.org; Sun, 14 Mar 2004 14:59:10 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.30) id 1B2bks-00006m-Li for emacs-devel@gnu.org; Sun, 14 Mar 2004 14:59:09 -0500 Original-Received: from [209.61.216.22] (helo=f7.net) by monty-python.gnu.org with esmtp (Exim 4.30) id 1B2bks-00006J-87 for emacs-devel@gnu.org; Sun, 14 Mar 2004 14:58:38 -0500 Original-Received: (from karl@localhost) by f7.net (8.11.7-20030920/8.11.7) id i2EJwRK01078; Sun, 14 Mar 2004 14:58:27 -0500 Original-To: teirllm@dms.auburn.edu In-Reply-To: <200403141817.i2EIH5M03101@raven.dms.auburn.edu> X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.4 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:20469 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:20469 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