summaryrefslogtreecommitdiff
path: root/texmf-dist/doc/man/man1/getnonfreefonts.1
blob: 5b141dc6218e1a85747a7460aa65265d604c3824 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
.TH getnonfreefonts 1 "December 2009" "TeX Live" "TeX Live"
.SH NAME
getnonfreefonts \- download and install fonts which cannot be
distributed on a CD
.LP
getnonfreefonts-sys \- download and install fonts system\-wide which
cannot be distributed on a CD

.SH SYNOPSIS

.BI "getnonfreefonts [" options "] [" fontlist ]
.sp
.BI "getnonfreefonts-sys [" options "] [" fontlist ]

.SH DESCRIPTION
Some font suppliers provide fonts which can be used freely but they
disallow that money is charged for the distribution.  Hence, for
distributions on CD or DVD it is usually impossible to include
these fonts.

.B "getnonfreefonts"
is a script which downloads and installs these fonts.  Actually, it
first downloads the program
.BI "getfont"<year>
from tug.org which is then executed.
.BI "getfont"<year>
does the real work.  It will be updated occasionally to support more
fonts.  
.I <year>
denotes the TeXLive release.

.B getnonfreefonts
and
.B getnonfreefonts-sys
are identical except that
.B getnonfreefonts
installs files to $TEXMFHOME
while
.B getnonfreefonts-sys
installs files to $TEXMFLOCAL.

.BI "getfont"<year>
will not be installed permanently on your system.  It only
exists in a temporary directory while 
.BI getnonfreefonts
is running.

Run
.B getnonfreefonts --lsfonts
to get a list of supported fonts.

.SH OPTIONS

.TP
.BR "-a" , " --all"
.rg
Install all fonts.

.TP
.BR "-d" , " --debug"
.rg
Provide additional messages for debugging.  These messages are sent to
STDERR.

.TP
.BR "-f" , " --force"
.rg
Install fonts even if they are installed already.

.TP
.BR "-h" , " --help"
.rg
Print a help message.  Nothing is installed but the directories where
the fonts will be installed and the temporary directory are shown.
.BI "<" PID ">" 
will be replaced by the process ID of the current
process. 

.TP
.BR "-H" , " --http"
.rg
Use HTTP instead of FTP.  This is useful if you are behind a firewall
which is blocking FTP.  However, you can't install fonts which are on
FTP servers.  Currently this is only "Adobe Euro".

.TP
.BR "-l" , " --lsfonts"
.rg
List all available fonts and tell whether they are installed already. 

.TP
.BR "-r" , " --refreshmap"
.rg
Register 
.B map 
files for already installed fonts and run 
.B updmap. 
This is needed after upgrading TeX Live to a newer release.

.TP
.B --sys
.rg
If you call
.B getnonfreefonts
with the
.B --sys
option, it behaves exactly as
.BR "getnonfreefonts-sys".

.TP
.BR "-v" , " --verbose"
.rg
Be more verbose.  This option is only needed for debugging.

.TP
.BR "--version"
.rg
Print version number.

.SH ENVIRONMENT
One of the environment variables
.BR "TMP" , " TEMP" ,
or 
.B  TMPDIR 
must exist.  They are used to determine where to put the temporary
files.  The directory must exist and must be writable.
.B /tmp
will be used if none of the variables is defined.

.SH REQUIREMENTS
Though this program is supposed to be used with 
.B TeX Live
it might work with other TeX distributions too.  The programs
.BR "wget"
or 
.BR "curl" ,
.BR "unzip" , 
and
.B kpsewhich
as well as a recent version of
.B updmap 
which supports the 
.B --enable
option are required.

.SH BUGS
Please send bug reports to Reinhard Kotucha <reinhard.kotucha@web.de>.