GNU bug report logs - #53439
[PATCH] doc: Document search paths.

Previous Next

Full log

View this message in rfc822 format

From: Maxim Cournoyer <maxim.cournoyer <at> gmail.com>
To: Ludovic Courtès <ludo <at> gnu.org>
Cc: 53439 <at> debbugs.gnu.org
Subject: [bug#53439] [PATCH] doc: Document search paths.
Date: Tue, 25 Jan 2022 20:50:42 -0500

Hello!

[...]

> Regarding the truth value, I ended up in
> a00dff3ac113722a709dbe97a727777b3739a5c1 with hopefully clearer wording:
>
>   @item @code{file-pattern} (default: @code{#f})
>   This must be either @code{#f} or a regular expression specifying
>   files to be matched @emph{within} the sub-directories specified by the
>   @code{files} field.

That's explicit and avoid the issue altogether, I like it!

> I guess we’re nitpicking :-) but I like to have, on one hand, text in
> natural language with examples that conveys ideas in an informal way,
> and on the other hand, reference material (@deftp, @deffn, etc.) that’s
> rigorous.

I see; that makes sense.

Thanks for taking the time to adjust the final result!

Maxim

Previous Next

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