Return to mhpath.rf CVS log

Up to [CSRG BSD Unix] / 43BSD / contrib / mh / conf / doc

Annotation of 43BSD/contrib/mh/conf/doc/mhpath.rf, revision 1.1

1.1     ! root        1: .\"    @(MHWARNING)
        !             2: .TH MHPATH 1 "April 22, 1986" MH [mh.6]
        !             3: .UC 6
        !             4: .SH NAME
        !             5: mhpath \- print full pathnames of MH messages and folders
        !             6: .SH SYNOPSIS
        !             7: .in +.5i
        !             8: .ti -.5i
        !             9: mhpath
        !            10: \%[+folder] \%[msgs]
        !            11: \%[\-help]
        !            12: .in -.5i
        !            13: .SH DESCRIPTION
        !            14: \fIMhpath\fR expands and sorts the message list `msgs' and writes
        !            15: the full pathnames of the messages to the standard output
        !            16: separated by newlines.
        !            17: If no `msgs' are specified,
        !            18: \fImhpath\fR outputs the folder pathname instead.
        !            19: 
        !            20: Contrasted with other MH commands, a message argument to \fImhpath\fR
        !            21: may often be intended for \fIwriting\fR.
        !            22: Because of this:
        !            23: 1) the name \*(lqnew\*(rq has been added to \fImhpath\fR's list of
        !            24: reserved message names
        !            25: (the others are \*(lqfirst\*(rq, \*(lqlast\*(rq, \*(lqprev\*(rq,
        !            26: \*(lqnext\*(rq, \*(lqcur\*(rq, and \*(lqall\*(rq).
        !            27: The new message is equivalent to the message after the
        !            28: last message in a folder
        !            29: (and equivalent to 1 in a folder without messages).
        !            30: The \*(lqnew\*(rq message may not be used as part of a message range.
        !            31: 2) Within a message list,
        !            32: the following designations may refer to messages that do not exist:
        !            33: a single numeric message name,
        !            34: the single message name \*(lqcur\*(rq,
        !            35: and (obviously) the single message name \*(lqnew\*(rq.
        !            36: All other message designations must refer to at least one existing message.
        !            37: 3) An empty folder is not in itself an error.
        !            38: 
        !            39: Message numbers greater than the highest existing message in a folder as
        !            40: part of a range designation are replaced with the next free message number.
        !            41: 
        !            42: Examples: The current folder foo contains messages 3 5 6.
        !            43: Cur is 4.
        !            44: 
        !            45: .nf
        !            46: .in +.5i
        !            47: % mhpath
        !            48: /r/phyl/Mail/foo
        !            49: 
        !            50: % mhpath all
        !            51: /r/phyl/Mail/foo/3
        !            52: /r/phyl/Mail/foo/5
        !            53: /r/phyl/Mail/foo/6
        !            54: 
        !            55: % mhpath 2001
        !            56: /r/phyl/Mail/foo/7
        !            57: 
        !            58: % mhpath 1\-2001
        !            59: /r/phyl/Mail/foo/3
        !            60: /r/phyl/Mail/foo/5
        !            61: /r/phyl/Mail/foo/6
        !            62: 
        !            63: % mhpath new
        !            64: /r/phyl/Mail/foo/7
        !            65: 
        !            66: % mhpath last new
        !            67: /r/phyl/Mail/foo/6
        !            68: /r/phyl/Mail/foo/7
        !            69: 
        !            70: % mhpath last\-new
        !            71: bad message list \*(lqlast\-new\*(rq.
        !            72: 
        !            73: % mhpath cur
        !            74: /r/phyl/Mail/foo/4
        !            75: 
        !            76: % mhpath 1\-2
        !            77: no messages in range \*(lq1\-2\*(rq.
        !            78: 
        !            79: % mhpath first:2
        !            80: /r/phyl/Mail/foo/3
        !            81: /r/phyl/Mail/foo/5
        !            82: 
        !            83: % mhpath 1 2
        !            84: /r/phyl/Mail/foo/1
        !            85: /r/phyl/Mail/foo/2
        !            86: .in -.5i
        !            87: .fi
        !            88: 
        !            89: \fIMHpath\fR is also useful in back\-quoted operations:
        !            90: 
        !            91: .nf
        !            92: .in +.5i
        !            93: % cd `mhpath +inbox`
        !            94: 
        !            95: % echo `mhpath +`
        !            96: /r/phyl/Mail
        !            97: .in -.5i
        !            98: .fi
        !            99: .Fi
        !           100: ^$HOME/\&.mh\(ruprofile~^The user profile
        !           101: .Pr
        !           102: ^Path:~^To determine the user's MH directory
        !           103: .Ps
        !           104: ^Current\-Folder:~^To find the default current folder
        !           105: .Sa
        !           106: folder(1)
        !           107: .De
        !           108: `+folder' defaults to the current folder
        !           109: .Ds
        !           110: `msgs' defaults to none
        !           111: .Co
        !           112: None
        !           113: .Bu
        !           114: Like all MH commands, \fImhpath\fR expands and sorts \%[msgs].
        !           115: So don't expect
        !           116: 
        !           117: .ti +.5i
        !           118: mv `mhpath 501 500`
        !           119: 
        !           120: to move 501 to 500.
        !           121: Quite the reverse.  But
        !           122: 
        !           123: .ti +.5i
        !           124: mv `mhpath 501` `mhpath 500`
        !           125: 
        !           126: will do the trick.
        !           127: 
        !           128: Out of range message 0 is treated far more severely than large out of
        !           129: range message numbers.
        !           130: .En

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.