sortix--sortix/tix/tix-vars.8

.Dd June 5, 2022
.Dt TIX-VARS 8
.Os
.Sh NAME
.Nm tix-vars
.Nd evaluate variables in port files
.Sh SYNOPSIS
.Nm
.Op Fl t
.Op Fl d Ar default
.Ar file
.Op Ar variable ...
.Sh DESCRIPTION
.Nm
evaluates the variables in the
.Xr port 5
named by
.Ar file
or the standard input if
.Ar file
is
.Sq - .
If any
.Ar variables
are requested then their raw values are written as lines.
Otherwise all the variables are written in a normalized form as lines with an
equals sign
.Sq =
separating the variable name and the raw value.
.Pp
The options are as follows:
.Bl -tag -width "12345678"
.It Fl d Ar default
Use the
.Ar default
value instead if the variable is unset.
.It Fl t
Test quietly whether the file is syntactically correct and whether the variables
are set without writing their contents.
.El
.Sh EXIT STATUS
.Nm
will exit 0 on success,
exit 1 on a syntax error or if the requested variable is unset,
and exit 2 otherwise.
.Sh SEE ALSO
.Xr port 5 ,
.Xr tix-build 8 ,
.Xr tix-port 8
.Sh HISTORY
.Nm
originally appeared in Sortix 1.1.
Add ports to the Sortix repository. This change imports the ports collection from the former porttix and srctix repositories and converts them to port(5) files with metadata pointing to the upstream release tarballs with patches checked into this repository. Ports are now developed and versioned along with the operating system and are automatically built per the PACKAGES environment variable. The patches are licensed under the same license as the relevant ports. Tix has gained support for the new port(5) format. tix-port(8) is the new high level ports build even point that handles downloading pstream releases into the new mirror cache directory, applying the patches, building the port with the lower-level tix-build(8), and finally installing the binary package. The new tix-vars(8) program parses port(5) files and the new tix-rmdiff(8) program produces input for tix-rmpatch(8). The old doc/ directory is discontinued in favor of manual pages documenting the new ports system. The obsolete porttix-create(8) and srctix-create(8) programs are removed. 2022-06-13 16:29:53 -04:00			`.Dd June 5, 2022`
			`.Dt TIX-VARS 8`
			`.Os`
			`.Sh NAME`
			`.Nm tix-vars`
			`.Nd evaluate variables in port files`
			`.Sh SYNOPSIS`
			`.Nm`
			`.Op Fl t`
			`.Op Fl d Ar default`
			`.Ar file`
			`.Op Ar variable ...`
			`.Sh DESCRIPTION`
			`.Nm`
			`evaluates the variables in the`
			`.Xr port 5`
			`named by`
			`.Ar file`
			`or the standard input if`
			`.Ar file`
			`is`
			`.Sq - .`
			`If any`
			`.Ar variables`
			`are requested then their raw values are written as lines.`
			`Otherwise all the variables are written in a normalized form as lines with an`
			`equals sign`
			`.Sq =`
			`separating the variable name and the raw value.`
			`.Pp`
			`The options are as follows:`
			`.Bl -tag -width "12345678"`
			`.It Fl d Ar default`
			`Use the`
			`.Ar default`
			`value instead if the variable is unset.`
			`.It Fl t`
			`Test quietly whether the file is syntactically correct and whether the variables`
			`are set without writing their contents.`
			`.El`
			`.Sh EXIT STATUS`
			`.Nm`
			`will exit 0 on success,`
			`exit 1 on a syntax error or if the requested variable is unset,`
			`and exit 2 otherwise.`
			`.Sh SEE ALSO`
			`.Xr port 5 ,`
			`.Xr tix-build 8 ,`
			`.Xr tix-port 8`
			`.Sh HISTORY`
			`.Nm`
			`originally appeared in Sortix 1.1.`