~ubuntu-branches/ubuntu/utopic/mime-support/utopic

« back to all changes in this revision

Viewing changes to run-mailcap.man.orig

  • Committer: Bazaar Package Importer
  • Author(s): Lorenzo De Liso
  • Date: 2010-11-14 17:28:44 UTC
  • mfrom: (5.1.3 sid)
  • Revision ID: james.westby@ubuntu.com-20101114172844-wa2sra0m79ce6nbn
Tags: 3.51-1ubuntu1
* Merge from debian unstable (LP: #675225), remaining changes:
  - Add "cautious-launcher" for handling execution of files that are
    outside /usr and /opt (LP: #506702).
  - Fix typo in cautious-launcher dialog.

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),
47
 
.B bzip
48
 
(.bz),
49
 
.B bzip2
50
 
(.bz2), and
51
 
.B compress
52
 
(.Z).  A filename of "-" can be used to mean "standard input", but
53
 
then a mime-type
54
 
.B must
55
 
be specied.
56
 
 
57
 
Both the user's files (~/.mailcap; ~/.mime.types) and the system files
58
 
(/etc/mailcap; /etc/mime.types) are searched in turn for information.
59
 
.SS EXAMPLES
60
 
  see picture.jpg
61
 
  print output.ps.gz
62
 
  compose text/html:index.htm
63
 
  extract-mail-attachment msg.txt | see image/tiff:gzip:-
64
 
.SS OPTIONS
65
 
All options are in the form --<opt>=<value>.
66
 
.TP
67
 
.BI \-\-action=<action>
68
 
Performs the specified action on the files.  Valid actions are
69
 
.IR view ,
70
 
.IR compose ,
71
 
.IR composetyped ,
72
 
.I edit
73
 
and
74
 
.IR print .
75
 
If no action is specified, the action will be determined by how the
76
 
program was called.
77
 
.TP
78
 
.BI \-\-debug=<value>
79
 
Turns on extra information to find out what is happening.  Any value
80
 
other than zero (0) will turn on debugging output.
81
 
.SH "SEE ALSO"
82
 
.BR update-mime "(8)"
83
 
.SH AUTHOR
84
 
.B run-mailcap
85
 
(and its aliases) was written by Brian White <bcwhite@pobox.com>.
86
 
.SH COPYRIGHT
87
 
.B run-mailcap
88
 
(and its aliases) is in the public domain (the only true "free").