Merge branch '2.7rc' into 2.7.x

1 files changed, 80 insertions, 0 deletions

diff --git a/man/man8/puppet-config.8 b/man/man8/puppet-config.8
new file mode 100644
index 000000000..f7592a43b
--- /dev/null
+++ b/man/man8/puppet-config.8
@@ -0,0 +1,80 @@
+.\" generated with Ronn/v0.7.3
+.\" http://github.com/rtomayko/ronn/tree/0.7.3
+.
+.TH "PUPPET\-CONFIG" "8" "June 2011" "Puppet Labs, LLC" "Puppet manual"
+.
+.SH "NAME"
+\fBpuppet\-config\fR \- Interact with Puppet\'s configuration options\.
+.
+.SH "SYNOPSIS"
+puppet config \fIaction\fR
+.
+.SH "OPTIONS"
+Note that any configuration parameter that\'s valid in the configuration file is also a valid long argument, although it may or may not be relevant to the present action\. For example, \fBserver\fR is a valid configuration parameter, so you can specify \fB\-\-server <servername>\fR as an argument\.
+.
+.P
+See the configuration file documentation at \fIhttp://docs\.puppetlabs\.com/references/stable/configuration\.html\fR for the full list of acceptable parameters\. A commented list of all configuration options can also be generated by running puppet with \fB\-\-genconfig\fR\.
+.
+.TP
+\-\-mode MODE
+The run mode to use for the current action\. Valid modes are \fBuser\fR, \fBagent\fR, and \fBmaster\fR\.
+.
+.TP
+\-\-render\-as FORMAT
+The format in which to render output\. The most common formats are \fBjson\fR, \fBs\fR (string), \fByaml\fR, and \fBconsole\fR, but other options such as \fBdot\fR are sometimes available\.
+.
+.TP
+\-\-verbose
+Whether to log verbosely\.
+.
+.TP
+\-\-debug
+Whether to log debug information\.
+.
+.SH "ACTIONS"
+.
+.TP
+\fBprint\fR \- Examine Puppet\'s current configuration settings\.
+\fBSYNOPSIS\fR
+.
+.IP
+puppet config print (all | \fIsetting\fR [\fIsetting\fR \.\.\.]
+.
+.IP
+\fBDESCRIPTION\fR
+.
+.IP
+Prints the value of a single configuration option or a list of configuration options\.
+.
+.IP
+This action is an alternate interface to the information available with \fBpuppet <subcommand> \-\-configprint\fR\.
+.
+.IP
+\fBRETURNS\fR
+.
+.IP
+A single value when called with one config setting, and a list of settings and values when called with multiple options or "all\."
+.
+.IP
+\fBNOTES\fR
+.
+.IP
+By default, this action reads the configuration in agent mode\. Use the \'\-\-mode\' and \'\-\-environment\' flags to examine other configuration domains\.
+.
+.SH "EXAMPLES"
+\fBprint\fR
+.
+.P
+Get puppet\'s runfile directory:
+.
+.P
+$ puppet config print rundir
+.
+.P
+Get a list of important directories from the master\'s config:
+.
+.P
+$ puppet config print all \-\-mode master | grep \-E "(path|dir)"
+.
+.SH "COPYRIGHT AND LICENSE"
+Copyright 2011 by Puppet Labs Apache 2 license; see COPYING