Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
MARK(1)			    General Commands Manual		       MARK(1)

       mark - manipulate nmh message sequences

       mark [-help] [-version] [+folder] [msgs]	[-sequence name	...]  [-add |
	    -delete] [-list] [-public |	-nopublic] [-zero | -nozero]

       The mark	command	manipulates message sequences by  adding  or  deleting
       message	numbers	 from folder-specific message sequences, or by listing
       those sequences and messages.

       A message sequence is a keyword,	just like one of the  "reserved"  mes-
       sage  names,  such as "first" or	"next".	 Unlike	the "reserved" message
       names, which have a fixed semantics on a	per-folder basis,  the	seman-
       tics of a message sequence may be defined, modified, and	removed	by the
       user.  Message sequences	are folder-specific, e.g., the	sequence  name
       "seen"  in  the	context	 of folder "+inbox" need not have any relation
       whatsoever to the sequence of the same name in a	folder of a  different

       Three action switches direct the	operation of mark.  These switches are
       mutually	exclusive: the last occurrence of any of  them	overrides  any
       previous	occurrence of the other	two.

       The  -add switch	tells mark to add messages to sequences	or to create a
       new sequence.  For each sequence	named via the -sequence	name  argument
       (which must occur at least once)	the messages named via msgs (which de-
       faults to "cur" if no msgs are given), are added	to the sequence.   The
       messages	 to  be	 added	need  not be absent from the sequence.	If the
       -zero switch is specified, the sequence will be emptied prior to	adding
       the  messages.	Hence,	-add  -zero means that each sequence should be
       initialized to the indicated messages, while -add  -nozero  means  that
       each sequence should be appended	to by the indicated messages.

       The -delete switch tells	mark to	delete messages	from sequences,	and is
       the dual	of -add.  For each of the named	sequences, the named  messages
       are  removed  from  the	sequence.   These messages need	not be already
       present in the sequence.	 If the	-zero switch is	 specified,  then  all
       messages	 in  the  folder are added to the sequence (first creating the
       sequence, if necessary) before removing the messages.   Hence,  -delete
       -zero means that	each sequence should contain all messages except those
       indicated, while	-delete	-nozero	means that only	the indicated messages
       should  be  removed from	each sequence.	As expected, the command "mark
       -sequence foo -delete all" empties the sequence	"foo",	and  therefore
       removes that sequence from the current folder's list of sequences.

       When  creating  or  modifying  sequences,  you can specify the switches
       -public or -nopublic to force the new or	modified sequences to be "pub-
       lic"  or	 "private".   The  switch -public indicates that the sequences
       should be made "public".	 These sequences will then be readable by  all
       nmh  users  with	permission to read the relevant	folders.  In contrast,
       the -nopublic switch indicates that the sequences should	be made	 "pri-
       vate",  and  will  only	be  accessible	by  you.   If neither of these
       switches	is specified, then existing sequences will maintain their cur-
       rent  status,  and  new	sequences will default to "public" if you have
       write permission	for the	relevant folder.  Check	the mh-sequence(5) man
       page  for  more details about the difference between "public" and "pri-
       vate" sequences.

       The -list switch	tells mark to list both	the sequences defined for  the
       folder  and  the	 messages  associated with those sequences.  mark will
       list the	name of	each sequence given by -sequence name and the messages
       associated  with	 that sequence.	 If the	sequence is private, this will
       also be indicated.  If  no  sequence  is	 specified  by	the  -sequence
       switch,	then  all sequences for	this folder will be listed.  The -zero
       switch does not affect the operation of -list.

       The restrictions	on sequences are:

       o The name used to denote a message sequence must consist of an	alpha-
	 betic character followed by zero or more alphanumeric characters, and
	 cannot	be one of the (reserved) message names "new", "first", "last",
	 "all",	"next",	or "prev".

       o Message ranges	with user-defined sequence names are restricted	to the
	 form "name:n",	"name:+n", or "name:-n", and refer  to	the  first  or
	 last  `n'  messages of	the sequence `name', respectively.  Constructs
	 of the	form "name1-name2" are forbidden for user defined sequences.

       $HOME/.mh_profile   The user's profile.

       Path:		   To determine	the user's nmh directory.
       Current-Folder:	   To find the default current folder.

       flist(1), pick(1), mh-sequence(5)

       +folder		   The current folder.
       -add		   If -sequence	is specified, -list otherwise.
       msgs		   The current message,	or all if -list	is specified.

       If a folder is given, it	will become the	current	folder.

       Use flist to find folders with a	given  sequence,  and  "pick  sequence
       -list"  to enumerate those messages in the sequence (such as for	use by
       a shell script).

nmh-1.7.1			  2013-03-31			       MARK(1)


Want to link to this manual page? Use this URL:

home | help