From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:4830:134:3::10]:35116) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fqZRR-0000WT-Cj for guix-patches@gnu.org; Fri, 17 Aug 2018 03:45:06 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fqZRO-0004dp-6w for guix-patches@gnu.org; Fri, 17 Aug 2018 03:45:05 -0400 Received: from debbugs.gnu.org ([208.118.235.43]:48209) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fqZRO-0004dY-0f for guix-patches@gnu.org; Fri, 17 Aug 2018 03:45:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fqZRN-0004KE-Up for guix-patches@gnu.org; Fri, 17 Aug 2018 03:45:01 -0400 Subject: [bug#32256] [PATCH] gnu: Add nudoku. Resent-Message-ID: From: Kei Kebreau References: <20180724120402.22409-1-ricardo.wurmus@mdc-berlin.de> <87bmatbvog.fsf@posteo.net> <87sh3eclbc.fsf@tobias.gr> Date: Fri, 17 Aug 2018 03:44:13 -0400 In-Reply-To: <87sh3eclbc.fsf@tobias.gr> (Tobias Geerinckx-Rice's message of "Thu, 16 Aug 2018 18:45:11 +0200") Message-ID: <87o9e130aa.fsf@posteo.net> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha256; protocol="application/pgp-signature" 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: Tobias Geerinckx-Rice Cc: 32256@debbugs.gnu.org --=-=-= Content-Type: text/plain Tobias Geerinckx-Rice writes: > Kei, > > Just an aside on this important matter. > > Kei Kebreau wrote: >>> + (description "nudoku is a ncurses based sudoku game.") >> >> I'd use "@code{nudoku}" here because it's the name of a program. > > While there's some precedent in Guix for using @code{} for marking up > package names when they'll be used mainly in actual source code > (e.g. @code{My::Perl::Module}), that's a specific case with a specific > rationale. > > A more suitable tag here would be @command{}. However, there seems to > be an informal(?) consensus not to use it when talking about the > package as a whole/project, but only when referring to the actual > command (binary) itself. Some descriptions don't follow that > convention, though, so it's at best a grey area. > > I don't think programme names should be marked up all purdy just for > being programmes. > > Kind regards, > > T G-R Alright. Hopefully I'll pick up more on these hints as I read more documentation source code. --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEEg7ZwOtzKO2lLzi2m5qXuPBlGeg0FAlt2fM0ACgkQ5qXuPBlG eg07+BAApClw6in8X5Fje0E2zxKck0nUQpFhB8tDYJunOc5GChvbBZhgLfNPtqCn nBoiS9EoCY9D5O9Ko4iErxN4836/OuOP3e2nf74w7GKj8FtXCPA7WccU9QBDqz14 XBprvF6ZILaySCec2KzTWnGDJDw1vVGXDt98KlAjixyjewjOr7xdaDMw/vuG1YP+ rO3t2M480/1czDyTSuouJA96dPU7MDrl4Val+U6CVbFTybxsn6bLqAYhjs/mrBX2 CYRbdiRyJHR9vT2BBV2OQlV8wBSnUHcDdfQBLJWRH+xybClK82XK4acEOhD7EXeH Bu9S6EHTAuhLy5TddvnD5MplXL3XPDotTue9H15yUB2ACh0eBdpV3OAYgVt/Af3t ibKECGufhmTuIcUm4Dyhx1ppx+zjeY3Ge6GQKPOlmfnIIQqbzdGLTqZWU0QYo75a j2KGubV3cVnazUTVLQHCG5tRW2uRd6lEQMsvNhW8GdqiIzEqE/MhhEE/uC0M2nYU 8afbK5h86T4zkkqOgN8SrdO6AUwfHihIARBz5L4/CgI04tsmoHz1s5uQySqX+vXh xbvNjmSsEQ2erCRphQiI55WqU5/6D1r0YmIptz0NRmziAhpf2BrIKG56+TB6MQ9r B2X2cRN9zkyhc5k+JteCXriD5Bt5ISfkrZVUv6ydgOPtkbDW0m8= =d+gI -----END PGP SIGNATURE----- --=-=-=--