~ubuntu-branches/ubuntu/gutsy/mime-support/gutsy

« back to all changes in this revision

Viewing changes to run-mailcap.man

  • Committer: Bazaar Package Importer
  • Author(s): Brian White
  • Date: 2004-03-03 07:47:41 UTC
  • Revision ID: james.westby@ubuntu.com-20040303074741-1b96w5g6vqqafdxs
Tags: 3.26-1
added more mime types (closes: #235663, #225222)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.\" Hey, Emacs!  This is an -*- nroff -*- source file.
 
2
.\" run-mailcap and this manpage were written by Brian White and
 
3
.\" have been placed in the public domain (the only true "free").
 
4
.\"
 
5
.TH RUN-MAILCAP 1 "14th Mar 1998" "Debian Project" "Run Mailcap Programs"
 
6
.SH NAME
 
7
run-mailcap, see, edit, compose, print \- execute programs via entries in the
 
8
.I mailcap
 
9
file
 
10
.SH SYNOPSIS
 
11
.B run-mailcap
 
12
\-\-action=<action> [\-\-debug=<value>]
 
13
[<mime-type>:[<encoding>:]]<filename>  [...]
 
14
 
 
15
The
 
16
.BR see ,
 
17
.BR edit ,
 
18
.B compose
 
19
and
 
20
.B print
 
21
versions are just aliases that default to the view, edit, compose, and
 
22
print actions (respectively).
 
23
 
 
24
You can make this your default pager and/or editor by adding the
 
25
following to your shell startup:
 
26
 
 
27
  shell  file        line(s) to add
 
28
  ~~~~~  ~~~~~~~~~~  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
29
  sh     ~/.profile  PAGER=/usr/bin/see; export PAGER
 
30
                     EDITOR=/usr/bin/edit; export EDITOR
 
31
  csh    ~/.login    setenv PAGER /usr/bin/see
 
32
                     setenv EDITOR /usr/bin/edit
 
33
 
 
34
.SH DESCRIPTION
 
35
.PP
 
36
.B run-mailcap
 
37
(or any of its aliases) will use the given action to process each
 
38
mime-type/file in turn.  Each file is is specified as its mime-type,
 
39
its encoding (eg. compression), and filename together, separated by
 
40
colons.  If the mime-type is omitted, an attempt to determine the type
 
41
is made by trying to match the file's extension with those in the
 
42
.I mime.types
 
43
files.  If the encoding is omitted, it will also be determined from
 
44
the file's extensions.  Currently supported encodings are
 
45
.B gzip
 
46
(.gz) and
 
47
.B compress
 
48
(.Z).  A filename of "-" can be used to mean "standard input", but
 
49
then a mime-type
 
50
.B must
 
51
be specied.
 
52
 
 
53
Both the user's files (~/.mailcap; ~/.mime.types) and the system files
 
54
(/etc/mailcap; /etc/mime.types) are searched in turn for information.
 
55
.SS OPTIONS
 
56
All options are in the form --<opt>=<value>.
 
57
.TP
 
58
.BI \-\-action=<action>
 
59
Performs the specified action on the files.  Valid actions are
 
60
.IR view ,
 
61
.IR compose ,
 
62
.IR composetyped ,
 
63
.I edit
 
64
and
 
65
.IR print .
 
66
If no action is specified, the action will be determined by how the
 
67
program was called.
 
68
.TP
 
69
.BI \-\-debug=<value>
 
70
Turns on extra information to find out what is happening.  Any value
 
71
other than zero (0) will turn on debugging output.
 
72
.SH "SEE ALSO"
 
73
.BR update-mime "(8)"
 
74
.SH AUTHOR
 
75
.B run-mailcap
 
76
(and its aliases) was written by Brian White <bcwhite@pobox.com>.
 
77
.SH COPYRIGHT
 
78
.B run-mailcap
 
79
(and its aliases) is in the public domain (the only true "free").