NAME

portconfig — port options

SYNOPSIS

DESCRIPTION

The portconfig utility provides a TUI to customize the options to build a port. The following options are available:

-h

Display options, a short description and exit.

-v

Show version and exit.

The following user interface features are available:

F1 key

General PORTS usage.

Help button

Specific port help, if pkg-help exists.

Space key

Select/deselect an option.

ENVIRONMENT

The following environment variables can customize portconfig:

NO_COLOR=<something>

Disable colors if present and not an empty string (regardless of its value).

PORTCONFIG_ALIGNCENTER=YES

Align options to center, default left.

PORTCONFIG_ASCIILINES=YES

Ascii characters to draw lines.

PORTCONFIG_CLOCALE=YES

Force using only 8 bit characters, useful in non-utf-8 environments.

PORTCONFIG_FULLSCREEN=YES

Fullscreen mode.

PORTCONFIG_HEIGHT=<height>

Fixed height, default autosize.

PORTCONFIG_MINHEIGHT=<height>

Minimum height, takes effect only with autosize.

PORTCONFIG_MINWIDTH=<width>

Minimum width, takes effect only with autosize.

PORTCONFIG_NOLINES=YES

Do not draw lines.

PORTCONFIG_NOSHADOW=YES

Disable dialog shadow.

PORTCONFIG_THEMEFILE=<file>

Load theme file.

PORTCONFIG_WIDTH=<width>

Fixed width, default autosize.

See EXAMPLES section below.

D4PALIGNCENTER        PORTCONFIG_ALIGNCENTER
D4PASCIILINES         PORTCONFIG_ASCIILINES
D4PFULLSCREEN         PORTCONFIG_FULLSCREEN
D4PHEIGHT             PORTCONFIG_HEIGHT
D4PMINHEIGHT          PORTCONFIG_MINHEIGHT
D4PWIDTH              PORTCONFIG_WIDTH

FILES

The theme file /usr/local/etc/portconfig/theme.conf is read on startup if exists.

Template theme files are installed in /usr/local/etc/portconfig/.

To create a new theme file run:

THEME

The theme configuration in order of priority is as follows:

Check Terminal Colors.

portconfig checks if the environments has colors, otherwise sets black and white theme.

env NO_COLOR=<something>

If present and not an empty string sets black and white theme.

env PORTCONFIG_THEMEFILE=<file>

if <file> exists and is well-formed its theme is set. Otherwise the default theme is set.

/usr/local/etc/portconfig/theme.conf

if the file exists and is well-formed its theme is set. Otherwise the default theme is set.

Otherwise

Default theme file set.

These options are mutually exclusive.

EXIT STATUS

The portconfig utility exits 0 on success, and >0 if an error occurs.

EXAMPLES

Examples refer to a standard installation with sh(1) and tcsh(1) calling portconfig implicitly via “make config” in /usr/ports/<category>/<port>.

To run portconfig in black and white:

Add the following line to make.conf(5) to make this setting permanent:

SEE ALSO

portoptscli(1), ports(7)

AUTHORS

The portconfig utility was written by Alfonso Sabato Siciliano <asiciliano@FreeBSD.org>.

THANKS TO

Baptiste Daroussin <bapt@FreeBSD.org> for suggestions, help, and testing.