Added docs/contrib/vpick.
[mmh] / man / next.man
1 .TH NEXT %manext1% "January 9, 2001" "%nmhversion%"
2 .\"
3 .\" %nmhwarning%
4 .\"
5 .SH NAME
6 next \- show the next message
7 .SH SYNOPSIS
8 .HP 5
9 .na
10 .B next 
11 .RI [ +folder ]
12 .RB [\-showproc
13 .IR program ]
14 .RB [ \-showmimeproc
15 .IR program ]
16 .RB [ \-header " | " \-noheader ]
17 .RB [ \-checkmime " | " \-nocheckmime ]
18 [switches\ for
19 .I showproc
20 or
21 .IR showmimeproc ]
22 .RB [ \-version ]
23 .RB [ \-help ]
24 .ad
25 .SH DESCRIPTION
26 .B Next
27 performs a
28 .B show
29 on the next message in the specified
30 (or current) folder.  Like
31 .BR show ,
32 it passes any switches on to
33 the program
34 .I showproc
35 or
36 .IR showmimeproc ,
37 which is called to list
38 the message.  This command is almost exactly equivalent to
39 .RB \*(lq show
40 .BR next \*(rq.
41 Consult the manual entry for
42 .IR show (1)
43 for all the
44 details.
45 .SH FILES
46 .fc ^ ~
47 .nf
48 .ta \w'%etcdir%/ExtraBigFileName  'u
49 ^$HOME/\&.mh\(ruprofile~^The user profile
50 .fi
51 .SH "PROFILE COMPONENTS"
52 .fc ^ ~
53 .nf
54 .ta 2.4i
55 .ta \w'ExtraBigProfileName  'u
56 ^Path:~^To determine the user's nmh directory
57 ^Current\-Folder:~^To find the default current folder
58 ^showproc:~^Program to show non-MIME messages
59 ^showmimeproc:~^Program to show MIME messages
60 .fi
61 .SH "SEE ALSO"
62 .IR prev (1),
63 .IR show (1)
64 .SH DEFAULTS
65 .nf
66 .RB ` +folder "' defaults to the current folder"
67 .RB ` \-checkmime '
68 .RB ` \-header '
69 .SH CONTEXT
70 If a folder is specified, it will become the current folder.  The message
71 that is shown (i.e., the next message in sequence) will become the
72 current message.
73 .SH BUGS
74 .B next
75 is really a link to the
76 .B show
77 program.  As a result, if
78 you make a link to
79 .B next
80 and that link is not called
81 .BR next ,
82 your link will act like
83 .B show
84 instead.  To circumvent this, add a
85 profile\-entry for the link to your
86 .B nmh
87 profile and add the argument
88 .I next
89 to the entry.