doc: date: group format sequences by function

* src/date.c (usage): Grouping alphabetically is less useful.
Suggested by Bruno Haible.

diff --git a/src/date.c b/src/date.c
index 98ff53eeea5fbf29f6a17fb65a9fff9ac5756ee9..88ea1279a3d616d51f0855e753ddcb3bceba07ec 100644 (file)
--- a/src/date.c
+++ b/src/date.c
@@ -202,125 +202,140 @@ FORMAT  Example    Description\n\
   %%    %           a literal %\n\
 "), stdout);
       fputs (_("\
-  %a    Sun         locale's abbreviated weekday name\n\
+  %n    \\n          a newline\n\
 "), stdout);
       fputs (_("\
-  %A    Sunday      locale's full weekday name\n\
+  %t    \\t          a tab\n\
 "), stdout);
+
+      fputs ("\n", stdout);
+
       fputs (_("\
-  %b    Mar         locale's abbreviated month name\n\
+  %C    20          century; like %Y, except omit last two digits\n\
 "), stdout);
       fputs (_("\
-  %B    March       locale's full month name\n\
+  %y    99          year (last two digits; 00..99)\n\
 "), stdout);
       fputs (_("\
-  %c    ...         locale's date and time (e.g., Thu Mar  3 23:05:25 2005)\n\
+  %Y    1999        year\n\
 "), stdout);
       fputs (_("\
-  %C    20          century; like %Y, except omit last two digits\n\
+  %g    99          year of ISO week number (last 2 digits; 00-99); see %G\n\
 "), stdout);
       fputs (_("\
-  %d    01          day of month\n\
+  %G    1999        year of ISO week number; normally useful only with %V\n\
 "), stdout);
+
+      fputs ("\n", stdout);
+
       fputs (_("\
-  %D    12/31/99    date (ambiguous); same as %m/%d/%y\n\
+  %a    Sun         locale's abbreviated weekday name\n\
 "), stdout);
       fputs (_("\
-  %e     1          day of month, space padded; same as %_d\n\
+  %A    Sunday      locale's full weekday name\n\
 "), stdout);
       fputs (_("\
-  %F    1999-12-31  full date; like %+4Y-%m-%d\n\
+  %b    Mar         locale's abbreviated month name\n\
 "), stdout);
       fputs (_("\
-  %g    99          year of ISO week number (last two digits; 00-99); see %G\n\
+  %h    Mar         same as %b\n\
 "), stdout);
       fputs (_("\
-  %G    1999        year of ISO week number; normally useful only with %V\n\
+  %B    March       locale's full month name\n\
 "), stdout);
       fputs (_("\
-  %h    Mar         same as %b\n\
+  %m    12          month (01..12)\n\
 "), stdout);
       fputs (_("\
-  %H    23          hour (00..23)\n\
+  %d    31          day of month (01..31)\n\
 "), stdout);
       fputs (_("\
-  %I    01          hour (01..12)\n\
+  %e     1          day of month, space padded; same as %_d\n\
 "), stdout);
       fputs (_("\
-  %j    365         day of year (001..366)\n\
+  %D    12/31/99    date (ambiguous); same as %m/%d/%y\n\
 "), stdout);
       fputs (_("\
-  %k     8          hour, space padded ( 0..23); same as %_H\n\
+  %F    1999-12-31  full date; like %+4Y-%m-%d\n\
 "), stdout);
       fputs (_("\
-  %l     9          hour, space padded ( 1..12); same as %_I\n\
+  %x    12/31/99    locale's date (can be ambiguous)\n\
 "), stdout);
       fputs (_("\
-  %m    12          month (01..12)\n\
+  %c    ...         locale's date and time (e.g., Thu Mar  3 23:05 2005)\n\
 "), stdout);
+
+      fputs ("\n", stdout);
+
       fputs (_("\
-  %M    59          minute (00..59)\n\
+  %H    23          hour (00..23)\n\
 "), stdout);
       fputs (_("\
-  %n    \\n          a newline\n\
+  %I    01          hour (01..12)\n\
 "), stdout);
       fputs (_("\
-  %N    123456789   nanoseconds (000000000..999999999)\n\
+  %k     8          hour, space padded ( 0..23); same as %_H\n\
 "), stdout);
       fputs (_("\
-  %p    PM          locale's equivalent of AM or PM; blank if not known\n\
+  %l     9          hour, space padded ( 1..12); same as %_I\n\
 "), stdout);
       fputs (_("\
-  %P    pm          like %p, but lower case\n\
+  %M    59          minute (00..59)\n\
 "), stdout);
       fputs (_("\
-  %q    4           quarter of year (1..4)\n\
+  %S    60          second (00..60)\n\
 "), stdout);
       fputs (_("\
-  %r    1:11:04 PM  locale's 12-hour clock time\n\
+  %N    123456789   nanoseconds (000000000..999999999)\n\
 "), stdout);
       fputs (_("\
-  %R    23:59       24-hour hour and minute; same as %H:%M\n\
+  %s    1970010100  seconds since the Epoch (1970-01-01 00:00 UTC)\n\
 "), stdout);
       fputs (_("\
-  %s    1970010100  seconds since the Epoch (1970-01-01 00:00 UTC)\n\
+  %p    PM          locale's equivalent of AM or PM; blank if not known\n\
 "), stdout);
       fputs (_("\
-  %S    60          second (00..60)\n\
+  %P    am          like %p, but lower case\n\
 "), stdout);
       fputs (_("\
-  %t    \\t          a tab\n\
+  %r    1:11:04 PM  locale's 12-hour clock time\n\
 "), stdout);
       fputs (_("\
-  %T    23:59:59    time; same as %H:%M:%S\n\
+  %R    23:59       24-hour hour and minute; same as %H:%M\n\
 "), stdout);
       fputs (_("\
-  %u    7           day of week (1..7); 1 is Monday\n\
+  %T    23:59:59    time; same as %H:%M:%S\n\
 "), stdout);
       fputs (_("\
-  %U    52          week number of year; Sunday as first day of week (00..53)\n\
+  %X    23:59:59    locale's time representation\n\
 "), stdout);
+
+      fputs ("\n", stdout);
+
       fputs (_("\
-  %V    52          ISO week number; Monday as first day of week (01..53)\n\
+  %j    365         day of year (001..366)\n\
 "), stdout);
       fputs (_("\
-  %W    52          week number of year; Monday as first day of week (00..53)\n\
+  %q    4           quarter of year (1..4)\n\
 "), stdout);
       fputs (_("\
-  %w    6           day of week (0..6); 0 is Sunday\n\
+  %u    7           day of week (1..7); 1 is Monday\n\
 "), stdout);
       fputs (_("\
-  %x    12/31/99    locale's date (can be ambiguous)\n\
+  %w    6           day of week (0..6); 0 is Sunday\n\
 "), stdout);
       fputs (_("\
-  %X    23:59:59    locale's time representation\n\
+  %U    52          week of year; Sunday as first day of week (00..53)\n\
 "), stdout);
       fputs (_("\
-  %y    99          year (last two digits; 00..99)\n\
+  %V    52          ISO week number; Monday as first day of week (01..53)\n\
 "), stdout);
       fputs (_("\
-  %Y    1999        year\n\
+  %W    52          week of year; Monday as first day of week (00..53)\n\
 "), stdout);
+
+      fputs ("\n", stdout);
+
       fputs (_("\
   %z     +0400      +hhmm numeric time zone\n\
 "), stdout);