Previous: Installations basics, Up: From upstream


9.1.2 Custom installations

With the exception for with --with-everything and --with-nothing, every option that starts with --with- or --without- exists in both variants. --with- options install parts of the package. --without- options skips installation of parts of the packages. With the same exception, --without- options take not arguments and --with- optionally takes an argument, if no argument is provided a default argument is implied.

The configuration script recognised the following options, the default values for options with arguments are written after the equality sign (=) in the option:

--everything
--with-everything
Install everything that is not explicity excluded.
--minimal
Install only the essentials. Note that this can vary depending on version. Currently this means that the commands, xterm ponies and legal documents is installed.
--nothing
--with-nothing
Install nothing, except legal documents, that is not explicity included.
--with-ponysay
--with-ponysay-command=/usr/bin/ponysay
Install the ponysay command, and set file name. (Default)
--with-ponythink
--with-ponythink-command=/usr/bin/ponythink
Install the ponythink command, and set file name. (Default)
--with-shared-cache=/var/cache/ponysay
Install a user shared cache, this is only used by KMS ponies so far. (Default)
--with-bash
--with-bash-completion=/usr/share/bash-completion/completions/ponysay
Install auto-completion for installed commands in GNU Bash. Select the file name for the installed script for the ponysay command, the other commands modifies this file name. (Default)
--with-fish
--with-fish-completion=/usr/share/fish/completions/ponysay.fish
Install auto-completion for installed commands in Friendly interactive shell. Select the file name for the installed script for the ponysay command, the other commands modifies this file name. (Default)
--with-zsh
--with-zsh-completion=/usr/share/zsh/site-functions/_ponysay
Install auto-completion for installed commands in the zsh shell. Select the file name for the installed script for the ponysay command, the other commands modifies this file name. (Default)
--with-shell
--with-shell-completion=/usr/share
Macro for --with-bash, --with-fish and --with-zsh. The argument is the used share/ directory that all shells have in common.
--with-pdf
--with-pdf-manual=/usr/doc
Install PDF manual, and select directory for it.
--with-pdf-compression
--with-pdf-manual-compression=gz
Compress PDF manual, select compression by file name extension. This option does not imply --with-pdf. (Default)
--with-info
--with-info-manual=/usr/share/info
Install info manual, and select directory for it. (Default)
--with-info-install
--with-info-manual-install=My Little Ponies for your terminal
Use install-info when installing info manual. Set the description for the manual. This option does not imply --with-info. (Default)
--with-info-compression
--with-info-manual-compression=gz
Compress info manual, select compression by file name extension. This option does not imply --with-info. (Default)
--with-man-en
--with-manpage-en
--with-man-manual-en
--with-en-man
--with-en-manpage
--with-en-man-manual=/usr/share/man
Install English man manual. Set directory for man manuals. (Default)
--with-man-es
--with-manpage-es
--with-man-manual-es
--with-es-man
--with-es-manpage
--with-es-man-manual=/usr/share/man
Install Spanish man manual. Set directory for man manuals.
--with-man
--with-manpage
--with-man-manual
Macro for all --with-man-LANG.
--with-man-en-compression
--with-manpage-en-compression
--with-man-manual-en-compression
--with-en-man-compression
--with-en-manpage-compression
--with-en-man-manual-compression=gz
Compress English man manual, select compression by file name extension. This option does not imply --with-man-en. (Default)
--with-man-es-compression
--with-manpage-es-compression
--with-man-manual-es-compression
--with-es-man-compression
--with-es-manpage-compression
--with-es-man-manual-compression=gz
Compress Spanish man manual, select compression by file name extension. This option does not imply --with-man-es. (Default)
--with-man-compression
--with-manpage-compression
--with-man-manual-compression
Macro for all --with-man-LANG-compression.
--man-section-ponysay
--man-sectionpage-ponysay
--ponysay-man-section
--ponysay-manpage-section=6
Change the section for the ponysay manpage.
--man-section-cowsay
--manpage-section-cowsay
--cowsay-man-section
--cowsay-manpage-section=1
Change the section for the cowsay manpage.
--man-section-fortune
--manpage-section-fortune
--fortune-man-section
--fortune-manpage-section=6
Change the section for the fortune manpage.
--with-ponies=/usr/share/ponysay/ponies
Install standard xterm ponies, and select installation directory for them. (Default)
--with-ttyponies=/usr/share/ponysay/ttyponies
Install standard tty ponies, and select installation directory for them. (Default)
--with-extraponies=/usr/share/ponysay/extraponies
Install extra xterm ponies, and select installation directory for them. (Default)
--with-extrattyponies=/usr/share/ponysay/extrattyponies
Install extra tty ponies, and select installation directory for them. (Default)
--with-quotes=/usr/share/ponysay/quotes
Install pony quotes, and select installation directory for them. (Default)
--with-balloons=/usr/share/ponysay/balloons
Install balloon styles, and select installation directory for them. (Default)
--with-ucs
--with-ucs-names=/usr/share/ponysay/ucsmap
Install UCS pony names, and select installation file name for the map. (Default)
--without-custom-env-python
Let the installer set the env name for python in ponysay. (Default)
--with-custom-env-python=python3
Set the env name for python in ponysay.
--prefix=/usr
Set a prefix to all implicit directories.
--private
Change all implicit configurations to fit local user a installation for the current user.
--opt
Change all implicit directories to fit installation to /opt.
--bin-dir=/usr/bin
Set the system's directory for command executables.
--lib-dir=/usr/lib/ponysay
Set the system's directory for non-command executables. Currently their is not non-executable library, so this options has no effect, but bleeding edge distributors should specify it if it differs from prefered.
--libexec-dir=/usr/libexec/ponysay
Set the system's directory for non-command executables. Currently their is not non-command executables, so this options has no effect, but bleeding edge distributors should specify it if it differs from prefered.
--share-dir=/usr/share
Set the system's directory for resource files.
--cache-dir=/var/cache
Set the system's directory for cache directories.
--dest-dir=
Set off environment for installation.
--linking=symbolic
Set how to link identical files. Directories cannot be hard linked on most systems, therefore directories or always symbolically linked of hard linked is specified. Recognised arguments are copy, hard and symbolic. copy implies that files and directories are not linked, but duplicated. ponysay -L will give the same output as ponysay -l if copy or hard is used. This is because it does link reading and not content or inode comparison.

Recognised compressions are gz which uses gzip -9, and xz which uses xz -9e. xz is still exotic to most programs, using it is not recommended. Distributors are strongly disencouraged to compression for the PDF manual and should use --without-pdf-compression.

You can run ./setup.py [OPTIONS] view to make sure everything is correct before building and installing.