X-Git-Url: http://git.marmaro.de/?a=blobdiff_plain;f=man%2Fsortm.man;h=d7df7520fb49cead90801200ee496f96687e3694;hb=cbce5e434f84af560946e16709d3c2ad10eb8942;hp=47dcee3ebf7efc6c1894d805bbebf8bd98103ae6;hpb=ec251f5102aca59d99e09d07d10906d99514f2b4;p=mmh

diff --git a/man/sortm.man b/man/sortm.man
index 47dcee3..d7df752 100644
--- a/man/sortm.man
+++ b/man/sortm.man
@@ -1,7 +1,7 @@
+.TH SORTM %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .\"
 .\" %nmhwarning%
 .\"
-.TH SORTM %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 sortm \- sort messages
 .SH SYNOPSIS
@@ -10,6 +10,7 @@ sortm \- sort messages
 .B sortm
 .RI [ +folder ]
 .RI [ msgs ]
+.RB [ \-all | \-noall ]
 .RB [ \-datefield
 .IR field ]
 .RB [ \-textfield
@@ -27,6 +28,21 @@ sortm \- sort messages
 sorts the specified messages in the named folder according
 to the chronological order of the \*(lqDate:\*(rq field of each message.
 .PP
+If no messages are specified, the default is all messages in the folder.
+However, if no messages are specified and the
+.B \-noall
+switch is enabled, then
+.B sortm
+reports that as an error and exits with non-zero status.
+.B \-noall
+is most useful in the user's profile, to avoid inadvertant sorting of
+an entire folder.  The
+.B \-all
+switch can then be used on the command line to disable it.  Of course,
+a message specification of
+.I all
+can be used in any case.
+.PP
 The
 .B \-verbose
 switch directs
@@ -73,7 +89,7 @@ makes the limit infinity.
 With
 .B \-limit
 .IR 0 ,
-the sort is instead made textfield\-major, date\-minor.
+the sort is instead simply textfield\-major.
 .PP
 For example, to order a folder by date-major, grouping messages with
 the same subject on the same date together, use:
@@ -81,14 +97,12 @@ the same subject on the same date together, use:
 .RS 5
 sortm -textfield subject +folder
 .RE
-
 .SH FILES
 .fc ^ ~
 .nf
 .ta \w'%etcdir%/ExtraBigFileName  'u
 ^$HOME/\&.mh\(ruprofile~^The user profile
 .fi
-
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
@@ -97,26 +111,23 @@ sortm -textfield subject +folder
 ^Path:~^To determine the user's nmh directory
 ^Current\-Folder:~^To find the default current folder
 .fi
-
 .SH "SEE ALSO"
 folder(1)
-
 .SH DEFAULTS
 .nf
 .RB ` +folder "' defaults to the current folder"
-.RB ` msgs"' defaults to all"
+.RB ` msgs"' defaults to all without -noall, no default with -noall"
+.RB ` \-all '
 .RB ` \-datefield "' defaults to date"
 .RB ` \-notextfield '
 .RB ` \-noverbose '
 .RB ` \-nolimit '
 .fi
-
 .SH CONTEXT
 If a folder is given, it will become the current folder.  If the current
 message is moved,
 .B sortm
 will preserve its status as current.
-
 .SH HISTORY
 Timezones used to be ignored when comparing dates: they aren't any more.
 .PP
@@ -130,7 +141,6 @@ sorting).  This was a bug, and has been fixed.  To compress the message
 numbering in a folder, use
 .RB \*(lq "folder\ \-pack" \*(rq
 as always.
-
 .SH BUGS
 If
 .B sortm