← Back to branch summary

~ubuntu-branches/ubuntu/dapper/mime-support/dapper

« back to all changes in this revision

Viewing changes to run-mailcap.man.orig

  • Committer: Bazaar Package Importer
  • Author(s): Brian White
  • Date: 2005-05-14 09:07:29 UTC
  • Revision ID: james.westby@ubuntu.com-20050514090729-zmww3gu1nlaaggzw
Tags: 3.34-1
added more mime types

Show diffs side-by-side

added added

removed removed

Lines of Context:
run-mailcap.man.orig
 
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").