Re: [PATCH] nstrftime: better width support for %N, %z

[Bruno Haible]

Hi Paul,

> > If the change is intended, the documentation of `date` should be updated
> 
> Thanks for mentioning this. The change was intended, and I installed the 
> attached patch into the Coreutils documentation.

Where is %N of nstrftime documented? I don't see it documented in POSIX [1],
in the glibc manual [2], in the Linux manual pages [3], nor in the Gnulib
manual. I don't think the coreutils 'date' documentation is or should be
the reference manual for nstrftime().

lib/strftime.h is also rather unprecise: It only says

    Use __NS as the number of nanoseconds in the %N directive.

IMO it would make sense to document it in a separate node of the Gnulib
documentation.

Bruno

[1] https://pubs.opengroup.org/onlinepubs/9699919799/functions/strftime.html
[2] 
https://www.gnu.org/software/libc/manual/html_node/Formatting-Calendar-Time.html
[3] http://man7.org/linux/man-pages/man3/strftime.3.html