diff options
author | Fred Drake <fdrake@acm.org> | 1998-04-02 15:53:07 (GMT) |
---|---|---|
committer | Fred Drake <fdrake@acm.org> | 1998-04-02 15:53:07 (GMT) |
commit | 9e9c89e67c3df758fdffb426c0cbefd50f559638 (patch) | |
tree | 18db9b7dc792801bddbc7dfbc27fe1e5cefeac5f /Doc/libmailcap.tex | |
parent | ac8f91ada4dd32b2c87b7804c9f8b3481e0b0f30 (diff) | |
download | cpython-9e9c89e67c3df758fdffb426c0cbefd50f559638.zip cpython-9e9c89e67c3df758fdffb426c0cbefd50f559638.tar.gz cpython-9e9c89e67c3df758fdffb426c0cbefd50f559638.tar.bz2 |
Some nits.
Fixed quoting in third paragraph of the findmatch() description.
Diffstat (limited to 'Doc/libmailcap.tex')
-rw-r--r-- | Doc/libmailcap.tex | 17 |
1 files changed, 10 insertions, 7 deletions
diff --git a/Doc/libmailcap.tex b/Doc/libmailcap.tex index da337bb..69329ee 100644 --- a/Doc/libmailcap.tex +++ b/Doc/libmailcap.tex @@ -8,16 +8,19 @@ as mail readers and Web browsers react to files with different MIME types. (The name ``mailcap'' is derived from the phrase ``mail capability''.) For example, a mailcap file might contain a line like \samp{video/mpeg; xmpeg \%s}. Then, if the user encounters an email -message or Web document with the MIME type video/mpeg, \code{\%s} will be -replaced by a filename (usually one belonging to a temporary file) and -the xmpeg program can be automatically started to view the file. +message or Web document with the MIME type \mimetype{video/mpeg}, +\samp{\%s} will be replaced by a filename (usually one belonging to a +temporary file) and the \program{xmpeg} program can be automatically +started to view the file. The mailcap format is documented in \rfc{1524}, ``A User Agent Configuration Mechanism For Multimedia Mail Format Information,'' but is not an Internet standard. However, mailcap files are supported on most \UNIX{} systems. -\begin{funcdesc}{findmatch}{caps, MIMEtype, key, filename, plist} +\begin{funcdesc}{findmatch}{caps, MIMEtype% + \optional{, key\optional{, + filename\optional{, plist}}}} Return a 2-tuple; the first element is a string containing the command line to be executed (which can be passed to \code{os.system()}), and the second element is @@ -32,9 +35,9 @@ wanted to create a new body of the given MIME type or alter the existing body data. See \rfc{1524} for a complete list of these fields. -\var{filename} is the filename to be substituted for \%s in the +\var{filename} is the filename to be substituted for \samp{\%s} in the command line; the default value is -\file{/dev/null} which is almost certainly not what you want, so +\code{'/dev/null'} which is almost certainly not what you want, so usually you'll override it by specifying a filename. \var{plist} can be a list containing named parameters; the default @@ -43,7 +46,7 @@ string containing the parameter name, an equals sign (\code{=}), and the parameter's value. Mailcap entries can contain named parameters like \code{\%\{foo\}}, which will be replaced by the value of the parameter named 'foo'. For example, if the command line -\samp{showpartial \%\{id\} \%\{number\} \%\{total\}} +\samp{showpartial \%\{id\}\ \%\{number\}\ \%\{total\}} was in a mailcap file, and \var{plist} was set to \code{['id=1', 'number=2', 'total=3']}, the resulting command line would be \code{"showpartial 1 2 3"}. |