Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
PORTCONFIG(1)		     General Commands Manual		   PORTCONFIG(1)

NAME
     portconfig -- port options

SYNOPSIS
     portconfig [-h | -v]

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

     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.

   Compatibility
     The following environment variables are available for compatibility:
	   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:
	   /usr/local/bin/bsddialog   --save-theme   mytheme.conf   --infobox  \
	   "Saving theme..." 0 0

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:
	   env NO_COLOR=YES make config

     Add the following line to make.conf(5) to make this setting permanent:
	   export NO_COLOR=YES

SEE ALSO
     portoptscli(1), ports(7)

AUTHORS
     The portconfig utility was written by  Alfonso  Sabato  Siciliano	<asicil-
     iano@FreeBSD.org>.

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

FreeBSD ports 15.quarterly	 January 7, 2025		   PORTCONFIG(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=portconfig&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help