From mboxrd@z Thu Jan 1 00:00:00 1970 From: John Darrington Subject: Re: [PATCH 2/2] gnu: Add GSSD and Pipefs services (Usage of @var) Date: Tue, 13 Sep 2016 15:53:30 +0200 Message-ID: <20160913135330.GA24267@jocasta.intra> References: <1473535083-5326-1-git-send-email-jmd@gnu.org> <1473535083-5326-2-git-send-email-jmd@gnu.org> <87bmzs6n1s.fsf@gnu.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="GvXjxJ+pjyke8COw" Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:60848) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bjo9c-00031s-4D for guix-devel@gnu.org; Tue, 13 Sep 2016 09:53:43 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bjo9a-00030q-0L for guix-devel@gnu.org; Tue, 13 Sep 2016 09:53:39 -0400 Content-Disposition: inline In-Reply-To: <87bmzs6n1s.fsf@gnu.org> List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: Ludovic Court??s Cc: guix-devel@gnu.org --GvXjxJ+pjyke8COw Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Tue, Sep 13, 2016 at 01:45:19PM +0200, Ludovic Court??s wrote: John Darrington skribis: > +@item @code{nfs-utils} (default: @code{nfs-utils}) ^^^^^ Should be @var, because here we???re talking about the value of the ???nfs-utils??? global variable. I think you are mistaken here. Quoting from the Texinfo manual: Use the @var command to indicate metasyntactic variables. A metasyntact= ic=20 variable is something that stands for another piece of text. For example= , you should use a metasyntactic variable in the documentation of a function t= o=20 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=20 Emacs Lisp variable texinfo-tex-command is not a metasyntactic variable;= it=20 is properly formatted using @code. Or have I got it wrong? J' =20 --=20 Avoid eavesdropping. Send strong encrypted email. PGP Public key ID: 1024D/2DE827B3=20 fingerprint =3D 8797 A26D 0854 2EAB 0285 A290 8A67 719C 2DE8 27B3 See http://sks-keyservers.net or any PGP keyserver for public key. --GvXjxJ+pjyke8COw Content-Type: application/pgp-signature; name="signature.asc" Content-Description: Digital signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1 iEYEARECAAYFAlfYBNoACgkQimdxnC3oJ7NXlACfSoei87Ame41igsDpPzk90Cq9 SHcAn17elaYmk+MvI1HTjS0VM+IXdjxD =M4rh -----END PGP SIGNATURE----- --GvXjxJ+pjyke8COw--