From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Christoph Scholtes Newsgroups: gmane.emacs.devel Subject: Re: ido.el doc fixes Date: Mon, 28 Feb 2011 19:36:17 -0700 Message-ID: <86lj0za7oe.fsf@gmail.com> References: <4D6BF24D.50805@gmail.com> <83y650m02y.fsf@gnu.org> <86ei6r51ph.fsf@gmail.com> <83tyfnna7a.fsf@gnu.org> <4D6C453A.4020201@gmail.com> <55y64z8vx6.fsf@fencepost.gnu.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1298947027 7628 80.91.229.12 (1 Mar 2011 02:37:07 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Tue, 1 Mar 2011 02:37:07 +0000 (UTC) Cc: Eli Zaretskii , emacs-devel@gnu.org To: Glenn Morris Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Mar 01 03:36:56 2011 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1PuFSI-0005Ac-MW for ged-emacs-devel@m.gmane.org; Tue, 01 Mar 2011 03:36:54 +0100 Original-Received: from localhost ([127.0.0.1]:59810 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PuFSH-0004U7-Sc for ged-emacs-devel@m.gmane.org; Mon, 28 Feb 2011 21:36:53 -0500 Original-Received: from [140.186.70.92] (port=36149 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PuFS6-0004DV-41 for emacs-devel@gnu.org; Mon, 28 Feb 2011 21:36:47 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PuFS0-0007kD-E5 for emacs-devel@gnu.org; Mon, 28 Feb 2011 21:36:41 -0500 Original-Received: from mail-vw0-f41.google.com ([209.85.212.41]:36807) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PuFRo-0007f8-Hf; Mon, 28 Feb 2011 21:36:24 -0500 Original-Received: by vws13 with SMTP id 13so4755493vws.0 for ; Mon, 28 Feb 2011 18:36:23 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlemail.com; s=gamma; h=domainkey-signature:from:to:cc:subject:in-reply-to:references :user-agent:date:message-id:mime-version:content-type; bh=5MqPo2ok0b4MJKuziEG5kW/uo/z+RZS+82H1uc1bcqg=; b=Y2zNIYKs5zEslnfpcwRpdj9Nlm8xL3RwVH2rTU0Gs9wetZU/22Aaf5c2xJ4empq6Xm nDXURx/ifTqlHYbLZ02+LfqYKxF9kz7FTHPEINMgAM1eQ1DxuiHRutSq/Z3bMLadModN HgoVxtV8S4ALI5cBUTdro8WjZRaRA2gBFf1iM= DomainKey-Signature: a=rsa-sha1; c=nofws; d=googlemail.com; s=gamma; h=from:to:cc:subject:in-reply-to:references:user-agent:date :message-id:mime-version:content-type; b=W0jeiPh3M6SGGwx4tWYMoEfcE+TvT/y3fEepfKsnp3BUTzt29p4c+0a8T4WTdv16l/ xmWq5LOauUXPytSx4W9T1KlWwR1oNMnzZ0p/f6qqkzrUADiCvI7fY3o6TEFeun5pKF3q klg86bP/OzPkpFYwHCSJoera3gUBLb8KuM+og= Original-Received: by 10.52.167.229 with SMTP id zr5mr10449603vdb.117.1298946983519; Mon, 28 Feb 2011 18:36:23 -0800 (PST) Original-Received: from localhost (71-208-196-83.hlrn.qwest.net [71.208.196.83]) by mx.google.com with ESMTPS id c4sm1995017vcc.30.2011.02.28.18.36.20 (version=TLSv1/SSLv3 cipher=OTHER); Mon, 28 Feb 2011 18:36:22 -0800 (PST) In-Reply-To: <55y64z8vx6.fsf@fencepost.gnu.org> (Glenn Morris's message of "Mon, 28 Feb 2011 20:35:33 -0500") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (windows-nt) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 209.85.212.41 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:136632 Archived-At: Glenn Morris writes: > I don't think that is correct. You can move point wherever you like. So > long as you have not entered any text for an entry, the next entry from > the same file will merge with it. (If add-log-always-start-new-record is > nil.) That looks correct. I modified the patch as below. > I don't think an example ChangeLog entry is needed for this behaviour. > It's good to try to keep the manual from expanding too much. OK. I think with the above corrections it might be clear enough without example. > It's better to use the active voice (see tips.texi). Eg "You can combine > multiple changes of the same nature". Thanks. Christoph === modified file 'doc/emacs/ChangeLog' --- doc/emacs/ChangeLog 2011-02-28 01:07:29 +0000 +++ doc/emacs/ChangeLog 2011-02-28 23:17:26 +0000 @@ -1,3 +1,10 @@ +2011-02-28 Christoph Scholtes + + * maintaining.texi (Format of ChangeLog): Add reference to + add-log-full-name. + (Change Log Commands): Add documentation and example for combining + multiple symbols in one change. + 2011-02-28 Eli Zaretskii * search.texi (Regexp Search): Move index entries about regexps to the === modified file 'doc/emacs/maintaining.texi' --- doc/emacs/maintaining.texi 2011-02-05 22:30:14 +0000 +++ doc/emacs/maintaining.texi 2011-03-01 02:28:44 +0000 @@ -1486,6 +1486,10 @@ non-@code{nil}, @kbd{C-x 4 a} adds to any existing item for the file rather than starting a new item. +You can combine multiple changes of the same nature. If you don't +enter any text after the initial @kbd{C-x 4 a}, any subsequent +@kbd{C-x 4 a} adds another symbol to the change. + @vindex add-log-always-start-new-record If @code{add-log-always-start-new-record} is non-@code{nil}, @kbd{C-x 4 a} always makes a new entry, even if the last entry @@ -1535,13 +1539,14 @@ @node Format of ChangeLog @subsection Format of ChangeLog - A change log entry starts with a header line that contains the current -date, your name, and your email address (taken from the variable -@code{add-log-mailing-address}). Aside from these header lines, every -line in the change log starts with a space or a tab. The bulk of the -entry consists of @dfn{items}, each of which starts with a line starting -with whitespace and a star. Here are two entries, both dated in May -1993, with two items and one item respectively. + A change log entry starts with a header line that contains the +current date, your name (taken from the variable +@code{add-log-full-name}), and your email address (taken from the +variable @code{add-log-mailing-address}). Aside from these header +lines, every line in the change log starts with a space or a tab. The +bulk of the entry consists of @dfn{items}, each of which starts with a +line starting with whitespace and a star. Here are two entries, both +dated in May 1993, with two items and one item respectively. @iftex @medbreak