[OpenSPARC-T2-DV] / tools / perl-5.8.0 / doc / MHonArc / faq / mime.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<HTML>
<HEAD>
<TITLE>MHonArc FAQ: MIME</TITLE></HEAD>
<BODY>

<!--X-NavButtons-Start-->
<p align=center>
[<a href="threads.html">Prev</a>][<a href="security.html">Next</a>][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/">Home</a>]
</p>
<!--X-NavButtons-End-->

<!-- ===================================================================== -->
<HR>
<H2><a name="mime">MIME</a></H2>

<!--X-TOC-Start-->
<ul>
<li><a href="#whatismime">What is MIME?</a></li>
<li><a href="#nonascii">Does MHonArc support message header extensions for non-ASCII text?</a></li>
<li><a href="#howtorecog">How can I get MHonArc to recognize content-types it states it does not recognize?</a></li>
<li><a href="#overridedefs">Can I override the default filters in MHonArc?</a></li>
<li><a href="#overridemulti">Can I override the multipart/* processing of MHonArc?</a></li>
<li><a href="#badtype">Why are attachments saved as a ".bin" files?</a></li>
<li><a href="#filenames">Can attachments get saved with the filename specified in the message header?</a></li>
<li><a href="#removepre">Can the &lt;PRE&gt; tags be removed from converted messages?</a></li>
<li><a href="#lineclip">Can long lines be wrapped in converted messages?</a></li>
<li><a href="#exclude">Can I exclude specific media-types?</a></li>
<li><a href="#alternative">Can I tell MHonArc to use the text/plain part over a text/html part in a multipart/alternative message?</a></li>
</ul>
<!--X-TOC-End-->

<!-- ??????????????????????????????????????????????????????????????? -->
<hr noshade size=1>
<table border=0>
<tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
<h3><b><a name="whatismime">What is MIME?</a></b></h3>
</td></tr></table>

<P>MIME stands for <EM>Multipurpose Internet
Mail Extensions</EM>.
An HTML version of the RFCs that define MIME are available at (<A
HREF="http://www.nacs.uci.edu/indiv/ehood/MIME/MIME.html">http://www.nacs.uci.edu/indiv/ehood/MIME/MIME.html</A>).
</P>

<P>In sum, MIME "redefines the format of message bodies to
allow multi-part textual and non-textual message bodies to
be represented and exchanged without loss of information." [<A
HREF="http://www.nacs.uci.edu/indiv/ehood/MIME/1521/rfc1521ToC.html">RFC
1521</A>] </P>

<!-- ??????????????????????????????????????????????????????????????? -->
<hr noshade size=1>
<table border=0>
<tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
<h3><b><a name="nonascii">Does MHonArc support message header extensions for non-ASCII text?</a></b></h3>
</td></tr></table>

<P>v2.0 or later.  Review the CHARSETCONVERTERS resource page for
which character sets are supported by MHonArc and how to extend
MHonArc to support other character sets.
</P>

<!-- ??????????????????????????????????????????????????????????????? -->
<hr noshade size=1>
<table border=0>
<tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
<h3><b><a name="howtorecog">How can I get MHonArc to recognize content-types it states it does not recognize?</a></b></h3>
</td></tr></table>

<P>This question can be anwsered by reading about the MIMEFILTERS
resource of the
MHonArc documentation. The solution may require registering
a pre-existing filter for the given content-type, or hooking in a
new filter.
</P>

<!-- ??????????????????????????????????????????????????????????????? -->
<hr noshade size=1>
<table border=0>
<tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
<h3><b><a name="overridedefs">Can I override the default filters in MHonArc?</a></b></h3>
</td></tr></table>

<p>Yes.  MHonArc's default filters are hooked in
as described in the MIMEFILTERS resource.  Note, please review the
options available for the default filters described in the MIMEFILTERS
resource page since they may already provide the capability you
need.
</p>

<!-- ??????????????????????????????????????????????????????????????? -->
<hr noshade size=1>
<table border=0>
<tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
<h3><b><a name="overridemulti">Can I override the multipart/* processing of MHonArc?</a></b></h3>
</td></tr></table>

<p>Yes, but not recommended.  Make sure you are familiar with how
MHonArc does things before considering implementing your own multipart
filter.  In sum, you can completely replace MHonArc's filters
with your own if you so desire.
</p>

<!-- ??????????????????????????????????????????????????????????????? -->
<hr noshade size=1>
<table border=0>
<tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
<h3><b><a name="badtype">Why are attachments saved as a ".bin" files?</a></b></h3>
</td></tr></table>

<p>MHonArc uses the <b>Content-Type</b> field in messages to determine
the type of data that is being processed.  If data is gettings saved
to a "<tt>.bin</tt>" file, it means the data has a content-type of
<b>application/octet-stream</b>.  The best solution to the problem
is have the senders of the messages label the data properly.  You
can also check out the <b><tt>m2h_external::filter</tt></b> options documented
in the MIMEFILTERS page of the documentation for some possible alternate
solutions.
</p>

<!-- ??????????????????????????????????????????????????????????????? -->
<hr noshade size=1>
<table border=0>
<tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
<h3><b><a name="filenames">Can attachments get saved with the filename specified in the message header?</a></b></h3>
</td></tr></table>

<p>Yes.  See the <b><tt>m2h_external::filter</tt></b> options documented
in the MIMEFILTERS page of the documentation.  Make note of the
security cautions in the documentation.
Example:
</p>
<pre>
&lt;MIMEArgs&gt;
m2h_external::filter; usename
&lt;/MIMEArgs&gt;
</pre>

<dl>
<dt>See also:</dt>
<dd><a href="security.html#attachments"
    >Why doesn't MHonArc, by default, use the specified filename when
    saving attachments?</a></dd>
</dl>

<!-- ??????????????????????????????????????????????????????????????? -->
<hr noshade size=1>
<table border=0>
<tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
<h3><b><a name="removepre">Can the &lt;PRE&gt; tags be removed from converted messages?</a></b></h3>
</td></tr></table>

<p>Yes.  See the options available for the <b>m2h_text_plain::filter</b>
described in the MIMEFILTERS resource page of the documentation.
Example:
</p>
<pre>
&lt;MIMEArgs&gt;
m2h_text_plain::filter; nonfixed
&lt;/MIMEArgs&gt;
</pre>

<!-- ??????????????????????????????????????????????????????????????? -->
<hr noshade size=1>
<table border=0>
<tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
<h3><b><a name="lineclip">Can long lines be wrapped in converted messages?</a></b></h3>
</td></tr></table>

<p>Yes.  See the options available for the <b>m2h_text_plain::filter</b>
described in the MIMEFILTERS resource page of the documentation.
Example:
</p>
<pre>
&lt;-- Make sure lines are no longer than 80 characters --&gt;
&lt;MIMEArgs&gt;
m2h_text_plain::filter; maxwidth=80
&lt;/MIMEArgs&gt;
</pre>

<!-- ??????????????????????????????????????????????????????????????? -->
<hr noshade size=1>
<table border=0>
<tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
<h3><b><a name="exclude">Can I exclude specific media-types?</a></b></h3>
</td></tr></table>

<p>Yes.  See the MIMEEXCS resource.
Example:
</p>
<pre>
&lt;-- Exclude all HTML and binary data --&gt;
&lt;MIMEExcs&gt;
text/html
application/octet-steam
&lt;/MIMEExcs&gt;
</pre>

<!-- ??????????????????????????????????????????????????????????????? -->
<hr noshade size=1>
<table border=0>
<tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
<h3><b><a name="alternative">Can I tell MHonArc to use the text/plain part over a text/html part in a multipart/alternative message?</a></b></h3>
</td></tr></table>

<p>Yes, in v2.5.8, and later, via the MIMEALTPREFS resource.
Example:
</p>
<pre>
&lt;MIMEAltPrefs&gt;
text/plain
text/html
&lt;/MIMEAltPrefs&gt;
</pre>

<!-- ===================================================================== -->
<hr>

<!--X-NavButtons-Start-->
<p align=center>
[<a href="threads.html">Prev</a>][<a href="security.html">Next</a>][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/">Home</a>]
</p>
<!--X-NavButtons-End-->

<HR>
<address>
$Date: 2002/06/28 03:28:10 $ <br>
<img align="top" src="monicon.png" alt="">
<a href="http://www.mhonarc.org/"
><strong>MHonArc</strong></a><br>
Copyright &#169; 1997-1999, <a href="http://www.earlhood.com/"
>Earl Hood</a>, <a href="mailto:mhonarc@mhonarc.org"
>mhonarc@mhonarc.org</a><br>
</address>
</BODY>
</HTML>
Commit	Line	Data
86530b38 AT	1	<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
	2	<HTML>
	3	<HEAD>
	4	<TITLE>MHonArc FAQ: MIME</TITLE></HEAD>
	5	<BODY>
	6
	7	<!--X-NavButtons-Start-->
	8	<p align=center>
	9	[<a href="threads.html">Prev</a>][<a href="security.html">Next</a>][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/">Home</a>]
	10	</p>
	11	<!--X-NavButtons-End-->
	12
	13	<!-- ===================================================================== -->
	14	<HR>
	15	<H2><a name="mime">MIME</a></H2>
	16
	17	<!--X-TOC-Start-->
	18	<ul>
	19	<li><a href="#whatismime">What is MIME?</a></li>
	20	<li><a href="#nonascii">Does MHonArc support message header extensions for non-ASCII text?</a></li>
	21	<li><a href="#howtorecog">How can I get MHonArc to recognize content-types it states it does not recognize?</a></li>
	22	<li><a href="#overridedefs">Can I override the default filters in MHonArc?</a></li>
	23	<li><a href="#overridemulti">Can I override the multipart/* processing of MHonArc?</a></li>
	24	<li><a href="#badtype">Why are attachments saved as a ".bin" files?</a></li>
	25	<li><a href="#filenames">Can attachments get saved with the filename specified in the message header?</a></li>
	26	<li><a href="#removepre">Can the <PRE> tags be removed from converted messages?</a></li>
	27	<li><a href="#lineclip">Can long lines be wrapped in converted messages?</a></li>
	28	<li><a href="#exclude">Can I exclude specific media-types?</a></li>
	29	<li><a href="#alternative">Can I tell MHonArc to use the text/plain part over a text/html part in a multipart/alternative message?</a></li>
	30	</ul>
	31	<!--X-TOC-End-->
	32
	33	<!-- ??????????????????????????????????????????????????????????????? -->
	34	<hr noshade size=1>
	35	<table border=0>
	36	<tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
	37	<h3><b><a name="whatismime">What is MIME?</a></b></h3>
	38	</td></tr></table>
	39
	40	<P>MIME stands for <EM>Multipurpose Internet
	41	Mail Extensions</EM>.
	42	An HTML version of the RFCs that define MIME are available at (<A
	43	HREF="http://www.nacs.uci.edu/indiv/ehood/MIME/MIME.html">http://www.nacs.uci.edu/indiv/ehood/MIME/MIME.html</A>).
	44	</P>
	45
	46	<P>In sum, MIME "redefines the format of message bodies to
	47	allow multi-part textual and non-textual message bodies to
	48	be represented and exchanged without loss of information." [<A
	49	HREF="http://www.nacs.uci.edu/indiv/ehood/MIME/1521/rfc1521ToC.html">RFC
	50	1521</A>] </P>
	51
	52	<!-- ??????????????????????????????????????????????????????????????? -->
	53	<hr noshade size=1>
	54	<table border=0>
	55	<tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
	56	<h3><b><a name="nonascii">Does MHonArc support message header extensions for non-ASCII text?</a></b></h3>
	57	</td></tr></table>
	58
	59	<P>v2.0 or later. Review the CHARSETCONVERTERS resource page for
	60	which character sets are supported by MHonArc and how to extend
	61	MHonArc to support other character sets.
	62	</P>
	63
	64	<!-- ??????????????????????????????????????????????????????????????? -->
65	<hr noshade size=1>
66	<table border=0>
67	<tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
68	<h3><b><a name="howtorecog">How can I get MHonArc to recognize content-types it states it does not recognize?</a></b></h3>
69	</td></tr></table>
70
71	<P>This question can be anwsered by reading about the MIMEFILTERS
72	resource of the
73	MHonArc documentation. The solution may require registering
74	a pre-existing filter for the given content-type, or hooking in a
75	new filter.
76	</P>
77
78	<!-- ??????????????????????????????????????????????????????????????? -->
79	<hr noshade size=1>
80	<table border=0>
81	<tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
82	<h3><b><a name="overridedefs">Can I override the default filters in MHonArc?</a></b></h3>
83	</td></tr></table>
84
85	<p>Yes. MHonArc's default filters are hooked in
86	as described in the MIMEFILTERS resource. Note, please review the
87	options available for the default filters described in the MIMEFILTERS
88	resource page since they may already provide the capability you
89	need.
90	</p>
91
92	<!-- ??????????????????????????????????????????????????????????????? -->
93	<hr noshade size=1>
94	<table border=0>
95	<tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
96	<h3><b><a name="overridemulti">Can I override the multipart/* processing of MHonArc?</a></b></h3>
97	</td></tr></table>
98
99	<p>Yes, but not recommended. Make sure you are familiar with how
100	MHonArc does things before considering implementing your own multipart
101	filter. In sum, you can completely replace MHonArc's filters
102	with your own if you so desire.
103	</p>
104
105	<!-- ??????????????????????????????????????????????????????????????? -->
106	<hr noshade size=1>
107	<table border=0>
108	<tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
109	<h3><b><a name="badtype">Why are attachments saved as a ".bin" files?</a></b></h3>
110	</td></tr></table>
111
112	<p>MHonArc uses the <b>Content-Type</b> field in messages to determine
113	the type of data that is being processed. If data is gettings saved
114	to a "<tt>.bin</tt>" file, it means the data has a content-type of
115	<b>application/octet-stream</b>. The best solution to the problem
116	is have the senders of the messages label the data properly. You
117	can also check out the <b><tt>m2h_external::filter</tt></b> options documented
118	in the MIMEFILTERS page of the documentation for some possible alternate
119	solutions.
120	</p>
121
122	<!-- ??????????????????????????????????????????????????????????????? -->
123	<hr noshade size=1>
124	<table border=0>
125	<tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
126	<h3><b><a name="filenames">Can attachments get saved with the filename specified in the message header?</a></b></h3>
127	</td></tr></table>
128
129	<p>Yes. See the <b><tt>m2h_external::filter</tt></b> options documented
130	in the MIMEFILTERS page of the documentation. Make note of the
131	security cautions in the documentation.
132	Example:
133	</p>
134	<pre>
135	<MIMEArgs>
136	m2h_external::filter; usename
137	</MIMEArgs>
138	</pre>
139
140	<dl>
141	<dt>See also:</dt>
142	<dd><a href="security.html#attachments"
143	>Why doesn't MHonArc, by default, use the specified filename when
144	saving attachments?</a></dd>
145	</dl>
146
147	<!-- ??????????????????????????????????????????????????????????????? -->
148	<hr noshade size=1>
149	<table border=0>
150	<tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
151	<h3><b><a name="removepre">Can the <PRE> tags be removed from converted messages?</a></b></h3>
152	</td></tr></table>
153
154	<p>Yes. See the options available for the <b>m2h_text_plain::filter</b>
155	described in the MIMEFILTERS resource page of the documentation.
156	Example:
157	</p>
158	<pre>
159	<MIMEArgs>
160	m2h_text_plain::filter; nonfixed
161	</MIMEArgs>
162	</pre>
163
164	<!-- ??????????????????????????????????????????????????????????????? -->
165	<hr noshade size=1>
166	<table border=0>
167	<tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
168	<h3><b><a name="lineclip">Can long lines be wrapped in converted messages?</a></b></h3>
169	</td></tr></table>
170
171	<p>Yes. See the options available for the <b>m2h_text_plain::filter</b>
172	described in the MIMEFILTERS resource page of the documentation.
173	Example:
174	</p>
175	<pre>
176	<-- Make sure lines are no longer than 80 characters -->
177	<MIMEArgs>
178	m2h_text_plain::filter; maxwidth=80
179	</MIMEArgs>
180	</pre>
181
182	<!-- ??????????????????????????????????????????????????????????????? -->
183	<hr noshade size=1>
184	<table border=0>
185	<tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
186	<h3><b><a name="exclude">Can I exclude specific media-types?</a></b></h3>
187	</td></tr></table>
188
189	<p>Yes. See the MIMEEXCS resource.
190	Example:
191	</p>
192	<pre>
193	<-- Exclude all HTML and binary data -->
194	<MIMEExcs>
195	text/html
196	application/octet-steam
197	</MIMEExcs>
198	</pre>
199
200	<!-- ??????????????????????????????????????????????????????????????? -->
201	<hr noshade size=1>
202	<table border=0>
203	<tr valign=top><td><img src="monicon.png" align="bottom" alt=""></td><td>
204	<h3><b><a name="alternative">Can I tell MHonArc to use the text/plain part over a text/html part in a multipart/alternative message?</a></b></h3>
205	</td></tr></table>
206
207	<p>Yes, in v2.5.8, and later, via the MIMEALTPREFS resource.
208	Example:
209	</p>
210	<pre>
211	<MIMEAltPrefs>
212	text/plain
213	text/html
214	</MIMEAltPrefs>
215	</pre>
216
217	<!-- ===================================================================== -->
218	<hr>
219
220	<!--X-NavButtons-Start-->
221	<p align=center>
222	[<a href="threads.html">Prev</a>][<a href="security.html">Next</a>][<a href="faq.html">TOC</a>][<a href="http://www.mhonarc.org/">Home</a>]
223	</p>
224	<!--X-NavButtons-End-->
225
226	<HR>
227	<address>
228	$Date: 2002/06/28 03:28:10 $ <br>
229	<img align="top" src="monicon.png" alt="">
230	<a href="http://www.mhonarc.org/"
231	><strong>MHonArc</strong></a><br>
232	Copyright © 1997-1999, <a href="http://www.earlhood.com/"
233	>Earl Hood</a>, <a href="mailto:mhonarc@mhonarc.org"
234	>mhonarc@mhonarc.org</a><br>
235	</address>
236	</BODY>
237	</HTML>