date --help improvements

[Dan Jacobson]

$ date --help
  %T   time, 24-hour (hh:mm:ss)
  %X   locale's time representation (%H:%M:%S)
one quickly perusing this information might think they are the same, but

$ date +"%X   locale's time representation (%H:%M:%S)"
05:16:52 AM   locale's time representation (05:16:52)

Therefore, a note should be made about the possible popping up of
AM/PM, as "(%H:%M:%S)" doesn't visually clue the user about that.  Yes, my
$ echo $LC_TIME
zh_TW.Big5
but that's no excuse not to add a tiny note to that sentence more than
just "locale".

$ LC_TIME=C date +"%c locale's date and time (Sat Nov 04 12:02:33 EST 1989)"
Wed Mar  7 05:18:12 2001 locale's date and time (Sat Nov 04 12:02:33 EST 1989)
hmmm, timezone went bye bye.  In my locale, however, I get a bonus AM
and timezone... Maybe some notes in brackets should be added to the
sample string to tip the user to some fields that might pop up.  By
the way.  Can you pick a later example string than "12:02:33" as the
reader wonders if it will get PM's or not later, etc...
------
Also add notes to man page & info if not already.
-- 
http://www.geocities.com/jidanni Tel886-4-25854780 e-mail:restore .com.