From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:4830:134:3::10]:45625) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ewqZW-0005bm-US for guix-patches@gnu.org; Fri, 16 Mar 2018 10:43:08 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ewqZT-0000DC-Af for guix-patches@gnu.org; Fri, 16 Mar 2018 10:43:06 -0400 Received: from debbugs.gnu.org ([208.118.235.43]:57388) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1ewqZT-0000D6-7B for guix-patches@gnu.org; Fri, 16 Mar 2018 10:43:03 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ewqZT-0005wR-0H for guix-patches@gnu.org; Fri, 16 Mar 2018 10:43:03 -0400 Subject: [bug#30797] [PATCH 1/2] gnu: Add emacs-exec-path-from-shell Resent-Message-ID: From: Konrad Hinsen In-Reply-To: <87k1ucrtuu.fsf@gmail.com> References: <87lgetu3gy.fsf@gmail.com> <87k1ucrtuu.fsf@gmail.com> Date: Fri, 16 Mar 2018 15:42:03 +0100 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+kyle=kyleam.com@gnu.org Sender: "Guix-patches" To: Oleg Pykhalov Cc: 30797-done@debbugs.gnu.org, 30797@debbugs.gnu.org Hi Oleg, >> + "This library allows the user to set Emacs' @code{exec-path} and > > I still think this apostrophe is unnecessary. I removed it if you don't > mind. ;-) Well, I don't mind, but according to rules of English grammar, it's either "Emacs'" or "Emacs's'" but not simply "Emacs". See for example: http://www.grammar.cl/rules/genitive-case.htm 4. Singular noun ending in =E2=80=93s: It depends=E2=80=A6 a. Most names: add 's (apostrophe S) * They had a really good time at James=E2=80=99s barbecue last Friday.=20 * We spent the day admiring Frances=E2=80=99s new car.=20 b. Classical or religious names: add ' (only the apostrophe) * Jesus=E2=80=99 disciples carried out the teachings of Jesus.=20 * Sophocles=E2=80=99 plays are still performed today.=20 > And in the description, we could use =E2=80=98@var=E2=80=99 instead of = =E2=80=98@code=E2=80=99: > > -This library allows the user to set Emacs @code{exec-path} and > +This library allows the user to set Emacs @var{exec-path} and I actually hesitated in this case, after consulting the Texinfo manual: 7.1.7 @var{metasyntactic-variable} Use the @var command to indicate metasyntactic variables. A metasyntactic variable is something that stands for another piece of text. For example, you should use a metasyntactic variable in the documentation of a function to describe the arguments that are passed to that function. Do not use @var for the names of normal variables in computer programs. These are specific names, so @code is correct for them (@code). For example, the Emacs Lisp variable texinfo-tex-command is not a metasyntactic variable; it is properly formatted using @code. I must confess I don't understand the difference between a metasyntactic variable and a normal variable. The examples don't help: for me, a function argument is just a pre-initialized "normal" variable. > Pushed with changes above as 22d628148ce857b620f5b8e48dc7cabe004313c5 > > I'll close the bug report. Great, thanks! Konrad.