From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Thomas Fitzsimmons Newsgroups: gmane.emacs.devel Subject: Re: [elpa] master a79dd37 07/11: fsm: Fix checkdoc errors Date: Sat, 05 Sep 2015 16:38:55 -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 1441485569 6424 80.91.229.3 (5 Sep 2015 20:39:29 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 5 Sep 2015 20:39:29 +0000 (UTC) Cc: emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Sep 05 22:39:15 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 1ZYKF0-0002lP-G7 for ged-emacs-devel@m.gmane.org; Sat, 05 Sep 2015 22:39:14 +0200 Original-Received: from localhost ([::1]:42745 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZYKF0-0000Ju-EX for ged-emacs-devel@m.gmane.org; Sat, 05 Sep 2015 16:39:14 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:56654) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZYKEn-0008UL-BJ for emacs-devel@gnu.org; Sat, 05 Sep 2015 16:39:02 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZYKEj-0006uv-Bl for emacs-devel@gnu.org; Sat, 05 Sep 2015 16:39:01 -0400 Original-Received: from mail-io0-f181.google.com ([209.85.223.181]:33137) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZYKEj-0006uj-8C for emacs-devel@gnu.org; Sat, 05 Sep 2015 16:38:57 -0400 Original-Received: by iofh134 with SMTP id h134so56095331iof.0 for ; Sat, 05 Sep 2015 13:38:56 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version:content-type; bh=CL+bGZB66SBYwfS3ndUGGpdmxyreSj6dP0D/dHBBR3Y=; b=aeZXdTxlf/aYCC1t/gQ5d/6/P8vjIfbWoWxvopZWrrfbfDyO/iRwXwcNudUcxb6zdr C7Koo8HtZziAMyvvbDdkn9vt3qsZfIKyjHlBDU5xJpeUk92vw+syqFmBq9GEgZph9Lqf VPsR/JqCGIar/8ySXbnDmVoWw4Vt/BYUG5jRtQYSk+016UMEKXWUXEjxzQ3lWdMNadRg AC4FXeiSPqtv2cAYzBi9agxF+zjkuvQ9EZSWcJj64c8w32hlbTnLPiE6vQQDlayl2Ci0 gjMsSd+of66mBoPgXxxPhCtkwQNFBTMdtU1bcLO4DQV1ex6pzFOHeDqrFYHOkWTiIZYs xpeA== X-Gm-Message-State: ALoCoQnT/hnAlggkkW91cdk3NlrIzCsnWVvB7m5maVF/SsLceIDq/oJSlt/az0HMpPu+hAPLGFzM X-Received: by 10.107.9.212 with SMTP id 81mr1799554ioj.191.1441485536432; Sat, 05 Sep 2015 13:38:56 -0700 (PDT) Original-Received: from hp-dv5t (69-165-165-189.dsl.teksavvy.com. [69.165.165.189]) by smtp.gmail.com with ESMTPSA id k21sm4277508ioi.10.2015.09.05.13.38.55 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sat, 05 Sep 2015 13:38:55 -0700 (PDT) In-Reply-To: (Stefan Monnier's message of "Sat, 05 Sep 2015 11:27:06 -0400") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 209.85.223.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:189632 Archived-At: Stefan Monnier writes: >> - "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? Yes, I was trying to make fsm.el "checkdoc-clean". > 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. OK, I reverted these parts, including the last one where I liked the previous wording better. Thomas