Subject: bug#31945: closed (Re: bug#31945: 27.0.50; Readability of format docstring)

From: [email-masked] (GNU bug Tracking System)
Date: Sat, 23 Jun 2018 12:36:02 +0000

Your bug report

#31945: 27.0.50; Readability of format docstring

which was filed against the emacs package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to [email-masked].

-- 
31945: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=31945
GNU Bug Tracking System
Contact [email-masked] with problems

Subject: Re: bug#31945: 27.0.50; Readability of format docstring
From: Eli Zaretskii <[email-masked]>
To: Andreas Röhler <[email-masked]>
Cc: [email-masked]
Date: Sat, 23 Jun 2018 15:35:41 +0300
List-Id: <debbugs-submit.debbugs.gnu.org>

> From: Andreas Röhler <[email-masked]>
> Date: Sat, 23 Jun 2018 08:30:57 +0200
> 
> C-h f format RET
> 
> 
> Docu of format arguments starts commonly with argument in column 0.
> %x however starts after comma inside a line:
> 
> "%s means print a string argument.  Actually, prints any object, with 
> ‘princ’.
> %d means print as signed number in decimal.
> %o means print as unsigned number in octal, %x as unsigned number in hex.
> "
> 
> Suggest to move docu of %x to column zero too.

Thanks, done.

Subject: 27.0.50; Readability of format docstring
From: Andreas Röhler <[email-masked]>
To: [email-masked]
Date: Sat, 23 Jun 2018 08:30:57 +0200
List-Id: <debbugs-submit.debbugs.gnu.org>

C-h f format RET

Docu of format arguments starts commonly with argument in column 0.
%x however starts after comma inside a line:

"%s means print a string argument.  Actually, prints any object, with 
‘princ’.
%d means print as signed number in decimal.
%o means print as unsigned number in octal, %x as unsigned number in hex.
"

Suggest to move docu of %x to column zero too.
Maybe consider to sort arguments alphabetically.

In GNU Emacs 27.0.50 (build 1, i686-pc-linux-gnu, GTK+ Version 3.14.5)
  of 2018-05-29