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

NAME

6       yacg - Yet Another Configuration Generator
7

SYNOPSIS

9       yacg [OPTIONS] PATH
10
11       yacg --help|--manual|--version
12

DESCRIPTION

14       yacg reads the given high-level configuration file, carefully validates
15       it and generates ready-to-use (configuration) files.
16
17       The high-level configuration file can be altered using the --set,
18       --unset and --merge options. It can be inspected using the --dump
19       option.
20
21       The files can be generated at their final location (by default) or
22       elsewhere (using the --rootdir option). yacg can also be instructed to
23       check the files without changing them via the --noaction option.
24
25       yacg can use a "manifest" file to keep track of which files it
26       generated so that it can later remove the files that it does not
27       generate anymore, see the --manifest and --clean options.
28
29       yacg by itself does not know how to generate files. The --home option
30       (and optionally the --include option) must be used to tell the program
31       where to find domain specific modules knowing how to translate the
32       high-level configuration into individual ready-to-use files.
33

OPTIONS

35       --clean
36           remove the files present in the old "manifest" file but not in the
37           new one
38
39       --debug, -d
40           show debugging information
41
42       --dump
43           instead of generating files, dump the high-level configuration;
44           this option can be given multiple times:
45
46           1: dump after loading the configuration
47           2: dump after hacking the configuration
48           3: dump after validating the configuration
49       --dump-format NAME
50           set the output format for the --dump option; possible values:
51           "Config::General" (default) and "JSON"
52
53       --help, -h, -?
54           show some help
55
56       --home, -H PATH
57           set the home directory where the "cfg", "lib" and "tpl" sub-
58           directories may be located
59
60       --include, -I PATH
61           add the given directory to the list of paths that will be looked at
62           to find configuration files, Config::Generator modules or
63           templates; this option can be given multiple times
64
65       --manifest PATH
66           store the list of files that yacg handled in the given "manifest"
67           file
68
69       --manual, -m
70           show this manual
71
72       --merge PATH=VALUE
73           hack the loaded configuration to merge the given value at the given
74           path
75
76       --noaction, -n
77           print what would be done but do not actually touch the generated
78           files
79
80       --quiet, -q
81           set the verbosity level to 0
82
83       --rndfile PATH
84           set the path of the file that will be used as seed to generate
85           random data
86
87       --rootdir PATH
88           set the path specifying where the generated files will be put
89
90       --set PATH=VALUE
91           hack the loaded configuration to set the given value at the given
92           path
93
94       --spec PATH
95           store the list of files that yacg handled in the given "spec" file
96           (same format as rpm's spec %files)
97
98       --unset PATH
99           hack the loaded configuration to unset the given path
100
101       --verbose, -v
102           increase the verbosity level (default: 1)
103
104       --version
105           display version information
106

SEE ALSO

108       Config-Generator.
109

AUTHOR

111       Lionel Cons <http://cern.ch/lionel.cons>
112
113       Copyright (C) CERN 2013-2016
114
115
116
117perl v5.28.1                      2016-05-24                           YACG(1)
Impressum