11.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-ponysay-tool

--with-ponyponysay-tool-command=/usr/bin/ponyponysay-tool

Install the ponysay-tool 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

Install standard xterm ponies. (Default)

--with-ttyponies

Install standard tty ponies. (Default)

--with-extraponies

Install extra xterm ponies. (Default)

--with-extrattyponies

Install extra tty ponies. (Default)

--with-quotes

Install pony quotes. (Default)

--with-balloons

Install balloon styles. (Default)

--with-ucs

--with-ucs-names

Install UCS pony names. (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.

--sysconf-dir=/etc

Set the system’s local specific configuration directory.

--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.

--freedom=MANDITORY!

Set your freedom. If you the any of the values strict, full, true or yes, the setup will make sure that only completly free parts of the package is installed. This should be used (--freedom=strict) on distributions for GNU endorsed (endorsable) GNU/Linux-libre distributions.

If you do not want this, will need to explicity say so (you do also need to say if you do want it) by using either of the values sloppy, partial, false or no.

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.