summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man/man1/getnonfreefonts.1
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf/doc/man/man1/getnonfreefonts.1')
-rw-r--r--Master/texmf/doc/man/man1/getnonfreefonts.1182
1 files changed, 182 insertions, 0 deletions
diff --git a/Master/texmf/doc/man/man1/getnonfreefonts.1 b/Master/texmf/doc/man/man1/getnonfreefonts.1
new file mode 100644
index 00000000000..c7506d616d1
--- /dev/null
+++ b/Master/texmf/doc/man/man1/getnonfreefonts.1
@@ -0,0 +1,182 @@
+.TH getnonfreefonts 1 "October 2005" "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]
+.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
+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
+does the real work. It will be updated occasionally to support more
+fonts.
+
+.BI getnonfreefonts
+and
+.BI getnonfreefonts-sys
+are identical except that
+.BI getnonfreefonts
+installs files to
+.RI $TEXMFHOME
+while
+.BI getnonfreefonts-sys
+installs files to
+.RI $TEXMFLOCAL
+\.
+
+.BI getfont
+will not be installed permanently on your system. It only
+exists while
+.BI getnonfreefonts
+is running.
+.BI getnonfreefonts
+passes all arguments to
+.BI getfont.
+
+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
+
+.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>
+.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.
+
+.TP
+.B --afm
+.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.
+
+.TP
+.B -n, --noinstall
+.rg
+Do not install anything. Useful to check whether fonts are available
+which are not installed yet.
+
+
+.TP
+.B --shell
+.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.
+
+
+.TP
+.B -h, --help
+.rg
+Get a complete list of options. This list will be more complete and
+more up-to-date than this manual page.
+
+.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
+.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
+.B getnonfreefonts
+.rg
+Install all supported fonts which are not installed yet.
+
+.TP
+.B getnonfreefonts utopia
+.rg
+Install Adobe Utopia if it is not installed yet.
+
+.TP
+.B getnonfreefonts --force --afm utopia
+.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.
+
+
+.SH BUGS
+Please send bug reports to Reinhard Kotucha <reinhard.kotucha@web.de>.