chef 11.14.0.alpha.4 → 11.14.0.rc.2

data/CONTRIBUTING.md

@@ -177,8 +177,6 @@ We do a `Minor` release approximately every 3 months and `Patch` releases on a w
 Announcements of releases are available on [Chef Blog](http://www.getchef.com/blog) when they are
   available.
 
-  **TODO**: Can I sign up for a mailing list to get notification of releases?
-
 ## Chef Community
 
 Chef is made possible by a strong community of developers and system administrators. If you have
@@ -189,8 +187,6 @@ Chef is made possible by a strong community of developers and system administrat
 
 Also here are some additional pointers to some awesome Chef content:
 
-**TODO**: Any blogs of community folks that we would like to put in here?
-
 * [Chef Docs](http://docs.opscode.com/)
 * [Learn Chef](https://learnchef.opscode.com/)
 * [Chef Inc](http://www.getchef.com/)

data/README.md

@@ -1,4 +1,4 @@
-# Chef
+# Chef [![Code Climate](https://codeclimate.com/github/opscode/chef.png)](https://codeclimate.com/github/opscode/chef)
 
 Want to try Chef? Get started with [learnchef](https://learnchef.opscode.com)
 

data/distro/common/man/man1/chef-shell.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "CHEF-SHELL" "1" "Chef 11.12.0" "" "chef-shell"
+.TH "CHEF-SHELL" "1" "Chef 11.14" "" "chef-shell"
 .SH NAME
 chef-shell \- The man page for the chef-shell command line tool.
 .
@@ -91,7 +91,7 @@ This command has the following options:
 .INDENT 0.0
 .TP
 .B \fB\-a\fP, \fB\-\-standalone\fP
-Indicates that chef\-shell will be run in standalone mode.
+Use to run chef\-shell in standalone mode.
 .TP
 .B \fB\-c CONFIG\fP, \fB\-\-config CONFIG\fP
 The configuration file to use.
@@ -106,7 +106,7 @@ The path to a file that contains JSON data.
 The level of logging that will be stored in a log file.
 .TP
 .B \fB\-s\fP, \fB\-\-solo\fP
-Indicates that chef\-shell will be run in chef\-solo mode.
+Use to run chef\-shell in chef\-solo mode.
 .TP
 .B \fB\-S CHEF_SERVER_URL\fP, \fB\-\-server CHEF_SERVER_URL\fP
 The URL for the Chef server\&.
@@ -115,7 +115,7 @@ The URL for the Chef server\&.
 The version of the chef\-client\&.
 .TP
 .B \fB\-z\fP, \fB\-\-client\fP
-Indicates that chef\-shell will be run in chef\-client mode.
+Use to run chef\-shell in chef\-client mode.
 .UNINDENT
 .SH AUTHOR
 Chef

data/distro/common/man/man1/knife-bootstrap.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-BOOTSTRAP" "1" "Chef 11.12.0" "" "knife bootstrap"
+.TH "KNIFE-BOOTSTRAP" "1" "Chef 11.14" "" "knife bootstrap"
 .SH NAME
 knife-bootstrap \- The man page for the knife bootstrap subcommand.
 .
@@ -55,7 +55,7 @@ This subcommand has the following options:
 .INDENT 0.0
 .TP
 .B \fB\-A\fP, \fB\-\-forward\-agent\fP
-Indicates that SSH agent forwarding is enabled.
+Use to enable SSH agent forwarding.
 .TP
 .B \fB\-\-bootstrap\-no\-proxy NO_PROXY_URL_or_IP\fP
 A URL or IP address that specifies a location that should not be proxied. Note: This option is used internally by Chef to help verify bootstrap operations during testing and should never be used during an actual bootstrap operation.
@@ -73,7 +73,7 @@ The configuration file to use.
 The port on which chef\-zero will listen.
 .TP
 .B \fB\-\-[no\-]color\fP
-Indicates whether colored output will be used.
+Use to view colored output.
 .TP
 .B \fB\-d DISTRO\fP, \fB\-\-distro DISTRO\fP
 .sp
@@ -87,10 +87,10 @@ The default bootstrap operation uses the omnibus installer, which means the defa
 The template file to be used during a bootstrap operation. The following distributions are supported: \fBchef\-full\fP (the default bootstrap), \fBcentos5\-gems\fP, \fBfedora13\-gems\fP, \fBubuntu10.04\-gems\fP, \fBubuntu10.04\-apt\fP, \fBubuntu12.04\-gems\fP, and the name of a custom bootstrap template file. When this option is used, Knife will search for the template file in the following order: the \fBbootstrap/\fP folder in the current working directory, the \fBbootstrap/\fP folder in the chef\-repo, the \fBbootstrap/\fP folder in the \fB~/.chef/\fP directory, or a default bootstrap file. Do not use the \fB\-\-template\-file\fP option when \fB\-\-distro\fP is specified.
 .TP
 .B \fB\-\-defaults\fP
-Indicates that Knife will use the default value, instead of asking a user to provide one.
+Use to have Knife use the default value instead of asking a user to provide one.
 .TP
 .B \fB\-\-disable\-editing\fP
-Indicates that $EDITOR will not be opened; data will be accepted as\-is.
+Use to prevent the $EDITOR from being opened and to accept data as\-is.
 .TP
 .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
 The $EDITOR that is used for all interactive commands.
@@ -132,10 +132,10 @@ The SSH port.
 The SSH password. This can be used to pass the password directly on the command line. If this option is not specified (and a password is required) Knife will prompt for the password.
 .TP
 .B \fB\-\-prerelease\fP
-Indicates that pre\-release gems should be installed.
+Use to install pre\-release gems.
 .TP
 .B \fB\-\-print\-after\fP
-Indicates that data will be shown after a destructive operation.
+Use to show data after a destructive operation.
 .TP
 .B \fB\-r RUN_LIST\fP, \fB\-\-run\-list RUN_LIST\fP
 A comma\-separated list of roles and/or recipes to be applied.
@@ -150,7 +150,7 @@ The encryption key that is used for values contained within a data bag item.
 The path to the file that contains the encryption key.
 .TP
 .B \fB\-\-sudo\fP
-Indicates that a bootstrap operation should be executed using sudo\&.
+Use to execute a bootstrap operation with sudo\&.
 .TP
 .B \fB\-\-template\-file TEMPLATE\fP
 The path to a template file that will be used during a bootstrap operation. Do not use the \fB\-\-distro\fP option when \fB\-\-template\-file\fP is specified.
@@ -159,7 +159,7 @@ The path to a template file that will be used during a bootstrap operation. Do n
 The user name used by Knife to sign requests made by the API client to the Chef server\&. Authentication will fail if the user name does not match the private key.
 .TP
 .B \fB\-\-use\-sudo\-password\fP
-Indicates that a bootstrap operation is done using sudo, with the password specified by the \fB\-P\fP (or \fB\-\-ssh\-password\fP) option.
+Use to perform a bootstrap operation with sudo; specify the password with the \fB\-P\fP (or \fB\-\-ssh\-password\fP) option.
 .TP
 .B \fB\-v\fP, \fB\-\-version\fP
 The version of the chef\-client\&.
@@ -167,14 +167,17 @@ The version of the chef\-client\&.
 .B \fB\-V\fP, \fB\-\-verbose\fP
 Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
 .TP
+.B \fB\-V \-V\fP
+Use to run the initial chef\-client run at the \fBdebug\fP log\-level (e.g. \fBchef\-client \-l debug\fP).
+.TP
 .B \fB\-x USERNAME\fP, \fB\-\-ssh\-user USERNAME\fP
 The SSH user name.
 .TP
 .B \fB\-y\fP, \fB\-\-yes\fP
-Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
+Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
 .TP
 .B \fB\-z\fP, \fB\-\-local\-mode\fP
-Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
+Use to run the chef\-client in local mode. This allows all commands that work against the Chef server to also work against the local chef\-repo\&.
 .UNINDENT
 .sp
 \fBExamples\fP

data/distro/common/man/man1/knife-client.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-CLIENT" "1" "Chef 11.12.0" "" "knife client"
+.TH "KNIFE-CLIENT" "1" "Chef 11.14" "" "knife client"
 .SH NAME
 knife-client \- The man page for the knife client subcommand.
 .
@@ -52,10 +52,10 @@ The port on which chef\-zero will listen.
 The configuration file to use.
 .TP
 .B \fB\-d\fP, \fB\-\-disable\-editing\fP
-Indicates that $EDITOR will not be opened; data will be accepted as\-is.
+Use to prevent the $EDITOR from being opened and to accept data as\-is.
 .TP
 .B \fB\-\-defaults\fP
-Indicates that Knife will use the default value, instead of asking a user to provide one.
+Use to have Knife use the default value instead of asking a user to provide one.
 .TP
 .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
 The $EDITOR that is used for all interactive commands.
@@ -73,10 +73,10 @@ Shows help for the command.
 The private key that Knife will use to sign requests made by the API client to the Chef server\&.
 .TP
 .B \fB\-\-[no\-]color\fP
-Indicates whether colored output will be used.
+Use to view colored output.
 .TP
 .B \fB\-\-print\-after\fP
-Indicates that data will be shown after a destructive operation.
+Use to show data after a destructive operation.
 .TP
 .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
 The URL for the Chef server\&.
@@ -91,10 +91,10 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
 The version of the chef\-client\&.
 .TP
 .B \fB\-y\fP, \fB\-\-yes\fP
-Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
+Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
 .TP
 .B \fB\-z\fP, \fB\-\-local\-mode\fP
-Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
+Use to run the chef\-client in local mode. This allows all commands that work against the Chef server to also work against the local chef\-repo\&.
 .UNINDENT
 .SH BULK DELETE
 .sp
@@ -147,15 +147,18 @@ This argument has the following options:
 .INDENT 0.0
 .TP
 .B \fB\-a\fP, \fB\-\-admin\fP
-Indicates that a client will be created as an admin client. This is required when users of the open source Chef server need to access the Chef Server API as an administrator. This option only works when used with the open source Chef server and will have no effect when used with Enterprise Chef\&.
+Use to create a client as an admin client. This is required for any user to access Open Source Chef as an administrator. This option only works when used with the open source Chef server and will have no effect when used with Enterprise Chef\&.
 .TP
-.B \fB\-f FILE_NAME\fP, \fB\-\-file FILE_NAME\fP
+.B \fB\-f FILE\fP, \fB\-\-file FILE\fP
 Use to save a private key to the specified file name.
+.TP
+.B \fB\-\-validator\fP
+Use to create the client as the chef\-validator\&. Default value: \fBtrue\fP\&.
 .UNINDENT
 .sp
 \fBExamples\fP
 .sp
-To create a Chef Admin client with the name "exampleorg" and save its private key to a file, enter:
+To create a chef\-client that can access the Chef Server API as an administrator\-\-\-sometimes referred to as an "API chef\-client"\-\-\-with the name "exampleorg" and save its private key to a file, enter:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -274,7 +277,7 @@ This argument has the following options:
 .INDENT 0.0
 .TP
 .B \fB\-w\fP, \fB\-\-with\-uri\fP
-Indicates that the corresponding URIs will be shown.
+Use to show the corresponding URIs.
 .UNINDENT
 .sp
 \fBExamples\fP

data/distro/common/man/man1/knife-configure.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-CONFIGURE" "1" "Chef 11.12.0" "" "knife configure"
+.TH "KNIFE-CONFIGURE" "1" "Chef 11.14" "" "knife configure"
 .SH NAME
 knife-configure \- The man page for the knife configure subcommand.
 .
@@ -77,13 +77,13 @@ The configuration file to use.
 The port on which chef\-zero will listen.
 .TP
 .B \fB\-\-[no\-]color\fP
-Indicates whether colored output will be used.
+Use to view colored output.
 .TP
 .B \fB\-d\fP, \fB\-\-disable\-editing\fP
-Indicates that $EDITOR will not be opened; data will be accepted as\-is.
+Use to prevent the $EDITOR from being opened and to accept data as\-is.
 .TP
 .B \fB\-\-defaults\fP
-Indicates that Knife will use the default value, instead of asking a user to provide one.
+Use to have Knife use the default value instead of asking a user to provide one.
 .TP
 .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
 The $EDITOR that is used for all interactive commands.
@@ -104,7 +104,7 @@ Use to create a API client, typically an administrator client on a freshly\-inst
 The private key that Knife will use to sign requests made by the API client to the Chef server\&.
 .TP
 .B \fB\-\-print\-after\fP
-Indicates that data will be shown after a destructive operation.
+Use to show data after a destructive operation.
 .TP
 .B \fB\-r REPO\fP, \fB\-\-repository REPO\fP
 The path to the chef\-repo\&.
@@ -128,10 +128,10 @@ The name of the validation client.
 The path to the validation key used by the client, typically a file named \fBvalidation.pem\fP\&.
 .TP
 .B \fB\-y\fP, \fB\-\-yes\fP
-Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
+Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
 .TP
 .B \fB\-z\fP, \fB\-\-local\-mode\fP
-Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
+Use to run the chef\-client in local mode. This allows all commands that work against the Chef server to also work against the local chef\-repo\&.
 .UNINDENT
 .sp
 \fBExamples\fP

data/distro/common/man/man1/knife-cookbook-site.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-COOKBOOK-SITE" "1" "Chef 11.12.0" "" "knife cookbook site"
+.TH "KNIFE-COOKBOOK-SITE" "1" "Chef 11.14" "" "knife cookbook site"
 .SH NAME
 knife-cookbook-site \- The man page for the knife cookbook site subcommand.
 .
@@ -31,9 +31,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
 ..
 .sp
-The Cookbooks Site API is used to provide access to the cookbooks community hosted at \fI\%http://community.opscode.com/\fP\&. All of the cookbooks in the community are accessible through a REST API located at \fI\%https://cookbooks.opscode.com/api/v1/cookbooks\fP by using any of the supported endpoints. In most cases, using Knife and the \fBknife cookbook site\fP sub\-command (and any of its arguments) is the recommended method of interacting with these cookbooks, but in some cases, using the REST API directly may make sense.
+The Cookbooks Site API is used to provide access to the cookbooks community hosted at \fI\%http://community.opscode.com/cookbooks\fP\&. All of the cookbooks in the community are accessible through a RESTful API located at \fI\%https://cookbooks.opscode.com/api/v1/cookbooks\fP by using any of the supported endpoints. In most cases, using Knife and the \fBknife cookbook site\fP sub\-command (and any of its arguments) is the recommended method of interacting with these cookbooks, but in some cases, using the Cookbooks Site API directly may make sense.
 .sp
-The \fBknife cookbook site\fP subcommand is used to interact with cookbooks that are located at \fI\%http://community.opscode.com/\fP\&. A user account is required for any community actions that write data to this site. The following arguments do not require a user account: \fBdownload\fP, \fBsearch\fP, \fBinstall\fP, and \fBlist\fP\&.
+The \fBknife cookbook site\fP subcommand is used to interact with cookbooks that are located at \fI\%http://community.opscode.com/cookbooks\fP\&. A user account is required for any community actions that write data to this site. The following arguments do not require a user account: \fBdownload\fP, \fBsearch\fP, \fBinstall\fP, and \fBlist\fP\&.
 .SH COMMON OPTIONS
 .sp
 The following options may be used with any of the arguments available to the \fBknife cookbook site\fP subcommand:
@@ -46,10 +46,10 @@ The port on which chef\-zero will listen.
 The configuration file to use.
 .TP
 .B \fB\-d\fP, \fB\-\-disable\-editing\fP
-Indicates that $EDITOR will not be opened; data will be accepted as\-is.
+Use to prevent the $EDITOR from being opened and to accept data as\-is.
 .TP
 .B \fB\-\-defaults\fP
-Indicates that Knife will use the default value, instead of asking a user to provide one.
+Use to have Knife use the default value instead of asking a user to provide one.
 .TP
 .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
 The $EDITOR that is used for all interactive commands.
@@ -67,10 +67,10 @@ Shows help for the command.
 The private key that Knife will use to sign requests made by the API client to the Chef server\&.
 .TP
 .B \fB\-\-[no\-]color\fP
-Indicates whether colored output will be used.
+Use to view colored output.
 .TP
 .B \fB\-\-print\-after\fP
-Indicates that data will be shown after a destructive operation.
+Use to show data after a destructive operation.
 .TP
 .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
 The URL for the Chef server\&.
@@ -85,10 +85,10 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
 The version of the chef\-client\&.
 .TP
 .B \fB\-y\fP, \fB\-\-yes\fP
-Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
+Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
 .TP
 .B \fB\-z\fP, \fB\-\-local\-mode\fP
-Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
+Use to run the chef\-client in local mode. This allows all commands that work against the Chef server to also work against the local chef\-repo\&.
 .UNINDENT
 .SH DOWNLOAD
 .sp
@@ -114,13 +114,13 @@ This argument has the following options:
 .INDENT 0.0
 .TP
 .B \fBCOOKBOOK_VERSION\fP
-The version of a cookbook to be downloaded. If a cookbook has only one version, this option does not need to be specified. If a cookbook has more than one version and this option is not specified, Knife will prompt for a version.
+The version of a cookbook to be downloaded. If a cookbook has only one version, this option does not need to be specified. If a cookbook has more than one version and this option is not specified, the most recent version of the cookbook will be downloaded.
 .TP
 .B \fB\-f FILE\fP, \fB\-\-file FILE\fP
 The file to which a cookbook download is written.
 .TP
 .B \fB\-\-force\fP
-Indicates that an existing directory will be overwritten.
+Use to overwrite an existing directory.
 .UNINDENT
 .sp
 \fBExamples\fP
@@ -152,7 +152,7 @@ Cookbook saved: /Users/sdanna/opscodesupport/getting\-started\-0.3.0.tar.gz
 .UNINDENT
 .SH INSTALL
 .sp
-The \fBinstall\fP argument is used to install a cookbook that has been downloaded from the community site to a local git repository . This action uses the git version control system in conjunction with the \fI\%http://community.opscode.com/\fP site to install community\-contributed cookbooks to the local chef\-repo\&. Using this argument does the following:
+The \fBinstall\fP argument is used to install a cookbook that has been downloaded from the community site to a local git repository . This action uses the git version control system in conjunction with the \fI\%http://community.opscode.com/cookbooks\fP site to install community\-contributed cookbooks to the local chef\-repo\&. Using this argument does the following:
 .INDENT 0.0
 .INDENT 3.5
 .INDENT 0.0
@@ -161,7 +161,7 @@ A new "pristine copy" branch is created in git for tracking the upstream.
 .IP 2. 3
 All existing versions of a cookbook are removed from the branch.
 .IP 3. 3
-The cookbook is downloaded from \fI\%http://community.opscode.com/\fP in the tar.gz format.
+The cookbook is downloaded from \fI\%http://community.opscode.com/cookbooks\fP in the tar.gz format.
 .IP 4. 3
 The downloaded cookbook is untarred and its contents are committed to git and a tag is created.
 .IP 5. 3
@@ -192,7 +192,7 @@ This argument has the following options:
 .INDENT 0.0
 .TP
 .B \fB\-b\fP, \fB\-\-use\-current\-branch\fP
-Indicates that the current branch will be used.
+Use to ensure that the current branch is used.
 .TP
 .B \fB\-B BRANCH\fP, \fB\-\-branch BRANCH\fP
 The name of the default branch. This will default to the master branch.
@@ -201,7 +201,7 @@ The name of the default branch. This will default to the master branch.
 The version of the cookbook to be installed. If a version is not specified, the most recent version of the cookbook will be installed.
 .TP
 .B \fB\-D\fP, \fB\-\-skip\-dependencies\fP
-Indicates that all cookbooks to which the installed cookbook has a dependency will not be installed.
+Use to ensure that all cookbooks to which the installed cookbook has a dependency will not be installed.
 .TP
 .B \fB\-o PATH:PATH\fP, \fB\-\-cookbook\-path PATH:PATH\fP
 The directory in which cookbook are created. This can be a colon\-separated path.
@@ -261,7 +261,7 @@ Cookbook getting\-started version 0.3.0 successfully installed
 .UNINDENT
 .SH LIST
 .sp
-The \fBlist\fP argument is used to view a list of cookbooks that are currently available at \fI\%http://community.opscode.com/\fP\&.
+The \fBlist\fP argument is used to view a list of cookbooks that are currently available at \fI\%http://community.opscode.com/cookbooks\fP\&.
 .sp
 \fBSyntax\fP
 .sp
@@ -283,12 +283,12 @@ This argument has the following options:
 .INDENT 0.0
 .TP
 .B \fB\-w\fP, \fB\-\-with\-uri\fP
-Indicates that the corresponding URIs will be shown.
+Use to show the corresponding URIs.
 .UNINDENT
 .sp
 \fBExamples\fP
 .sp
-To view a list of cookbooks at \fI\%http://community.opscode.com/\fP server, enter:
+To view a list of cookbooks at \fI\%http://community.opscode.com/cookbooks\fP server, enter:
 .INDENT 0.0
 .INDENT 3.5
 .sp
@@ -323,7 +323,7 @@ ant                   iis                   redmine
 .UNINDENT
 .SH SEARCH
 .sp
-The \fBsearch\fP argument is used to search for a cookbook at \fI\%http://community.opscode.com/\fP\&. A search query is used to return a list of cookbooks at \fI\%http://community.opscode.com/\fP and uses the same syntax as the \fBknife search\fP sub\-command.
+The \fBsearch\fP argument is used to search for a cookbook at \fI\%http://community.opscode.com/cookbooks\fP\&. A search query is used to return a list of cookbooks at \fI\%http://community.opscode.com/cookbooks\fP and uses the same syntax as the \fBknife search\fP sub\-command.
 .sp
 \fBSyntax\fP
 .sp
@@ -385,7 +385,7 @@ kickstart:
 .UNINDENT
 .SH SHARE
 .sp
-The \fBshare\fP argument is used to add a cookbook to \fI\%http://community.opscode.com/\fP\&. This action will require a user account and a certificate for \fI\%http://community.opscode.com\fP\&. By default, Knife will use the user name and API key that is identified in the configuration file used during the upload; otherwise these values must be specified on the command line or in an alternate configuration file. If a cookbook already exists on \fI\%http://community.opscode.com/\fP, then only an owner or maintainer of that cookbook can make updates.
+The \fBshare\fP argument is used to add a cookbook to \fI\%http://community.opscode.com/cookbooks\fP\&. This action will require a user account and a certificate for \fI\%http://community.opscode.com\fP\&. By default, Knife will use the user name and API key that is identified in the configuration file used during the upload; otherwise these values must be specified on the command line or in an alternate configuration file. If a cookbook already exists on \fI\%http://community.opscode.com/cookbooks\fP, then only an owner or maintainer of that cookbook can make updates.
 .sp
 \fBSyntax\fP
 .sp
@@ -407,7 +407,7 @@ This argument has the following options:
 .INDENT 0.0
 .TP
 .B \fBCATEGORY\fP
-The cookbook category: \fBDatabases\fP, \fBWeb Servers\fP, \fBProcess Management\fP, \fBMonitoring and Trending\fP, \fBProgramming Languages\fP, \fBPackage Management\fP, \fBApplications\fP, \fBNetworking\fP, \fBOperations Systems and Virtualization\fP, \fBUtilities\fP, or \fBOther\fP\&.
+The cookbook category: \fB"Databases"\fP, \fB"Web Servers"\fP, \fB"Process Management"\fP, \fB"Monitoring & Trending"\fP, \fB"Programming Languages"\fP, \fB"Package Management"\fP, \fB"Applications"\fP, \fB"Networking"\fP, \fB"Operations Systems & Virtualization"\fP, \fB"Utilities"\fP, or \fB"Other"\fP\&.
 .TP
 .B \fB\-o PATH:PATH\fP, \fB\-\-cookbook\-path PATH:PATH\fP
 The directory in which cookbook are created. This can be a colon\-separated path.
@@ -428,7 +428,7 @@ $ knife cookbook site share "apache2" "Web Servers"
 .UNINDENT
 .SH SHOW
 .sp
-The \fBshow\fP argument is used to view information about a cookbook on \fI\%http://community.opscode.com/\fP\&.
+The \fBshow\fP argument is used to view information about a cookbook on \fI\%http://community.opscode.com/cookbooks\fP\&.
 .sp
 \fBSyntax\fP
 .sp
@@ -510,7 +510,7 @@ $ knife role show devops \-F json
 Other formats available include \fBtext\fP, \fByaml\fP, and \fBpp\fP\&.
 .SH UNSHARE
 .sp
-The \fBunshare\fP argument is used to stop the sharing of a cookbook at \fI\%http://community.opscode.com/\fP\&. Only the maintainer of a cookbook may perform this action.
+The \fBunshare\fP argument is used to stop the sharing of a cookbook at \fI\%http://community.opscode.com/cookbooks\fP\&. Only the maintainer of a cookbook may perform this action.
 .sp
 \fBSyntax\fP
 .sp

data/distro/common/man/man1/knife-cookbook.1

@@ -1,6 +1,6 @@
 .\" Man page generated from reStructuredText.
 .
-.TH "KNIFE-COOKBOOK" "1" "Chef 11.12.0" "" "knife cookbook"
+.TH "KNIFE-COOKBOOK" "1" "Chef 11.14" "" "knife cookbook"
 .SH NAME
 knife-cookbook \- The man page for the knife cookbook subcommand.
 .
@@ -66,10 +66,10 @@ The port on which chef\-zero will listen.
 The configuration file to use.
 .TP
 .B \fB\-d\fP, \fB\-\-disable\-editing\fP
-Indicates that $EDITOR will not be opened; data will be accepted as\-is.
+Use to prevent the $EDITOR from being opened and to accept data as\-is.
 .TP
 .B \fB\-\-defaults\fP
-Indicates that Knife will use the default value, instead of asking a user to provide one.
+Use to have Knife use the default value instead of asking a user to provide one.
 .TP
 .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
 The $EDITOR that is used for all interactive commands.
@@ -87,10 +87,10 @@ Shows help for the command.
 The private key that Knife will use to sign requests made by the API client to the Chef server\&.
 .TP
 .B \fB\-\-[no\-]color\fP
-Indicates whether colored output will be used.
+Use to view colored output.
 .TP
 .B \fB\-\-print\-after\fP
-Indicates that data will be shown after a destructive operation.
+Use to show data after a destructive operation.
 .TP
 .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
 The URL for the Chef server\&.
@@ -105,10 +105,10 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
 The version of the chef\-client\&.
 .TP
 .B \fB\-y\fP, \fB\-\-yes\fP
-Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
+Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
 .TP
 .B \fB\-z\fP, \fB\-\-local\-mode\fP
-Indicates that the chef\-client will be run in local mode, which allows all commands that work against the Chef server to also work against the local chef\-repo\&.
+Use to run the chef\-client in local mode. This allows all commands that work against the Chef server to also work against the local chef\-repo\&.
 .UNINDENT
 .SH BULK DELETE
 .sp
@@ -134,7 +134,7 @@ This argument has the following options:
 .INDENT 0.0
 .TP
 .B \fB\-p\fP, \fB\-\-purge\fP
-Indicates that a cookbook (or cookbook version) will be removed entirely from the Chef server\&. This action should be used carefully because only one copy of any single file is stored on the Chef server\&. Consequently, purging a cookbook will disable any other cookbook that references one or more files from a cookbook that has been purged.
+Use to entirely remove a cookbook (or cookbook version) from the Chef server\&. This action should be used carefully because only one copy of any single file is stored on the Chef server\&. Consequently, purging a cookbook will disable any other cookbook that references one or more files from a cookbook that has been purged.
 .UNINDENT
 .sp
 \fBExamples\fP
@@ -270,13 +270,13 @@ This argument has the following options:
 .INDENT 0.0
 .TP
 .B \fB\-a\fP, \fB\-\-all\fP
-Indicates that a cookbook and every version of that cookbook will be deleted.
+Use to delete all cookbooks (and cookbook versions).
 .TP
 .B \fBCOOKBOOK_VERSION\fP
 The version of a cookbook to be deleted. If a cookbook has only one version, this option does not need to be specified. If a cookbook has more than one version and this option is not specified, Knife will prompt for a version.
 .TP
 .B \fB\-p\fP, \fB\-\-purge\fP
-Indicates that a cookbook (or cookbook version) will be removed entirely from the Chef server\&. This action should be used carefully because only one copy of any single file is stored on the Chef server\&. Consequently, purging a cookbook will disable any other cookbook that references one or more files from a cookbook that has been purged.
+Use to entirely remove a cookbook (or cookbook version) from the Chef server\&. This action should be used carefully because only one copy of any single file is stored on the Chef server\&. Consequently, purging a cookbook will disable any other cookbook that references one or more files from a cookbook that has been purged.
 .UNINDENT
 .sp
 \fBExamples\fP
@@ -331,10 +331,10 @@ This argument has the following options:
 The directory into which a cookbook will be downloaded.
 .TP
 .B \fB\-f\fP, \fB\-\-force\fP
-Indicates that an existing directory will be overwritten.
+Use to overwrite an existing directory.
 .TP
 .B \fB\-N\fP, \fB\-\-latest\fP
-Indicates that the most recent version of a cookbook will be downloaded.
+Use to download the most recent version of a cookbook.
 .UNINDENT
 .sp
 \fBExamples\fP
@@ -374,10 +374,10 @@ This argument has the following options:
 .INDENT 0.0
 .TP
 .B \fB\-a\fP, \fB\-\-all\fP
-Indicates that all available versions of each cookbook will be returned.
+Use to return all available versions for every cookbook.
 .TP
 .B \fB\-w\fP, \fB\-\-with\-uri\fP
-Indicates that the corresponding URIs will be shown.
+Use to show the corresponding URIs.
 .UNINDENT
 .sp
 \fBExamples\fP
@@ -417,7 +417,7 @@ This argument has the following options:
 .INDENT 0.0
 .TP
 .B \fB\-a\fP, \fB\-\-all\fP
-Indicates that metadata should be generated for all cookbooks, and not just for a specified cookbook.
+Use to generate metadata for all cookbooks.
 .TP
 .B \fB\-o PATH:PATH\fP, \fB\-\-cookbook\-path PATH:PATH\fP
 The directory in which cookbook are created. This can be a colon\-separated path.
@@ -462,7 +462,7 @@ This command does not have any specific options.
 .sp
 .nf
 .ft C
-$ knife cookbook metadta from file /path/to/file
+$ knife cookbook metadata from file /path/to/file
 .ft P
 .fi
 .UNINDENT
@@ -509,7 +509,7 @@ The part of the cookbook to show: \fBattributes\fP, \fBdefinitions\fP, \fBfiles\
 The version of the platform.
 .TP
 .B \fB\-w\fP, \fB\-\-with\-uri\fP
-Indicates that the corresponding URIs will be shown.
+Use to show the corresponding URIs.
 .UNINDENT
 .sp
 \fBExamples\fP
@@ -617,7 +617,7 @@ $ knife role show devops \-F json
 Other formats available include \fBtext\fP, \fByaml\fP, and \fBpp\fP\&.
 .SH TEST
 .sp
-The \fBtest\fP argument is used to test a cookbook for syntax errors. This argument uses Ruby syntax checking to verify every file in a cookbook that ends in .rb and Embedded Ruby (ERB)\&.
+The \fBtest\fP argument is used to test a cookbook for syntax errors. This argument uses Ruby syntax checking to verify every file in a cookbook that ends in .rb and Embedded Ruby (ERB)\&. This argument will respect \&.chefignore files when determining which cookbooks to test for syntax errors.
 .sp
 \fBSyntax\fP
 .sp
@@ -639,7 +639,7 @@ This argument has the following options:
 .INDENT 0.0
 .TP
 .B \fB\-a\fP, \fB\-\-all\fP
-Indicates that all cookbooks will be tested.
+Use to test all cookbooks.
 .TP
 .B \fB\-o PATH:PATH\fP, \fB\-\-cookbook\-path PATH:PATH\fP
 The directory in which cookbook are created. This can be a colon\-separated path.
@@ -694,22 +694,22 @@ This argument has the following options:
 .INDENT 0.0
 .TP
 .B \fB\-a\fP, \fB\-\-all\fP
-Indicates that all cookbooks will be uploaded.
+Use to upload all cookbooks.
 .TP
 .B \fB\-\-concurrency\fP
 The number of allowed concurrent connections. Default: \fB10\fP\&.
 .TP
 .B \fB\-d\fP, \fB\-\-include\-dependencies\fP
-Indicates that when a cookbook has a dependency on one (or more) cookbooks, those cookbooks will also be uploaded.
+Use to ensure that when a cookbook has a dependency on one (or more) cookbooks, those cookbooks will also be uploaded.
 .TP
 .B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
 Use to set the environment version dependency to the cookbook version being uploaded.
 .TP
 .B \fB\-\-force\fP
-Indicates that a cookbook should be updated even if the \fB\-\-freeze\fP flag has been set.
+Use to update a cookbook even if the \fB\-\-freeze\fP flag has been set.
 .TP
 .B \fB\-\-freeze\fP
-Indicates that a cookbook cannot be modified; any changes to this cookbook must be included as a new version. Only the \fB\-\-force\fP option can override this setting.
+Use to require changes to a cookbook be included as a new version. Only the \fB\-\-force\fP option can override this setting.
 .TP
 .B \fB\-o PATH:PATH\fP, \fB\-\-cookbook\-path PATH:PATH\fP
 The directory in which cookbook are created. This can be a colon\-separated path.