Changeset 5207:dc54d31493a2 for doc

Timestamp:

2007-09-05 00:07:00 (15 months ago)

Author:

Rocco Rutte <pdmef@…>

Branch:

HEAD

Message:

Manual: make sure <screen/> contents in shorter than 80 chars

Otherwise conversion to plain text may cause line breaks rendering
examples syntacially invalid (closes #2185).

Files:

• doc/manual.xml.head (modified) (4 diffs)

doc/manual.xml.head

@@ -5093 +5093 @@
 
 <screen>
--   1 [text/plain, 7bit, 1K]             /tmp/mutt-euler-8082-0 &lt;no description&gt;
-    2 [applica/x-gunzip, base64, 422K]   ~/src/mutt-0.85.tar.gz &lt;no description&gt;
+- 1 [text/plain, 7bit, 1K]           /tmp/mutt-euler-8082-0 &lt;no description&gt;
+  2 [applica/x-gunzip, base64, 422K] ~/src/mutt-0.85.tar.gz &lt;no description&gt;
 </screen>
 
@@ -5177 +5177 @@
 In order to handle various MIME types that Mutt can not handle
 internally, Mutt parses a series of external configuration files to
-find an external handler.  The default search string for these files
-is a colon delimited list set to
+find an external handler. The default search string for these files
+is a colon delimited list containing the following files:
+
+<orderedlist>
+<listitem><para><literal>&dollar;HOME/.mailcap</literal></para></listitem>
+<listitem><para><literal>&dollar;PKGDATADIR/mailcap</literal></para></listitem>
+<listitem><para><literal>&dollar;SYSCONFDIR/mailcap</literal></para></listitem>
+<listitem><para><literal>/etc/mailcap</literal></para></listitem>
+<listitem><para><literal>/usr/etc/mailcap</literal></para></listitem>
+<listitem><para><literal>/usr/local/etc/mailcap</literal></para></listitem>
+</orderedlist>
+
+where <literal>&dollar;HOME</literal> is your home directory. The
+<literal>&dollar;PKGDATADIR</literal> and the
+<literal>&dollar;SYSCONFDIR</literal> directories depend on where mutt
+is installed: the former is the default for shared data, the
+latter for system configuration files.
+</para>
+
+<para>
+The default search path can be obtained by running the following
+command:
+</para>
 
 <screen>
-${HOME}/.mailcap:/usr/local/share/mutt/mailcap:/etc/mailcap:/etc/mailcap:/usr/etc/mailcap:/usr/local/etc/mailcap
+mutt -nF /dev/null -Q mailcap_path
 </screen>
-
-where <literal>&dollar;HOME</literal> is your home directory.
-</para>
 
 <para>
@@ -5678 +5696 @@
 
 <screen>
-auto_view text/html application/x-gunzip application/postscript image/gif application/x-tar-gz
+auto_view text/html application/x-gunzip &bsol;
+  application/postscript image/gif application/x-tar-gz
 </screen>
 
@@ -5689 +5708 @@
 <screen>
 text/html;      lynx -dump %s; copiousoutput; nametemplate=%s.html
-image/*;        anytopnm %s | pnmscale -xsize 80 -ysize 50 | ppmtopgm | pgmtopbm | pbmtoascii ; copiousoutput
+image/*;        anytopnm %s | pnmscale -xsize 80 -ysize 50 | ppmtopgm | &bsol;
+                pgmtopbm | pbmtoascii ; copiousoutput
 application/x-gunzip;   gzcat; copiousoutput
 application/x-tar-gz; gunzip -c %s | tar -tf - ; copiousoutput