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: [elpa] master a79dd37 07/11: fsm: Fix checkdoc errors Date: Sat, 05 Sep 2015 11:27:06 -0400 Message-ID: References: <20150905100513.2686.25389@vcs.savannah.gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1441466851 20241 80.91.229.3 (5 Sep 2015 15:27:31 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 5 Sep 2015 15:27:31 +0000 (UTC) Cc: Thomas Fitzsimmons To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Sep 05 17:27:16 2015 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1ZYFN5-0000dU-Ma for ged-emacs-devel@m.gmane.org; Sat, 05 Sep 2015 17:27:15 +0200 Original-Received: from localhost ([::1]:41015 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZYFN5-0003fJ-Ol for ged-emacs-devel@m.gmane.org; Sat, 05 Sep 2015 11:27:15 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:60275) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZYFN2-0003fB-Ks for emacs-devel@gnu.org; Sat, 05 Sep 2015 11:27:13 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZYFMx-0004QR-Kx for emacs-devel@gnu.org; Sat, 05 Sep 2015 11:27:12 -0400 Original-Received: from ironport2-out.teksavvy.com ([206.248.154.181]:38123) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZYFMx-0004QL-Go for emacs-devel@gnu.org; Sat, 05 Sep 2015 11:27:07 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: A0A1FgA731xV/xGkpUVcgxCEAoVVwwsEAgKBPDwRAQEBAQEBAYEKQQWDXQEBBFYjEAs0EhQYDYhjzyMBAQEBBgIBH4s6gT0Bg0cHFoQXBZltmVKBRSOCF4F9IoJ4AQEB X-IPAS-Result: A0A1FgA731xV/xGkpUVcgxCEAoVVwwsEAgKBPDwRAQEBAQEBAYEKQQWDXQEBBFYjEAs0EhQYDYhjzyMBAQEBBgIBH4s6gT0Bg0cHFoQXBZltmVKBRSOCF4F9IoJ4AQEB X-IronPort-AV: E=Sophos;i="5.13,465,1427774400"; d="scan'208";a="162567469" Original-Received: from 69-165-164-17.dsl.teksavvy.com (HELO ceviche.home) ([69.165.164.17]) by ironport2-out.teksavvy.com with ESMTP/TLS/DHE-RSA-AES256-SHA; 05 Sep 2015 11:27:07 -0400 Original-Received: by ceviche.home (Postfix, from userid 20848) id CCD6C66482; Sat, 5 Sep 2015 11:27:06 -0400 (EDT) In-Reply-To: (Thomas Fitzsimmons's message of "Sat, 05 Sep 2015 10:05:16 +0000") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 206.248.154.181 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:189630 Archived-At: > - "Send EVENT to FSM asynchronously. > + "Send FSM EVENT asynchronously. Hmm... was that because checkdoc asked you to put the args in the order of appearance? I think this part of checkdoc's recommendations is not to be taken too seriously. It's OK to follow this principle for things like Arg FOO does toto. Arg BAR does titi. But clarity of the text takes precedence. Stefan