bug#81442: Documentation Deficiency: printf man page lacks definition of format specifiers

Dmitri Seletski <[email protected]> Wed, 22 Jul 2026 15:45:59 +0100
Newsgroups gmane.comp.gnu.core-utils.bugs
Message-ID <[email protected]>
Fantastic!
Thanks!

On 22/07/2026 13:05, Pádraig Brady wrote:
>> On 20/07/2026 17:10, Pádraig Brady wrote:
>>> The "see also" has a reference to printf(3),
>>> which you can drill down to directly depending on you man page viewer,
>>> or view directly with `man 3 printf`.
>>>
>>> But I agree we should show that reference directly in the text.
>>>
>>> We need to be careful not to repeat too much info from the (large) 
>>> printf(3) page,
>>> but I also agree that we could provide a little more info here.
>>>
>>> I'll look at:
>>>
>>> Using our recently improved man table formatting to present a 
>>> conversion summary.
>>> Including at least mentioning that flags are supported.
>>> Also an EXAMPLES section would be useful here I think to show 
>>> supported combinations.
> I'll apply the attached later, which adds:
>
>   CONVERSION   Shell format example       Output
>
>   %s          '[%10s]' 'left pad'         [  left pad]
>   %s          '[%-10s]' 'right pad'       [right pad ]
>   %c %s       '%c %.3s' un unibyte        u uni
>   %d %i       "%'d ;%i04i" 1234 '-1'      1,234 ;-001
>   %o          '%#o' $((2#110100100))      0644
>   %u          '%u' 0xFFFFFFFF             4294967295
>   %x          '0x%08x' 11259375           0x00abcdef
>   %a %f       '%1$a %1$f' 0.0009765625    0x8p-13 0.000977
>   %e %f       '%1$e %1$f' 123.45678       1.234568e+02 123.456789
>   %g          '%1$g %1$.2g' 1.2345678e3   1234.57 1.2e+03
>   %b          '%b' 'food\bbar'            foobar
>   %q          '%q ' 'a' ';b' $'c\n'       a ';b' 'c'$'\n'
>
>
> Marking this as done.
>
> cheers,
> Padraig