~ubuntu-branches/ubuntu/maverick/mime-support/maverick

« back to all changes in this revision

Viewing changes to update-mime.man

  • Committer: Bazaar Package Importer
  • Author(s): Brian White
  • Date: 2006-12-04 22:22:38 UTC
  • mfrom: (1.1.6 feisty)
  • Revision ID: james.westby@ubuntu.com-20061204222238-6besz67g4z1e8oq5
Tags: 3.39-1
added new mime.types 

Show diffs side-by-side

added added

removed removed

Lines of Context:
2
2
.\" Update-mime and this manpage were written by Brian White and
3
3
.\" have been placed in the public domain (the only true "free").
4
4
.\"
5
 
.TH UPDATE-MIME 8 "16th Aug 1998" "Debian Project" "Update MIME Programs"
 
5
.TH UPDATE-MIME 8 "16th Jul 2006" "Debian Project" "Update MIME Programs"
6
6
.SH NAME
7
7
update\-mime \- create or update MIME information
8
8
.SH SYNOPSIS
20
20
.I /etc/mailcap
21
21
file can be altered by editing the
22
22
.I /etc/mailcap.order
23
 
file.  Please see the mailcap.order(5) man page for more information.
 
23
file.  Please see the
 
24
.BR mailcap.order(5)
 
25
man page for more information.
24
26
.SH CREATING ENTRIES
25
27
To create entries in the mailcap file, packages need to create a file
26
28
in the
51
53
that rule a "last resort".
52
54
.SS Commands
53
55
.TP
54
 
.BI view=<program-string>
 
56
.BI <program-string>
55
57
Specifies the program to run to view a file of the given content-type.
56
 
Actually, the "view=" must be omitted and the viewer program must be
57
 
the second value on the line (after the mime type).
58
 
.B This option connot be omitted.
59
 
When writing an entry that has no viewer, use a value of
 
58
.B This option setting connot be omitted.
 
59
An implicit "view=" can be considered before it.  When writing an
 
60
entry that has no viewer, use a value of
60
61
.I false
61
62
in this space.
62
63
.TP
113
114
.TP
114
115
.BI needsterminal
115
116
The "needsterminal" option, if given, indicates that the commands must
116
 
be run on an interactive terminal.  This is needed to inform window-
117
 
oriented user agents that an interactive terminal is needed.  (The
118
 
decision is not left exclusively to the command because in some
119
 
circumstances it may not be possible for such programs to tell whether
120
 
or not they are on interactive terminals.)  The needsterminal command
121
 
applies to the view, compose and edit commands, if they exist.  Note
122
 
that this is NOT a test -- it is a requirement for the environment in
123
 
which the program will be executed, and should typically cause the
124
 
creation of a terminal window when not executed on either a real
125
 
terminal or a terminal window.
 
117
be run on an interactive terminal.  This is needed to inform window-oriented
 
118
user agents that an interactive terminal is needed.  (The decision is
 
119
not left exclusively to the command because in some circumstances it
 
120
may not be possible for such programs to tell whether or not they are
 
121
on interactive terminals.)  The needsterminal command applies to the
 
122
view, compose and edit commands, if they exist.  Note that this is NOT
 
123
a test -- it is a requirement for the environment in which the program
 
124
will be executed, and will typically cause the creation of a terminal
 
125
window when not executed on either a real terminal or a terminal
 
126
window.
126
127
.TP
127
128
.BI copiousoutput
128
129
The "copiousoutput" option, if given, indicates that the output from the