Removed unused local ncomps because gcc complained about it.
[mmh] / man / next.man
1 .\"
2 .\" %nmhwarning%
3 .\"
4 .TH NEXT %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
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 .BR show (1)
43 for all the
44 details.
45
46 .SH FILES
47 .fc ^ ~
48 .nf
49 .ta \w'%etcdir%/ExtraBigFileName  'u
50 ^$HOME/\&.mh\(ruprofile~^The user profile
51 .fi
52
53 .SH "PROFILE COMPONENTS"
54 .fc ^ ~
55 .nf
56 .ta 2.4i
57 .ta \w'ExtraBigProfileName  'u
58 ^Path:~^To determine the user's nmh directory
59 ^Current\-Folder:~^To find the default current folder
60 ^showproc:~^Program to show non-MIME messages
61 ^showmimeproc:~^Program to show MIME messages
62 .fi
63
64 .SH "SEE ALSO"
65 show(1), prev(1)
66
67 .SH DEFAULTS
68 .nf
69 .RB ` +folder "' defaults to the current folder"
70 .RB ` \-checkmime '
71 .RB ` \-header '
72
73 .SH CONTEXT
74 If a folder is specified, it will become the current folder.  The message
75 that is shown (i.e., the next message in sequence) will become the
76 current message.
77
78 .SH BUGS
79 .B next
80 is really a link to the
81 .B show
82 program.  As a result, if
83 you make a link to
84 .B next
85 and that link is not called
86 .BR next ,
87 your link will act like
88 .B show
89 instead.  To circumvent this, add a
90 profile\-entry for the link to your
91 .B nmh
92 profile and add the argument
93 .I next
94 to the entry.