svn commit: r208795 - head/bin/date

[Brian Somers]

Author: brian
Date: Fri Jun  4 06:56:58 2010
New Revision: 208795
URL: http://svn.freebsd.org/changeset/base/208795

Log:
  Explain that setting an absolute day value can fail and that the month should
  usually be set first when using -v.
  
  Adjust an example that sets the day to 30 before setting the month to 3 in
  accordance with this approach as the example would always fail in February!
  
  PR:		147354
  MFC after:	2 weeks

Modified:
  head/bin/date/date.1

Modified: head/bin/date/date.1
==============================================================================
--- head/bin/date/date.1	Fri Jun  4 06:35:36 2010	(r208794)
+++ head/bin/date/date.1	Fri Jun  4 06:56:58 2010	(r208795)
@@ -32,7 +32,7 @@
 .\"     @(#)date.1	8.3 (Berkeley) 4/28/95
 .\" $FreeBSD$
 .\"
-.Dd June 2, 2007
+.Dd June 3, 2010
 .Dt DATE 1
 .Os
 .Sh NAME
@@ -219,6 +219,14 @@ When the date is adjusted to a specific 
 the resulting timezone will be set so that the date matches the earlier of
 the two times.
 .Pp
+It is not possible to adjust a date to an invalid absolute day, so using
+the switches
+.Fl v No 31d Fl v No 12m
+will simply fail five months of the year.
+It is therefore usual to set the month before setting the day; using
+.Fl v No 12m Fl v No 31d
+always works.
+.Pp
 Adjusting the date by months is inherently ambiguous because
 a month is a unit of variable length depending on the current date.
 This kind of date adjustment is applied in the most intuitive way.
@@ -339,9 +347,9 @@ will display the last day of February in
 .Pp
 .Dl "Tue Feb 29 03:18:00 GMT 2000"
 .Pp
-So will do the command:
+So will the command:
 .Pp
-.Dl "date -v30d -v3m -v0y -v-1m"
+.Dl "date -v3m -v30d -v0y -v-1m"
 .Pp
 because there is no such date as the 30th of February.
 .Pp