mpack_src/mpack-1.6-4/unixpk.man

.TH MPACK 1
.SH NAME
mpack \- pack a file in MIME format
.SH SYNOPSIS
.B mpack
[
.B \-a
]
[
.B \-s
.I subject
]
[
.B \-d
.I descriptionfile
]
[
.B \-m
.I maxsize
]
[
.B \-c
.I content-type
]
.I file
.I "address \&..."
.br
.B mpack
[
.B \-a
]
[
.B \-s
.I subject
]
[
.B \-d
.I descriptionfile
]
[
.B \-m
.I maxsize
]
[
.B \-c
.I content-type
]
.B \-o
.I outputfile
.I file
.br
.B mpack
[
.B \-a
]
[
.B \-s
.I subject
]
[
.B \-d
.I descriptionfile
]
[
.B \-m
.I maxsize
]
[
.B \-c
.I content-type
]
.B \-n
.I newsgroups
.I file
.SH DESCRIPTION
The 
.I mpack
program encodes the 
the named file in one or more MIME messages.
The resulting messages are mailed to one or more recipients,
written to a named file or set of files, or posted to a set of
newsgroups.
.PP
.SH OPTIONS
.TP
.BI \-a
Set the Content-Disposition to attachment.  If \-a is not used
the Content-Disposition is inline.
.TP
.BI \-s " subject"
Set the 
.B Subject
header field to
.IR Subject .
By default,
.B mpack
will prompt for the contents of the subject header.
.TP
.BI \-d " descriptionfile
Include the contents of the file
.I descriptionfile
in an introductory section at the beginning of the first
generated message.
.TP
.BI \-m " maxsize"
Split the message (if necessary) into partial messages, each not
exceeding
.I maxsize
characters.  The default limit is the value of the 
.B SPLITSIZE
environment variable, or no limit if the environment variable
does not exist.
Specifying a 
.I maxsize
of 0 means there is no limit to the size of the generated message.
.TP
.BI \-c " content-type"
Label the included file as being of MIME type
.IR content-type ,
which must be a subtype of 
.BR application ,
.BR audio ,
.BR image ,
or 
.BR video .
If this switch is not given,
.B mpack
examines the file to determine its type.
.TP
.BI \-o " outputfile"
Write the generated message to the file
.IR outputfile .
If the message has to be split, the partial messages will instead be
written to the files
.IR outputfile .01,
.IR outputfile .02,
etc.
.TP
.BI \-n " newsgroups"
Post the generated message(s) to the comma-separated netnews
.IR newsgroups .
.TP
.I file
Encode the named
.IR file .
.TP
.I "address \&..."
Mail the generated messages to the specified addresses.
.SH ENVIRONMENT
.TP
.B TMPDIR
Directory to store temporary files.  Default is /var/tmp.
.TP
.B SPLITSIZE
Default value of the -m switch.
1	.TH MPACK 1
2	.SH NAME
3	mpack \- pack a file in MIME format
4	.SH SYNOPSIS
5	.B mpack
6	[
7	.B \-a
8	]
9	[
10	.B \-s
11	.I subject
12	]
13	[
14	.B \-d
15	.I descriptionfile
16	]
17	[
18	.B \-m
19	.I maxsize
20	]
21	[
22	.B \-c
23	.I content-type
24	]
25	.I file
26	.I "address \&..."
27	.br
28	.B mpack
29	[
30	.B \-a
31	]
32	[
33	.B \-s
34	.I subject
35	]
36	[
37	.B \-d
38	.I descriptionfile
39	]
40	[
41	.B \-m
42	.I maxsize
43	]
44	[
45	.B \-c
46	.I content-type
47	]
48	.B \-o
49	.I outputfile
50	.I file
51	.br
52	.B mpack
53	[
54	.B \-a
55	]
56	[
57	.B \-s
58	.I subject
59	]
60	[
61	.B \-d
62	.I descriptionfile
63	]
64	[
65	.B \-m
66	.I maxsize
67	]
68	[
69	.B \-c
70	.I content-type
71	]
72	.B \-n
73	.I newsgroups
74	.I file
75	.SH DESCRIPTION
76	The
77	.I mpack
78	program encodes the
79	the named file in one or more MIME messages.
80	The resulting messages are mailed to one or more recipients,
81	written to a named file or set of files, or posted to a set of
82	newsgroups.
83	.PP
84	.SH OPTIONS
85	.TP
86	.BI \-a
87	Set the Content-Disposition to attachment. If \-a is not used
88	the Content-Disposition is inline.
89	.TP
90	.BI \-s " subject"
91	Set the
92	.B Subject
93	header field to
94	.IR Subject .
95	By default,
96	.B mpack
97	will prompt for the contents of the subject header.
98	.TP
99	.BI \-d " descriptionfile
100	Include the contents of the file
101	.I descriptionfile
102	in an introductory section at the beginning of the first
103	generated message.
104	.TP
105	.BI \-m " maxsize"
106	Split the message (if necessary) into partial messages, each not
107	exceeding
108	.I maxsize
109	characters. The default limit is the value of the
110	.B SPLITSIZE
111	environment variable, or no limit if the environment variable
112	does not exist.
113	Specifying a
114	.I maxsize
115	of 0 means there is no limit to the size of the generated message.
116	.TP
117	.BI \-c " content-type"
118	Label the included file as being of MIME type
119	.IR content-type ,
120	which must be a subtype of
121	.BR application ,
122	.BR audio ,
123	.BR image ,
124	or
125	.BR video .
126	If this switch is not given,
127	.B mpack
128	examines the file to determine its type.
129	.TP
130	.BI \-o " outputfile"
131	Write the generated message to the file
132	.IR outputfile .
133	If the message has to be split, the partial messages will instead be
134	written to the files
135	.IR outputfile .01,
136	.IR outputfile .02,
137	etc.
138	.TP
139	.BI \-n " newsgroups"
140	Post the generated message(s) to the comma-separated netnews
141	.IR newsgroups .
142	.TP
143	.I file
144	Encode the named
145	.IR file .
146	.TP
147	.I "address \&..."
148	Mail the generated messages to the specified addresses.
149	.SH ENVIRONMENT
150	.TP
151	.B TMPDIR
152	Directory to store temporary files. Default is /var/tmp.
153	.TP
154	.B SPLITSIZE
155	Default value of the -m switch.