{
    "content": [
        {
            "type": "text",
            "text": "# mhpath (man)\n\n## NAME\n\nmhpath - print full pathnames of nmh messages and folders\n\n## SYNOPSIS\n\nmhpath [-help] [-version] [+folder] [msgs]\n\n## DESCRIPTION\n\nmhpath  expands  and  sorts the message list `msgs' and writes the full pathnames of the mes‐\nsages to the standard output, separated by newlines.  If no `msgs' are specified, mhpath out‐\nputs  the  current  mail  folder's  pathname  instead.  If the only argument is `+', your nmh\n“Path” is output; this can be useful in shell scripts.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **FILES**\n- **PROFILE COMPONENTS**\n- **SEE ALSO**\n- **DEFAULTS**\n- **CONTEXT**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "mhpath",
        "section": "",
        "mode": "man",
        "summary": "mhpath - print full pathnames of nmh messages and folders",
        "synopsis": "mhpath [-help] [-version] [+folder] [msgs]",
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [],
        "examples": [],
        "see_also": [
            {
                "name": "folder",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/folder/1/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 89,
                "subsections": []
            },
            {
                "name": "FILES",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "PROFILE COMPONENTS",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "DEFAULTS",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "CONTEXT",
                "lines": 5,
                "subsections": []
            }
        ],
        "sections": {
            "NAME": {
                "content": "mhpath - print full pathnames of nmh messages and folders\n",
                "subsections": []
            },
            "SYNOPSIS": {
                "content": "mhpath [-help] [-version] [+folder] [msgs]\n",
                "subsections": []
            },
            "DESCRIPTION": {
                "content": "mhpath  expands  and  sorts the message list `msgs' and writes the full pathnames of the mes‐\nsages to the standard output, separated by newlines.  If no `msgs' are specified, mhpath out‐\nputs  the  current  mail  folder's  pathname  instead.  If the only argument is `+', your nmh\n“Path” is output; this can be useful in shell scripts.\n\nIn contrast with other nmh commands, a message argument to mhpath may often be  intended  for\nwriting.  Because of this:\n\n1)  the  name “new” has been added to mhpath's list of reserved message names (the others are\n“first”, “last”, “prev”, “next”, “cur”, and “all”).  The new message is equivalent to the\nmessage  after the last message in a folder (and equivalent to 1 in a folder without mes‐\nsages).  The “new” message may not be used as part of a message range.\n\n2)  Within a message list, the following designations may refer to messages that do  not  ex‐\nist:  a  single  numeric message name, the single message name “cur”, and (obviously) the\nsingle message name “new”.  All other message designations must refer to at least one ex‐\nisting message, if the folder contains messages.\n\n3)  An empty folder is not, in itself, an error.\n\nA message number less than that of the smallest existing message in a folder is treated as if\nthe message already exists.  A message number greater than that of the highest existing  mes‐\nsage in a folder causes an “out of range” error message to be displayed.\n\nAs  part  of  a  range designation that contains messages that do exist, message numbers less\nthan the smallest, or greater than the highest, existing message in a folder are ignored.\n\nExamples: The current folder foo contains messages 3 5 6.  Cur is 4.\n\n% mhpath\n/r/phyl/Mail/foo\n\n% mhpath all\n/r/phyl/Mail/foo/3\n/r/phyl/Mail/foo/5\n/r/phyl/Mail/foo/6\n\n% mhpath 2001\nmhpath: message 2001 out of range 1-6\n\n% mhpath 1-2001\n/r/phyl/Mail/foo/3\n/r/phyl/Mail/foo/5\n/r/phyl/Mail/foo/6\n\n% mhpath new\n/r/phyl/Mail/foo/7\n\n% mhpath last new\n/r/phyl/Mail/foo/6\n/r/phyl/Mail/foo/7\n\n% mhpath last-new\nmhpath: bad message list last-new\n\n% mhpath cur\n/r/phyl/Mail/foo/4\n\n% mhpath 1-2\nmhpath: no messages in range 1-2\n\n% mhpath first:2\n/r/phyl/Mail/foo/3\n/r/phyl/Mail/foo/5\n\n% mhpath 1 2\n/r/phyl/Mail/foo/1\n/r/phyl/Mail/foo/2\n\nmhpath is also useful in backquoted operations:\n\n% cd `mhpath +inbox`\n\n% echo `mhpath +`\n/r/phyl/Mail\n\nBecause mhpath expands and sorts [msgs].  the command\n\nmv `mhpath 501 500`\n\nto will not move 501 to 500; quite the reverse.  But\n\nmv `mhpath 501` `mhpath 500`\n\nwill do the trick.\n\nOut-of-range message 0 produces a different error message  than  large  out-of-range  message\nnumbers.  But both cause mhpath to exit with non-zero status.\n",
                "subsections": []
            },
            "FILES": {
                "content": "$HOME/.mhprofile    The user profile\n",
                "subsections": []
            },
            "PROFILE COMPONENTS": {
                "content": "Path:                To determine the user's nmh directory\nCurrent-Folder:      To find the default current folder\n",
                "subsections": []
            },
            "SEE ALSO": {
                "content": "folder(1)\n",
                "subsections": []
            },
            "DEFAULTS": {
                "content": "`+folder' defaults to the current folder\n`msgs' defaults to none\n",
                "subsections": []
            },
            "CONTEXT": {
                "content": "None\n\n\n\nnmh-1.7.1                                    2012-02-18                                  MHPATH(1mh)",
                "subsections": []
            }
        }
    }
}