1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
|
config = Puppet::Util::Reference.newreference(:configuration, :depth => 1, :doc => "A reference for all configuration parameters") do
docs = {}
Puppet.settings.each do |name, object|
docs[name] = object
end
str = ""
docs.sort { |a, b|
a[0].to_s <=> b[0].to_s
}.each do |name, object|
# Make each name an anchor
header = name.to_s
str += h(header, 3)
# Print the doc string itself
begin
str += object.desc.gsub(/\n/, " ")
rescue => detail
puts detail.backtrace
puts detail
end
str += "\n\n"
# Now print the data about the item.
str += ""
val = object.default
if name.to_s == "vardir"
val = "/var/lib/puppet"
elsif name.to_s == "confdir"
val = "/etc/puppet"
end
# Leave out the section information; it was apparently confusing people.
#str += "- **Section**: #{object.section}\n"
unless val == ""
str += "- *Default*: #{val}\n"
end
str += "\n"
end
return str
end
config.header = <<EOT
## Configuration Settings
* Each of these settings can be specified in `puppet.conf` or on the
command line.
* When using boolean settings on the command line, use `--setting` and
`--no-setting` instead of `--setting (true|false)`.
* Settings can be interpolated as `$variables` in other settings; `$environment`
is special, in that puppet master will interpolate each agent node's
environment instead of its own.
* Multiple values should be specified as comma-separated lists; multiple
directories should be separated with the system path separator (usually
a colon).
* Settings that take a single file or directory can optionally set the owner,
group, and mode for their value: `rundir = $vardir/run { owner = puppet,
group = puppet, mode = 644 }`
* The Puppet executables will ignore any setting that isn't relevant to
their function.
See the [configuration guide][confguide] for more details.
[confguide]: http://docs.puppetlabs.com/guides/configuring.html
* * *
EOT
|
