From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: When will emacs 27.1 be officially released? Date: Fri, 03 Jul 2020 22:53:54 -0400 Message-ID: References: <28BB39D5-074F-4450-A747-C2BFB37AA482@gnu.org> <87pn9g6fuo.fsf@gmail.com> <83bll0ze1x.fsf@gnu.org> <03c328d0-b446-9806-5b7b-1cda10a50eb7@cs.ucla.edu> <835zb8z84k.fsf@gnu.org> <93bffae8-e8e5-2eea-7087-5a894cbfea0c@cs.ucla.edu> <87366964py.fsf@gnu.org> <0d0bd9de-c263-931e-d534-875d64210a0f@cs.ucla.edu> Reply-To: rms@gnu.org Content-Type: text/plain; charset=Utf-8 Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="20063"; mail-complaints-to="usenet@ciao.gmane.io" Cc: eliz@gnu.org, liwei.ma@gmail.com, kevin.legouguec@gmail.com, emacs-devel@gnu.org To: Paul Eggert Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Jul 04 04:54:26 2020 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1jrYJu-00057a-NE for ged-emacs-devel@m.gmane-mx.org; Sat, 04 Jul 2020 04:54:26 +0200 Original-Received: from localhost ([::1]:60936 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jrYJt-0007i7-Pi for ged-emacs-devel@m.gmane-mx.org; Fri, 03 Jul 2020 22:54:25 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:37972) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jrYJQ-00078Z-Cx for emacs-devel@gnu.org; Fri, 03 Jul 2020 22:53:56 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:55557) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jrYJQ-0000nx-3H; Fri, 03 Jul 2020 22:53:56 -0400 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.82) (envelope-from ) id 1jrYJO-00008D-VH; Fri, 03 Jul 2020 22:53:55 -0400 In-Reply-To: <0d0bd9de-c263-931e-d534-875d64210a0f@cs.ucla.edu> (message from Paul Eggert on Thu, 2 Jul 2020 13:36:05 -0700) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 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-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:252652 Archived-At: [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] On 7/2/20 1:29 PM, Tassilo Horn wrote: > I just looked at the docs and it seems that in large parts the > function descriptions in the manual read > > This function takes a @var{coin} and returns a @var{beer}. That is incorrect style for @var. @var{coin} refers to the value of the argument named 'coin', as a proper name. It does not mean a _type_ of value, it means _the value_. It is incorrect style to use an article before @var. Here's the start of the definition of 'nth': @defun nth n list @anchor{Definition of nth} This function returns the @var{n}th element of @var{list}. Elements are numbered starting with zero, so the @sc{car} of @var{list} is element number zero. If the length of @var{list} is @var{n} or less, the value is @code{nil}. If you want to describe the type of something, to say that it is a list, write "list" with NO markup. Ironically, this is one style point on which we treat doc strings the same as manuals. Here's the doc string of nth: Return the Nth element of LIST. N counts from zero. If LIST is not that long, nil is returned. Once again, no article before an argument name. When the argument name is a data type name, you can take that to mean that the value should have that type. Thus, LIST should be a list. Does the Texinfo manual explain these conventions? ISTR it does. -- Dr Richard Stallman Chief GNUisance of the GNU Project (https://gnu.org) Founder, Free Software Foundation (https://fsf.org) Internet Hall-of-Famer (https://internethalloffame.org)