From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: vc docstrings Date: Fri, 13 Mar 2009 12:06:33 -0400 Message-ID: References: <87r612mi7u.fsf@catnip.gol.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1236961356 21287 80.91.229.12 (13 Mar 2009 16:22:36 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 13 Mar 2009 16:22:36 +0000 (UTC) Cc: emacs-devel@gnu.org To: Miles Bader Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Mar 13 17:23:52 2009 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.50) id 1LiAAU-0000oU-7d for ged-emacs-devel@m.gmane.org; Fri, 13 Mar 2009 17:23:30 +0100 Original-Received: from localhost ([127.0.0.1]:57923 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LiA98-0003Rk-6T for ged-emacs-devel@m.gmane.org; Fri, 13 Mar 2009 12:22:06 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Li9uG-0000q6-O9 for emacs-devel@gnu.org; Fri, 13 Mar 2009 12:06:44 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Li9uA-0000mq-TU for emacs-devel@gnu.org; Fri, 13 Mar 2009 12:06:43 -0400 Original-Received: from [199.232.76.173] (port=60285 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Li9uA-0000mg-Pn for emacs-devel@gnu.org; Fri, 13 Mar 2009 12:06:38 -0400 Original-Received: from pruche.dit.umontreal.ca ([132.204.246.22]:60337) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1Li9u7-00005m-Go; Fri, 13 Mar 2009 12:06:35 -0400 Original-Received: from faina.iro.umontreal.ca (faina.iro.umontreal.ca [132.204.26.177]) by pruche.dit.umontreal.ca (8.14.1/8.14.1) with ESMTP id n2DG6XGx002206; Fri, 13 Mar 2009 12:06:33 -0400 Original-Received: by faina.iro.umontreal.ca (Postfix, from userid 20848) id 2E08C807EA; Fri, 13 Mar 2009 12:06:33 -0400 (EDT) In-Reply-To: <87r612mi7u.fsf@catnip.gol.com> (Miles Bader's message of "Fri, 13 Mar 2009 08:31:17 +0900") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.91 (gnu/linux) X-NAI-Spam-Score: 0 X-NAI-Spam-Rules: 1 Rules triggered RV3230=0 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) 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:109602 Archived-At: > Given that all commonly used source-control systems these days are > the "merging" type, shouldn't the section on "merging systems" be first? Yes. It may even present itself as "the way it works" and the locking version only presented as an exception at the end. > E.g., change the "merging systems" header to: > For merging systems (CVS, Subversion, Git, Bzr, Hg, Arch): > [Maybe similar comments apply to other vc-... commands too.] Better list the locking ones, it's less likely to change over time. Stefan