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