From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:4830:134:3::10]:33998) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fqLOX-0006EY-Qk for guix-patches@gnu.org; Thu, 16 Aug 2018 12:45:10 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fqLOR-0001jB-Mv for guix-patches@gnu.org; Thu, 16 Aug 2018 12:45:09 -0400 Received: from debbugs.gnu.org ([208.118.235.43]:47747) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fqLOQ-0001iR-35 for guix-patches@gnu.org; Thu, 16 Aug 2018 12:45:03 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fqLOP-0005hg-Sp for guix-patches@gnu.org; Thu, 16 Aug 2018 12:45:01 -0400 Subject: [bug#32256] [PATCH] gnu: Add nudoku. Resent-Message-ID: References: <20180724120402.22409-1-ricardo.wurmus@mdc-berlin.de> <87bmatbvog.fsf@posteo.net> From: Tobias Geerinckx-Rice In-reply-to: <87bmatbvog.fsf@posteo.net> Date: Thu, 16 Aug 2018 18:45:11 +0200 Message-ID: <87sh3eclbc.fsf@tobias.gr> MIME-Version: 1.0 Content-Type: text/plain; format=flowed 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: Kei Kebreau Cc: 32256@debbugs.gnu.org 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