X-Git-Url: http://www.git.cypherpunks.ru/?a=blobdiff_plain;f=doc%2Fcmd%2Fnncp-rm.texi;h=4444c3347dcd81a932bfcc77b89d44cf78f2d412;hb=a62ea6902fb8751501a724bd20db4baddadc7dba;hp=8d2db29f26cb009229d81ffd9ed34926c127c266;hpb=ab7c7eca0e53661f0ba904c2a6ba752990bea367;p=nncp.git

diff --git a/doc/cmd/nncp-rm.texi b/doc/cmd/nncp-rm.texi
index 8d2db29..4444c33 100644
--- a/doc/cmd/nncp-rm.texi
+++ b/doc/cmd/nncp-rm.texi
@@ -1,53 +1,65 @@
 @node nncp-rm
+@pindex nncp-rm
 @section nncp-rm
 
 @example
-$ nncp-rm [options] -tmp
+$ nncp-rm [options] [-older X] -tmp
 $ nncp-rm [options] -lock
-$ nncp-rm [options] @{-all|-node NODE@} -part
-$ nncp-rm [options] @{-all|-node NODE@} -seen
-$ nncp-rm [options] @{-all|-node NODE@} -nock
-$ nncp-rm [options] @{-all|-node NODE@} -hdr
-$ nncp-rm [options] @{-all|-node NODE@} -area
-$ nncp-rm [options] @{-all|-node NODE@} [-rx] [-tx]
-$ nncp-rm [options] @{-all|-node NODE@} -pkt PKT
+$ nncp-rm [options] [-older X] @{-all|-node NODE@} -part
+$ nncp-rm [options] [-older X] @{-all|-node NODE@} -seen
+$ nncp-rm [options] [-older X] @{-all|-node NODE@} -nock
+$ nncp-rm [options] [-older X] @{-all|-node NODE@} -area
+$ nncp-rm [options] [-older X] @{-all|-node NODE@} @{-rx|-tx@} [-hdr]
+$ nncp-rm [options] [-older X] @{-all|-node NODE@} -pkt <<EOF
+PKT1
+PKT2
+NODEx/PKT3
+@dots{}
+EOF
 @end example
 
-This command is aimed to delete various files from your spool directory:
+This command is aimed to delete various files from your spool directory.
+@option{-older} option may limit the subset of files to be deleted for
+most commands.
 
 @itemize
 
-@item If @option{-tmp} option is specified, then it will delete all
+@item If @option{-tmp} option is specified, then it will delete
 temporary files in @file{spool/tmp} directory. Files may stay in it when
-commands like @ref{nncp-file} fail for some reason.
+commands like @command{@ref{nncp-file}} fail for some reason.
 
 @item If @option{-lock} option is specified, then all @file{.lock} files
 will be deleted in your spool directory.
 
-@item If @option{-pkt} option is specified, then @file{PKT} packet (its
-Base32 name) will be deleted. This is useful when you see some packet
-failing to be processed.
+@item If @option{-pkt} option is specified, then only the specified list
+of packets (Base32 names) will be deleted. It is read from @code{stdin}.
+This could be useful when you see some packet failing to be processed.
+Packet identifiers may have "directories" prepended, that are ignored.
 
-@item When either @option{-rx} or @option{-tx} options are specified
-(maybe both of them), then delete all packets from that given queues.
+@item @option{-rx} and @option{-tx} options will delete packets in
+corresponding queue directories. Corresponding @file{hdr/} files are
+also automatically deleted.
 
-@item @option{-part} option deletes @file{.part}ly downloaded files.
+@item @option{-part} option limits that to @file{.part}ly downloaded packets.
 
-@item @option{-seen} option deletes @file{.seen} files. But it does not
-apply to @ref{Multicast, multicast areas} @file{.seen} ones!
+@item @option{-nock} option limits that to non-checksummed
+(non-verified) @file{.nock} files.
 
-@item @option{-nock} option deletes non-checksummed (non-verified)
-@file{.nock} files.
+@item @option{-seen} option deletes @file{seen/} files.
 
-@item @option{-hdr} option deletes cached @file{.hdr} files.
+@item @option{-hdr} option deletes cached @file{hdr/} files.
 
-@item @option{-area} option deletes @file{.seen} files in @file{area/}
-subdirectories.
+@item @option{-area} option deletes seen files in @file{area/} subdirectories.
 
 @end itemize
 
 @option{-dryrun} option just prints what will be deleted.
 
-You can also select files that only have modification date older than specified
-@option{-older} time units (@code{10s} (10 seconds), @code{5m} (5 minutes),
-@code{12h} (12 hours), @code{2d} (2 days)).
+@option{-older} accepts an integer with appended time unit:
+
+@itemize
+@item @code{10s} -- 10 seconds
+@item @code{5m} -- 5 minutes
+@item @code{12h} -- 12 hours
+@item @code{2d} -- 2 days
+@end itemize