diff options
Diffstat (limited to 'Master/texmf/doc/man/man1/getnonfreefonts.1')
-rw-r--r-- | Master/texmf/doc/man/man1/getnonfreefonts.1 | 201 |
1 files changed, 74 insertions, 127 deletions
diff --git a/Master/texmf/doc/man/man1/getnonfreefonts.1 b/Master/texmf/doc/man/man1/getnonfreefonts.1 index c7506d616d1..b15235f8524 100644 --- a/Master/texmf/doc/man/man1/getnonfreefonts.1 +++ b/Master/texmf/doc/man/man1/getnonfreefonts.1 @@ -1,182 +1,129 @@ -.TH getnonfreefonts 1 "October 2005" "TeXLive" "TeXLive" +.TH getnonfreefonts 1 "January 2007" "TeXLive" "TeXLive" .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 -.B getnonfreefonts -.RI -[options] [font] -.LP -.B getnonfreefonts-sys -.RI -[options] [font] + +.BI "getnonfreefonts [" options "] [" fontlist ] +.sp +.BI "getnonfreefonts-sys [" options "] [" fontlist ] + .SH DESCRIPTION Some font suppliers provided 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. -.BI getnonfreefonts +.B "getnonfreefonts" is a script which downloads and installs these fonts. Actually, it first downloads the program -.BI getfont -from CTAN which is then executed. -.BI getfont +.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. +fonts. +.I <year> +denotes the TeXLive release. -.BI getnonfreefonts +.B getnonfreefonts and -.BI getnonfreefonts-sys +.B getnonfreefonts-sys are identical except that -.BI getnonfreefonts -installs files to -.RI $TEXMFHOME +.B getnonfreefonts +installs files to $TEXMFHOME while -.BI getnonfreefonts-sys -installs files to -.RI $TEXMFLOCAL -\. +.B getnonfreefonts-sys +installs files to $TEXMFLOCAL. -.BI getfont +.BI "getfont"<year> will not be installed permanently on your system. It only -exists while -.BI getnonfreefonts -is running. +exists in a temporary directory while .BI getnonfreefonts -passes all arguments to -.BI getfont. +is running. -If a font is specified, only this font will be installed, otherwise -all supported fonts will be installed. - -To get a list of supported fonts, run -.BI getnonfreefonts -.BI --lsfonts +Run +.B getnonfreefonts --lsfonts +to get a list of supported fonts. .SH OPTIONS -Only the options evaluated by -.BI getnonfreefonts -are described here. Run -.BI getnonfreefonts -.BI --help -to get a complete list. .TP -.B --ctan=<CTAN-node> +.BR "-a" , " --all" .rg -.B <CTAN-node> -can be either -.B -de -for ftp://ftp.dante.de (Hamburg, Germany), -.B -uk -for ftp://tex.ac.uk (Cambridge, UK), -or -.B us -for ftp://ctan.tug.org (Colchester, VT, US) - -The default is ftp://tex.ac.uk. +Install all fonts. .TP -.B --afm +.BR "-d" , " --debug" .rg -Install AFM files as well. They are not installed by default. You do -not need them if you don't know what they are good for. +Provide additional messages for debugging. These messages are sent to +STDERR. .TP -.B -n, --noinstall +.BR "-f" , " --force" .rg -Do not install anything. Useful to check whether fonts are available -which are not installed yet. - +Install fonts even if they are installed already. .TP -.B --shell +.BR "-h" , " --help" .rg -Run -.BI getnonfreefonts -in a shell. -.BI getfont -can be called directly and will exist on your system until you leave -the shell. If your internet connection is very slow, you can save some time. -Run -.BI getfont --help -first. - +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 -.B -h, --help +.BR "-l" , " --lsfonts" .rg -Get a complete list of options. This list will be more complete and -more up-to-date than this manual page. +List all available fonts and tell whether they are installed already. -.SH ENVIRONMENT -If the environt variable -.BI CTAN -is set to -.B ftp://<CTAN-node> -then this will be the default. The argument is an URL. - -.BI Example: -If your -.BI ~/.profile -contains the line -.BI CTAN=ftp://ftp.dante.de -then this will be the default. -If you are at a university which mirrors CTAN, you can set -.BI CTAN -to this mirror. It will work only if the mirror has the same -directory structure as CTAN, i.e if the directory -.BI tex-archive -is not omitted. - -.SH EXAMPLES .TP -.B getnonfreefonts --help +.B --sys .rg -Display all options and a list of supported fonts. Note that the -program -.B getfont -is installed temporarily and executed. You get more information than -this manual page can provide. - -.TP +If you call .B getnonfreefonts -.rg -Install all supported fonts which are not installed yet. +with the +.B --sys +option it behaves exactly like +.BR "getnonfreefonts-sys". .TP -.B getnonfreefonts utopia +.BR "-v" , " --verbose" .rg -Install Adobe Utopia if it is not installed yet. +Be more verbose. This option is only needed for debugging. .TP -.B getnonfreefonts --force --afm utopia +.BR "--version" .rg -Install Adobe Utopia and the corresponding AFM files even if Utopia is -already installed. - -.TP -.B getnonfreefonts --noinstall -.rg -No fonts will be installed. Instead you are told which fonts are -available and which of them are already installed. - -.TP -.B getnonfreefonts --shell -.rg -No fonts are installed. You'll get an interactive shell where you can -invoke -.BI getfont -manually. Run -.B getfont --help -first. +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 TeXLive +it might work with other TeX distributions too. The programs +.BR "wget" , +.BR "unzip" , +and +.B kpsewhich +have to be installed and a recent version of +.B updmap +is required which supports the +.B --enable +option. .SH BUGS Please send bug reports to Reinhard Kotucha <reinhard.kotucha@web.de>. |