[OpenSPARC-T2-DV] / tools / perl-5.8.0 / doc / MHonArc / resources / mimealtprefs.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<html>
<head>
<title>MHonArc Resources: MIMEALTPREFS</title>
</head>
<body>
<!--x-rc-nav-->
<table border=0><tr valign="top">
<td align="left" width="50%">[Prev:&nbsp;<a href="mhpattern.html">MHPATTERN</a>]</td><td><nobr>[<a href="../resources.html#mimealtprefs">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next:&nbsp;<a href="mimeargs.html">MIMEARGS</a>]</td></tr></table>
<!--/x-rc-nav-->
<hr>
<h1>MIMEALTPREFS</h1>

<!-- *************************************************************** -->
<hr>
<h2>Syntax</h2>

<dl>

<dt><strong>Envariable</strong></dt>
<dd><p>N/A
</p>
</dd>

<dt><strong>Element</strong></dt>
<dd><p>
<code>&lt;MIMEALTPREFS&gt;</code><br>
<var>content-type</var><br>
<var>content-type</var><br>
...<br>
<code>&lt;/MIMEALTPREFS&gt;</code><br>
</p>
</dd>

<dt><strong>Command-line Option</strong></dt>
<dd><p>N/A
</p>
</dd>

</dl>

<!-- *************************************************************** -->
<hr>
<h2>Description</h2>

<p>MIMEALTPREFS allows you to specify media-type preferences
for <tt>multipart/alternative</tt> data, overriding the default
preferences as specified in mail messages.
</p>

<p>When a <tt>multipart/alternative</tt> entity is processed,
the last filterable media-type is normally used.  However, it is sometimes
desirable to override this behavior for certain media-types.  For example,
it has become more common for many MUAs to generate the following
message structures:
</p>
<pre>
  multipart/alternative
    text/plain
    text/html</pre>

<p>A message with HTML, and a plain text equivalent for those receiving
MUAs who may not be able to render HTML in email.  When MHonArc processes
such a message, MHonArc will use the <tt>text/html</tt> part since it
is filterable and comes after <tt>text/plain</tt>.
</p>

<p>There are some who would like to have nothing to do with HTML in
email.  Or, due to security concerns, would prefer to not minimize the
amount of HTML from email in their archives.  With MIMEALTPREFS, you
can tell MHonArc to prefer the <tt>text/plain</tt> over the <tt>text/html</tt>
part with the following setting:
</p>
<pre>
<b>&lt;MIMEAltPrefs&gt;</b>
text/plain
text/html
<b>&lt;/MIMEAltPrefs&gt;</b>
</pre>

<p>Media-types listed in MIMEALTPREFS are from most prefered to least
prefered.
</p>

<p>Note, MIMEALTPREFS augments the normal processing of
<tt>multipart/alternative</tt> entities.  For example, say the following
message entity structure exists,
</p>
<pre>
  multipart/alternative
    text/plain
    text/enriched
    text/html</pre>
<p>and we are using the MIMEALTPREFS setting,
</p>
<pre>
<b>&lt;MIMEAltPrefs&gt;</b>
text/plain
text/html
<b>&lt;/MIMEAltPrefs&gt;</b>
</pre>

<p>So which entity will MHonArc actually use?  In this case,
the <tt>text/enriched</tt> part will be used.  The reason is that
the <tt>text/html</tt> will be excluded since there does exist a
<tt>text/plain</tt> alternative entity.  However, MHonArc still
tries to use the last filterable alternative part, which in this
case is <tt>text/enriched</tt>.
</p>

<p>In order to have <tt>text/plain</tt> chosen, the following
MIMEALTPREFS setting would be needed,
</p>
<pre>
<b>&lt;MIMEAltPrefs&gt;</b>
text/plain
text/enriched
text/html
<b>&lt;/MIMEAltPrefs&gt;</b>
</pre>
<p>This says that <tt>text/enriched</tt> is preferred over
<tt>text/html</tt>.  And <tt>text/plain</tt> is preferred over
<tt>text/enriched</tt> and <tt>text/html</tt>.
</p>

<table border=0 cellpadding=4>
<tr valign=top>
<td><strong>NOTE</strong></td>
<td><p>Each time <tt>&lt;MIMEALTPREFS&gt;</tt> occurs in a resource file,
the last encountered setting will override any previous values.  Therefore,
specifying the <tt>override</tt> attribute is redundant.
</p>
</td>
</tr>
</table>

<!-- *************************************************************** -->
<hr>
<h2>Default Setting</h2>

<p>Nil
</p>

<!-- *************************************************************** -->
<hr>
<h2>Resource Variables</h2>

<p>N/A
</p>

<!-- *************************************************************** -->
<hr>
<h2>Examples</h2>

<p>None.
</p>

<!-- *************************************************************** -->
<hr>
<h2>Version</h2>

<p>2.5.8
</p>

<!-- *************************************************************** -->
<hr>
<h2>See Also</h2>

<p>
<a href="mimeexcs.html">MIMEEXCS</a>
</p>

<!-- *************************************************************** -->
<hr>
<!--x-rc-nav-->
<table border=0><tr valign="top">
<td align="left" width="50%">[Prev:&nbsp;<a href="mhpattern.html">MHPATTERN</a>]</td><td><nobr>[<a href="../resources.html#mimealtprefs">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next:&nbsp;<a href="mimeargs.html">MIMEARGS</a>]</td></tr></table>
<!--/x-rc-nav-->
<hr>
<address>
$Date: 2002/07/27 05:13:10 $<br>
<img align="top" src="../monicon.png" alt="">
<a href="http://www.mhonarc.org/"><strong>MHonArc</strong></a><br>
Copyright &#169; 2002, <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 Resources: MIMEALTPREFS</title>
	5	</head>
	6	<body>
	7	<!--x-rc-nav-->
	8	<table border=0><tr valign="top">
	9	<td align="left" width="50%">[Prev: <a href="mhpattern.html">MHPATTERN</a>]</td><td><nobr>[<a href="../resources.html#mimealtprefs">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next: <a href="mimeargs.html">MIMEARGS</a>]</td></tr></table>
	10	<!--/x-rc-nav-->
	11	<hr>
	12	<h1>MIMEALTPREFS</h1>
	13
	14	<!-- *************************************************************** -->
	15	<hr>
	16	<h2>Syntax</h2>
	17
	18	<dl>
	19
	20	<dt><strong>Envariable</strong></dt>
	21	<dd><p>N/A
	22	</p>
	23	</dd>
	24
	25	<dt><strong>Element</strong></dt>
	26	<dd><p>
	27	<code><MIMEALTPREFS></code><br>
	28	<var>content-type</var><br>
	29	<var>content-type</var><br>
	30	...<br>
	31	<code></MIMEALTPREFS></code><br>
	32	</p>
	33	</dd>
	34
	35	<dt><strong>Command-line Option</strong></dt>
	36	<dd><p>N/A
	37	</p>
	38	</dd>
	39
	40	</dl>
	41
	42	<!-- *************************************************************** -->
	43	<hr>
	44	<h2>Description</h2>
	45
	46	<p>MIMEALTPREFS allows you to specify media-type preferences
	47	for <tt>multipart/alternative</tt> data, overriding the default
	48	preferences as specified in mail messages.
	49	</p>
	50
	51	<p>When a <tt>multipart/alternative</tt> entity is processed,
	52	the last filterable media-type is normally used. However, it is sometimes
	53	desirable to override this behavior for certain media-types. For example,
	54	it has become more common for many MUAs to generate the following
	55	message structures:
	56	</p>
	57	<pre>
	58	multipart/alternative
	59	text/plain
	60	text/html</pre>
	61
	62	<p>A message with HTML, and a plain text equivalent for those receiving
	63	MUAs who may not be able to render HTML in email. When MHonArc processes
	64	such a message, MHonArc will use the <tt>text/html</tt> part since it
65	is filterable and comes after <tt>text/plain</tt>.
66	</p>
67
68	<p>There are some who would like to have nothing to do with HTML in
69	email. Or, due to security concerns, would prefer to not minimize the
70	amount of HTML from email in their archives. With MIMEALTPREFS, you
71	can tell MHonArc to prefer the <tt>text/plain</tt> over the <tt>text/html</tt>
72	part with the following setting:
73	</p>
74	<pre>
75	<b><MIMEAltPrefs></b>
76	text/plain
77	text/html
78	<b></MIMEAltPrefs></b>
79	</pre>
80
81	<p>Media-types listed in MIMEALTPREFS are from most prefered to least
82	prefered.
83	</p>
84
85	<p>Note, MIMEALTPREFS augments the normal processing of
86	<tt>multipart/alternative</tt> entities. For example, say the following
87	message entity structure exists,
88	</p>
89	<pre>
90	multipart/alternative
91	text/plain
92	text/enriched
93	text/html</pre>
94	<p>and we are using the MIMEALTPREFS setting,
95	</p>
96	<pre>
97	<b><MIMEAltPrefs></b>
98	text/plain
99	text/html
100	<b></MIMEAltPrefs></b>
101	</pre>
102
103	<p>So which entity will MHonArc actually use? In this case,
104	the <tt>text/enriched</tt> part will be used. The reason is that
105	the <tt>text/html</tt> will be excluded since there does exist a
106	<tt>text/plain</tt> alternative entity. However, MHonArc still
107	tries to use the last filterable alternative part, which in this
108	case is <tt>text/enriched</tt>.
109	</p>
110
111	<p>In order to have <tt>text/plain</tt> chosen, the following
112	MIMEALTPREFS setting would be needed,
113	</p>
114	<pre>
115	<b><MIMEAltPrefs></b>
116	text/plain
117	text/enriched
118	text/html
119	<b></MIMEAltPrefs></b>
120	</pre>
121	<p>This says that <tt>text/enriched</tt> is preferred over
122	<tt>text/html</tt>. And <tt>text/plain</tt> is preferred over
123	<tt>text/enriched</tt> and <tt>text/html</tt>.
124	</p>
125
126	<table border=0 cellpadding=4>
127	<tr valign=top>
128	<td><strong>NOTE</strong></td>
129	<td><p>Each time <tt><MIMEALTPREFS></tt> occurs in a resource file,
130	the last encountered setting will override any previous values. Therefore,
131	specifying the <tt>override</tt> attribute is redundant.
132	</p>
133	</td>
134	</tr>
135	</table>
136
137	<!-- *************************************************************** -->
138	<hr>
139	<h2>Default Setting</h2>
140
141	<p>Nil
142	</p>
143
144	<!-- *************************************************************** -->
145	<hr>
146	<h2>Resource Variables</h2>
147
148	<p>N/A
149	</p>
150
151	<!-- *************************************************************** -->
152	<hr>
153	<h2>Examples</h2>
154
155	<p>None.
156	</p>
157
158	<!-- *************************************************************** -->
159	<hr>
160	<h2>Version</h2>
161
162	<p>2.5.8
163	</p>
164
165	<!-- *************************************************************** -->
166	<hr>
167	<h2>See Also</h2>
168
169	<p>
170	<a href="mimeexcs.html">MIMEEXCS</a>
171	</p>
172
173	<!-- *************************************************************** -->
174	<hr>
175	<!--x-rc-nav-->
176	<table border=0><tr valign="top">
177	<td align="left" width="50%">[Prev: <a href="mhpattern.html">MHPATTERN</a>]</td><td><nobr>[<a href="../resources.html#mimealtprefs">Resources</a>][<a href="../mhonarc.html">TOC</a>]</nobr></td><td align="right" width="50%">[Next: <a href="mimeargs.html">MIMEARGS</a>]</td></tr></table>
178	<!--/x-rc-nav-->
179	<hr>
180	<address>
181	$Date: 2002/07/27 05:13:10 $<br>
182	<img align="top" src="../monicon.png" alt="">
183	<a href="http://www.mhonarc.org/"><strong>MHonArc</strong></a><br>
184	Copyright © 2002, <a href="http://www.earlhood.com/"
185	>Earl Hood</a>, <a href="mailto:mhonarc@mhonarc.org"
186	>mhonarc@mhonarc.org</a><br>
187	</address>
188
189	</body>
190	</html>