Version 2.2

Item posted by Sergey Poznyakoff <gray> on Sun Jan 16 19:43:47 2022.

Version 2.2 of xenv is available for download.

New in this version:

Detailed error locations

Diagnostic messages include as much information about error location as possible. At most, two locations are printed, corresponding to the start and end of the erroneous portion of text:

FILE1:LINE1.COLUMN1-FILE2:LINE2.COLUMN2

If FILE1 and FILE2 is the same, the location is rendered as:

FILE1:LINE1.COLUMN1-LINE2.COLUMN2

If LINE1 is the same as LINE2 as well, the location is rendered as:

FILE1:LINE1.COLUMN1-COLUMN2

If end location is not applicable (e.g. at end of file), only the start location is output:

FILE:LINE.COLUMN

Environment meta-variable and the -e ENV option

Environment meta-variable is an optional feature that makes variable indirections more visible. Use it if your input text can contain considerable number of indirection characters (sigils) that can be
falsely identified as variable references. The meta-variable is defined using the -e option, e.g.:

xenv -e ENV

Once you define it, variable reference syntax becomes $ENV{NAME}, instead of just $NAME. Tests for variable that is unset or null are modified accordingly. Thus, e.g. $ENV{NAME:-text} substitutes "text" if the variable NAME is unset or null and so on. The construct for verbatim quotations becomes $ENV[...], and comments are modified accordingly.

Use of the -S option and $$sigil directive is deprecated

Both will be removed in future versions. You are advised to use -e option instead.

Currently, a warning message is issued each time a -S or $$sigil is used. To suppress the message, use the -Wsigil option. To turn -S and $$sigil off, use the -Wno-sigil option.

New option -W controls various xenv features

The -W option can be used to disable certain xenv features. There are currently five features:

• command - command expansion
• comment - multi-line comments
• directive - preprocessor directives
• quote - $[ ... ] constructs
• sigil - the deprecated sigil-changing feature (-S and $$sigil)

All of them are enabled by default. To disable a particular feature, use the -Wno-FEATURE option. For example, -Wno-command disables command expansions.

Following are the checksums for the new release (MD5, SHA1, and SHA512):