Return to mhpath.me CVS log

Up to [CSRG BSD Unix] / 43BSDReno / share / doc / usd / 08.mh

Annotation of 43BSDReno/share/doc/usd/08.mh/mhpath.me, revision 1.1

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

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