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.	Other-
	       wise the	default	theme is set.

       /usr/local/etc/portconfig/theme.conf
	       if the file exists and is well-formed its theme is set.	Other-
	       wise 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)	 call-
       ing	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
       <asiciliano@FreeBSD.org>.

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

FreeBSD	14.3			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+14.3-RELEASE+and+Ports>

home | help