GNU bug report logs - #32256
[PATCH] gnu: Add nudoku.

Previous Next

Full log

View this message in rfc822 format

From: Tobias Geerinckx-Rice <me <at> tobias.gr>
To: Kei Kebreau <kkebreau <at> posteo.net>
Cc: 32256 <at> debbugs.gnu.org
Subject: [bug#32256] [PATCH] gnu: Add nudoku.
Date: Thu, 16 Aug 2018 18:45:11 +0200

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

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.