From: Thomas Roessler <roessler@does-not-exist.org>
Date: Tue, 6 Feb 2001 22:14:01 +0000 (+0000)
Subject: Document fuzzy dates.
X-Git-Tag: mutt-1-3-15-rel~12
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=061e8316ecbf39a4e21acff72f49bf5e84d26da8;p=mutt

Document fuzzy dates.
---

diff --git a/doc/manual.sgml.head b/doc/manual.sgml.head
index f8e06000..a316ac4d 100644
--- a/doc/manual.sgml.head
+++ b/doc/manual.sgml.head
@@ -1752,6 +1752,25 @@ messages <em/before/ the given date will be selected.  If you omit the maximum
 date will be selected.  If you specify a single date with no dash (``-''),
 only messages sent on the given date will be selected. 
 
+<bf/Error Margins/.  You can add error margins to absolute dates.
+An error margin is a sign (+ or -), followed by a digit, followed by
+one of the following units:
+<verb>
+y	years
+m	months
+w	weeks
+d	days
+</verb>
+As a special case, you can replace the sign by a ``*'' character,
+which is equivalent to giving identical plus and minus error margins.
+
+Example: To select any messages two weeks around January 15, 2001,
+you'd use the following pattern: 
+<tscreen><verb> 
+Limit to messages matching: ~d 1/1/2001*2w
+</verb></tscreen>
+
+
 <bf/Relative/.  This type of date is relative to the current date, and may
 be specified as:
 <itemize>
@@ -1774,6 +1793,8 @@ Example: to select messages less than 1 month old, you would use
 Limit to messages matching: ~d <1m
 </verb></tscreen>
 
+
+
 <bf/Note:/ all dates used when searching are relative to the
 <bf/local/ time zone, so unless you change the setting of your <ref
 id="index_format" name="&dollar;index&lowbar;format"> to include a
diff --git a/doc/muttrc.man.head b/doc/muttrc.man.head
index 5aa6675b..a3a17050 100644
--- a/doc/muttrc.man.head
+++ b/doc/muttrc.man.head
@@ -18,7 +18,7 @@
 .\"     along with this program; if not, write to the Free Software
 .\"     Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111, USA.
 .\"
-.TH muttrc 5 "May 2000" Unix "User Manuals"
+.TH muttrc 5 "February 2001" Unix "User Manuals"
 .SH NAME
 .PP
 muttrc \- Configuration file for the Mutt Mail User Agent
@@ -385,6 +385,28 @@ a dash matches the date given and any later point of time.  Two
 dates, separated by a dash, match any date which lies in the given
 range of time.
 .PP
+You can also modify any absolute date by giving an error range.  An
+error range consists of one of the characters
+.BR + ,
+.BR - ,
+.BR * ,
+followed by a positive number, followed by one of the unit
+characters
+.BR y ,
+.BR m ,
+.BR w ", or"
+.BR d ,
+specifying a unit of years, months, weeks, or days.  
+.B +
+increases the maximum date matched by the given interval of time,
+.B - 
+decreases the minimum date matched by the given interval of time, and
+.B *
+increases the maximum date and decreases the minimum date matched by
+the given interval of time.  It is possible to give multiple error
+margins, which cumulate.  Example:
+.B "1/1/2001-1w+2w*3d"
+.PP
 You can also specify offsets relative to the current date.  An
 offset is specified as one of the characters
 .BR < ,
@@ -395,9 +417,7 @@ characters
 .BR y ,
 .BR m ,
 .BR w ", or"
-.BR d ,
-specifying a unit of years, months, weeks, or days.  An offset which
-begins with the character
+.BR d .
 .B >
 matches dates which are older than the specified amount of time, an
 offset which begins with the character