1GUARDS(1)             User Contributed Perl Documentation            GUARDS(1)
2
3
4

NAME

6       guards - select from a list of files guarded by conditions
7

SYNOPSIS

9       guards [--prefix=dir] [--path=dir1:dir2:...] [--default=<0|1>]
10       [--check|--list] [--invert-match] [--with-guards] [--config=<file>]
11       symbol ...
12

DESCRIPTION

14       The script reads a configuration file that may contain so-called
15       guards, file names, and comments, and writes those file names that
16       satisfy all guards to standard output. The script takes a list of
17       symbols as its arguments. Each line in the configuration file is
18       processed separately. Lines may start with a number of guards. The
19       following guards are defined:
20
21           +xxx Include the file(s) on this line if the symbol xxx is defined.
22
23           -xxx Exclude the file(s) on this line if the symbol xxx is defined.
24
25           +!xxx Include the file(s) on this line if the symbol xxx is not
26           defined.
27
28           -!xxx Exclude the file(s) on this line if the symbol xxx is not
29           defined.
30
31           - Exclude this file. Used to avoid spurious --check messages.
32
33       The guards are processed left to right. The last guard that matches
34       determines if the file is included. If no guard is specified, the
35       --default setting determines if the file is included.
36
37       If no configuration file is specified, the script reads from standard
38       input.
39
40       The --check option is used to compare the specification file against
41       the file system. If files are referenced in the specification that do
42       not exist, or if files are not enlisted in the specification file
43       warnings are printed. The --path option can be used to specify which
44       directory or directories to scan.  Multiple directories are separated
45       by a colon (":") character. The --prefix option specifies the location
46       of the files. Alternatively, the --path=@<file> syntax can be used to
47       specify a file from which the file names will be read.
48
49       Use --list to list all files independent of any rules. Use
50       --invert-match to list only the excluded patches. Use --with-guards to
51       also include all inclusion and exclusion rules.
52

AUTHOR

54       Andreas Gruenbacher <agruen@suse.de>, SUSE Labs
55
56
57
58perl v5.38.0                      2023-07-21                         GUARDS(1)
Impressum