chef 11.14.0.alpha.4-x86-mingw32 → 11.14.0.rc.2-x86-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (145) hide show
  1. data/CONTRIBUTING.md +0 -4
  2. data/README.md +1 -1
  3. data/distro/common/man/man1/chef-shell.1 +4 -4
  4. data/distro/common/man/man1/knife-bootstrap.1 +14 -11
  5. data/distro/common/man/man1/knife-client.1 +14 -11
  6. data/distro/common/man/man1/knife-configure.1 +7 -7
  7. data/distro/common/man/man1/knife-cookbook-site.1 +23 -23
  8. data/distro/common/man/man1/knife-cookbook.1 +23 -23
  9. data/distro/common/man/man1/knife-data-bag.1 +13 -13
  10. data/distro/common/man/man1/knife-delete.1 +9 -9
  11. data/distro/common/man/man1/knife-deps.1 +9 -9
  12. data/distro/common/man/man1/knife-diff.1 +10 -10
  13. data/distro/common/man/man1/knife-download.1 +9 -9
  14. data/distro/common/man/man1/knife-edit.1 +7 -7
  15. data/distro/common/man/man1/knife-environment.1 +10 -10
  16. data/distro/common/man/man1/knife-exec.1 +7 -7
  17. data/distro/common/man/man1/knife-index-rebuild.1 +1 -1
  18. data/distro/common/man/man1/knife-list.1 +12 -12
  19. data/distro/common/man/man1/knife-node.1 +12 -9
  20. data/distro/common/man/man1/knife-raw.1 +7 -7
  21. data/distro/common/man/man1/knife-recipe-list.1 +1 -1
  22. data/distro/common/man/man1/knife-role.1 +8 -8
  23. data/distro/common/man/man1/knife-search.1 +9 -9
  24. data/distro/common/man/man1/knife-serve.1 +109 -0
  25. data/distro/common/man/man1/knife-show.1 +8 -8
  26. data/distro/common/man/man1/knife-ssh.1 +9 -9
  27. data/distro/common/man/man1/knife-ssl-check.1 +9 -9
  28. data/distro/common/man/man1/knife-ssl-fetch.1 +10 -10
  29. data/distro/common/man/man1/knife-status.1 +9 -9
  30. data/distro/common/man/man1/knife-tag.1 +7 -7
  31. data/distro/common/man/man1/knife-upload.1 +10 -10
  32. data/distro/common/man/man1/knife-user.1 +9 -9
  33. data/distro/common/man/man1/knife-xargs.1 +7 -7
  34. data/distro/common/man/man1/knife.1 +118 -14
  35. data/distro/common/man/man8/chef-client.8 +13 -10
  36. data/distro/common/man/man8/chef-solo.8 +13 -14
  37. data/distro/common/markdown/man1/knife.mkd +1 -1
  38. data/lib/chef/application/knife.rb +1 -1
  39. data/lib/chef/application/windows_service.rb +0 -1
  40. data/lib/chef/chef_fs/file_system.rb +6 -2
  41. data/lib/chef/config.rb +3 -2
  42. data/lib/chef/config_fetcher.rb +1 -1
  43. data/lib/chef/cookbook/metadata.rb +20 -14
  44. data/lib/chef/cookbook/synchronizer.rb +24 -13
  45. data/lib/chef/encrypted_data_bag_item/decryptor.rb +3 -3
  46. data/lib/chef/encrypted_data_bag_item/encryptor.rb +2 -2
  47. data/lib/chef/exceptions.rb +1 -0
  48. data/lib/chef/file_content_management/deploy/mv_windows.rb +1 -1
  49. data/lib/chef/formatters/error_inspectors/resource_failure_inspector.rb +1 -1
  50. data/lib/chef/http.rb +6 -1
  51. data/lib/chef/http/http_request.rb +9 -1
  52. data/lib/chef/http/simple.rb +2 -1
  53. data/lib/chef/json_compat.rb +5 -16
  54. data/lib/chef/knife/bootstrap.rb +2 -0
  55. data/lib/chef/knife/bootstrap/archlinux-gems.erb +2 -2
  56. data/lib/chef/knife/core/object_loader.rb +3 -1
  57. data/lib/chef/knife/ssh.rb +14 -7
  58. data/lib/chef/mixin/convert_to_class_name.rb +1 -0
  59. data/lib/chef/mixin/windows_architecture_helper.rb +24 -4
  60. data/lib/chef/platform/provider_mapping.rb +13 -0
  61. data/lib/chef/provider/env/windows.rb +3 -6
  62. data/lib/chef/provider/git.rb +1 -2
  63. data/lib/chef/provider/log.rb +15 -1
  64. data/lib/chef/provider/package/apt.rb +3 -3
  65. data/lib/chef/provider/package/dpkg.rb +35 -16
  66. data/lib/chef/provider/package/paludis.rb +91 -0
  67. data/lib/chef/provider/package/rpm.rb +3 -2
  68. data/lib/chef/provider/package/yum-dump.py +6 -6
  69. data/lib/chef/provider/package/yum.rb +2 -0
  70. data/lib/chef/provider/registry_key.rb +4 -5
  71. data/lib/chef/provider/remote_file/cache_control_data.rb +1 -1
  72. data/lib/chef/provider/service/solaris.rb +1 -1
  73. data/lib/chef/provider/service/upstart.rb +2 -1
  74. data/lib/chef/provider/service/windows.rb +37 -9
  75. data/lib/chef/provider/user/pw.rb +1 -1
  76. data/lib/chef/provider/user/useradd.rb +1 -1
  77. data/lib/chef/provider/windows_script.rb +2 -1
  78. data/lib/chef/providers.rb +1 -0
  79. data/lib/chef/resource.rb +10 -0
  80. data/lib/chef/resource/file.rb +0 -9
  81. data/lib/chef/resource/package.rb +14 -4
  82. data/lib/chef/resource/paludis_package.rb +33 -0
  83. data/lib/chef/resource/registry_key.rb +62 -3
  84. data/lib/chef/resource/service.rb +21 -4
  85. data/lib/chef/resource_reporter.rb +10 -0
  86. data/lib/chef/resources.rb +1 -0
  87. data/lib/chef/role.rb +14 -10
  88. data/lib/chef/shell.rb +8 -0
  89. data/lib/chef/shell/shell_session.rb +3 -3
  90. data/lib/chef/user.rb +12 -11
  91. data/lib/chef/util/selinux.rb +1 -1
  92. data/lib/chef/version.rb +1 -1
  93. data/lib/chef/version_constraint.rb +6 -5
  94. data/lib/chef/win32/api/process.rb +1 -0
  95. data/lib/chef/win32/api/system.rb +14 -0
  96. data/lib/chef/win32/error.rb +1 -1
  97. data/lib/chef/win32/security.rb +5 -5
  98. data/lib/chef/win32/version.rb +6 -2
  99. data/spec/data/trusted_certs/opscode.pem +57 -35
  100. data/spec/functional/application_spec.rb +2 -2
  101. data/spec/functional/resource/mount_spec.rb +3 -1
  102. data/spec/functional/shell_spec.rb +10 -0
  103. data/spec/functional/tiny_server_spec.rb +2 -2
  104. data/spec/support/chef_helpers.rb +1 -1
  105. data/spec/support/shared/functional/securable_resource.rb +11 -2
  106. data/spec/support/shared/functional/securable_resource_with_reporting.rb +13 -2
  107. data/spec/tiny_server.rb +1 -1
  108. data/spec/unit/config_spec.rb +5 -0
  109. data/spec/unit/cookbook/metadata_spec.rb +24 -0
  110. data/spec/unit/environment_spec.rb +6 -0
  111. data/spec/unit/http/http_request_spec.rb +91 -0
  112. data/spec/unit/http_spec.rb +23 -0
  113. data/spec/unit/knife/bootstrap_spec.rb +2 -2
  114. data/spec/unit/knife/ssh_spec.rb +7 -13
  115. data/spec/unit/knife_spec.rb +1 -1
  116. data/spec/unit/mixin/convert_to_class_name_spec.rb +4 -0
  117. data/spec/unit/provider/git_spec.rb +2 -2
  118. data/spec/unit/provider/log_spec.rb +18 -0
  119. data/spec/unit/provider/mount/solaris_spec.rb +3 -1
  120. data/spec/unit/provider/package/apt_spec.rb +85 -40
  121. data/spec/unit/provider/package/dpkg_spec.rb +24 -48
  122. data/spec/unit/provider/package/paludis_spec.rb +135 -0
  123. data/spec/unit/provider/package/rpm_spec.rb +40 -32
  124. data/spec/unit/provider/package/yum_spec.rb +11 -4
  125. data/spec/unit/provider/registry_key_spec.rb +67 -53
  126. data/spec/unit/provider/remote_file/cache_control_data_spec.rb +10 -1
  127. data/spec/unit/provider/service/solaris_smf_service_spec.rb +23 -2
  128. data/spec/unit/provider/service/upstart_service_spec.rb +7 -0
  129. data/spec/unit/provider/service/windows_spec.rb +72 -0
  130. data/spec/unit/provider/user/pw_spec.rb +21 -4
  131. data/spec/unit/provider/user/useradd_spec.rb +10 -0
  132. data/spec/unit/resource/package_spec.rb +26 -18
  133. data/spec/unit/resource/registry_key_spec.rb +28 -0
  134. data/spec/unit/resource/service_spec.rb +14 -0
  135. data/spec/unit/resource_reporter_spec.rb +37 -12
  136. data/spec/unit/resource_spec.rb +41 -6
  137. data/spec/unit/rest_spec.rb +2 -2
  138. data/spec/unit/role_spec.rb +46 -28
  139. data/spec/unit/shell/shell_session_spec.rb +42 -2
  140. data/spec/unit/shell_spec.rb +1 -1
  141. data/spec/unit/user_spec.rb +12 -0
  142. data/spec/unit/util/selinux_spec.rb +4 -4
  143. data/spec/unit/version_constraint_spec.rb +14 -2
  144. metadata +223 -167
  145. checksums.yaml +0 -7
@@ -177,8 +177,6 @@ We do a `Minor` release approximately every 3 months and `Patch` releases on a w
177
177
  Announcements of releases are available on [Chef Blog](http://www.getchef.com/blog) when they are
178
178
  available.
179
179
 
180
- **TODO**: Can I sign up for a mailing list to get notification of releases?
181
-
182
180
  ## Chef Community
183
181
 
184
182
  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
189
187
 
190
188
  Also here are some additional pointers to some awesome Chef content:
191
189
 
192
- **TODO**: Any blogs of community folks that we would like to put in here?
193
-
194
190
  * [Chef Docs](http://docs.opscode.com/)
195
191
  * [Learn Chef](https://learnchef.opscode.com/)
196
192
  * [Chef Inc](http://www.getchef.com/)
data/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # Chef
1
+ # Chef [![Code Climate](https://codeclimate.com/github/opscode/chef.png)](https://codeclimate.com/github/opscode/chef)
2
2
 
3
3
  Want to try Chef? Get started with [learnchef](https://learnchef.opscode.com)
4
4
 
@@ -1,6 +1,6 @@
1
1
  .\" Man page generated from reStructuredText.
2
2
  .
3
- .TH "CHEF-SHELL" "1" "Chef 11.12.0" "" "chef-shell"
3
+ .TH "CHEF-SHELL" "1" "Chef 11.14" "" "chef-shell"
4
4
  .SH NAME
5
5
  chef-shell \- The man page for the chef-shell command line tool.
6
6
  .
@@ -91,7 +91,7 @@ This command has the following options:
91
91
  .INDENT 0.0
92
92
  .TP
93
93
  .B \fB\-a\fP, \fB\-\-standalone\fP
94
- Indicates that chef\-shell will be run in standalone mode.
94
+ Use to run chef\-shell in standalone mode.
95
95
  .TP
96
96
  .B \fB\-c CONFIG\fP, \fB\-\-config CONFIG\fP
97
97
  The configuration file to use.
@@ -106,7 +106,7 @@ The path to a file that contains JSON data.
106
106
  The level of logging that will be stored in a log file.
107
107
  .TP
108
108
  .B \fB\-s\fP, \fB\-\-solo\fP
109
- Indicates that chef\-shell will be run in chef\-solo mode.
109
+ Use to run chef\-shell in chef\-solo mode.
110
110
  .TP
111
111
  .B \fB\-S CHEF_SERVER_URL\fP, \fB\-\-server CHEF_SERVER_URL\fP
112
112
  The URL for the Chef server\&.
@@ -115,7 +115,7 @@ The URL for the Chef server\&.
115
115
  The version of the chef\-client\&.
116
116
  .TP
117
117
  .B \fB\-z\fP, \fB\-\-client\fP
118
- Indicates that chef\-shell will be run in chef\-client mode.
118
+ Use to run chef\-shell in chef\-client mode.
119
119
  .UNINDENT
120
120
  .SH AUTHOR
121
121
  Chef
@@ -1,6 +1,6 @@
1
1
  .\" Man page generated from reStructuredText.
2
2
  .
3
- .TH "KNIFE-BOOTSTRAP" "1" "Chef 11.12.0" "" "knife bootstrap"
3
+ .TH "KNIFE-BOOTSTRAP" "1" "Chef 11.14" "" "knife bootstrap"
4
4
  .SH NAME
5
5
  knife-bootstrap \- The man page for the knife bootstrap subcommand.
6
6
  .
@@ -55,7 +55,7 @@ This subcommand has the following options:
55
55
  .INDENT 0.0
56
56
  .TP
57
57
  .B \fB\-A\fP, \fB\-\-forward\-agent\fP
58
- Indicates that SSH agent forwarding is enabled.
58
+ Use to enable SSH agent forwarding.
59
59
  .TP
60
60
  .B \fB\-\-bootstrap\-no\-proxy NO_PROXY_URL_or_IP\fP
61
61
  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.
73
73
  The port on which chef\-zero will listen.
74
74
  .TP
75
75
  .B \fB\-\-[no\-]color\fP
76
- Indicates whether colored output will be used.
76
+ Use to view colored output.
77
77
  .TP
78
78
  .B \fB\-d DISTRO\fP, \fB\-\-distro DISTRO\fP
79
79
  .sp
@@ -87,10 +87,10 @@ The default bootstrap operation uses the omnibus installer, which means the defa
87
87
  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.
88
88
  .TP
89
89
  .B \fB\-\-defaults\fP
90
- Indicates that Knife will use the default value, instead of asking a user to provide one.
90
+ Use to have Knife use the default value instead of asking a user to provide one.
91
91
  .TP
92
92
  .B \fB\-\-disable\-editing\fP
93
- Indicates that $EDITOR will not be opened; data will be accepted as\-is.
93
+ Use to prevent the $EDITOR from being opened and to accept data as\-is.
94
94
  .TP
95
95
  .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
96
96
  The $EDITOR that is used for all interactive commands.
@@ -132,10 +132,10 @@ The SSH port.
132
132
  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.
133
133
  .TP
134
134
  .B \fB\-\-prerelease\fP
135
- Indicates that pre\-release gems should be installed.
135
+ Use to install pre\-release gems.
136
136
  .TP
137
137
  .B \fB\-\-print\-after\fP
138
- Indicates that data will be shown after a destructive operation.
138
+ Use to show data after a destructive operation.
139
139
  .TP
140
140
  .B \fB\-r RUN_LIST\fP, \fB\-\-run\-list RUN_LIST\fP
141
141
  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.
150
150
  The path to the file that contains the encryption key.
151
151
  .TP
152
152
  .B \fB\-\-sudo\fP
153
- Indicates that a bootstrap operation should be executed using sudo\&.
153
+ Use to execute a bootstrap operation with sudo\&.
154
154
  .TP
155
155
  .B \fB\-\-template\-file TEMPLATE\fP
156
156
  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
159
159
  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.
160
160
  .TP
161
161
  .B \fB\-\-use\-sudo\-password\fP
162
- Indicates that a bootstrap operation is done using sudo, with the password specified by the \fB\-P\fP (or \fB\-\-ssh\-password\fP) option.
162
+ Use to perform a bootstrap operation with sudo; specify the password with the \fB\-P\fP (or \fB\-\-ssh\-password\fP) option.
163
163
  .TP
164
164
  .B \fB\-v\fP, \fB\-\-version\fP
165
165
  The version of the chef\-client\&.
@@ -167,14 +167,17 @@ The version of the chef\-client\&.
167
167
  .B \fB\-V\fP, \fB\-\-verbose\fP
168
168
  Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
169
169
  .TP
170
+ .B \fB\-V \-V\fP
171
+ Use to run the initial chef\-client run at the \fBdebug\fP log\-level (e.g. \fBchef\-client \-l debug\fP).
172
+ .TP
170
173
  .B \fB\-x USERNAME\fP, \fB\-\-ssh\-user USERNAME\fP
171
174
  The SSH user name.
172
175
  .TP
173
176
  .B \fB\-y\fP, \fB\-\-yes\fP
174
- Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
177
+ Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
175
178
  .TP
176
179
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
177
- 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\&.
180
+ 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\&.
178
181
  .UNINDENT
179
182
  .sp
180
183
  \fBExamples\fP
@@ -1,6 +1,6 @@
1
1
  .\" Man page generated from reStructuredText.
2
2
  .
3
- .TH "KNIFE-CLIENT" "1" "Chef 11.12.0" "" "knife client"
3
+ .TH "KNIFE-CLIENT" "1" "Chef 11.14" "" "knife client"
4
4
  .SH NAME
5
5
  knife-client \- The man page for the knife client subcommand.
6
6
  .
@@ -52,10 +52,10 @@ The port on which chef\-zero will listen.
52
52
  The configuration file to use.
53
53
  .TP
54
54
  .B \fB\-d\fP, \fB\-\-disable\-editing\fP
55
- Indicates that $EDITOR will not be opened; data will be accepted as\-is.
55
+ Use to prevent the $EDITOR from being opened and to accept data as\-is.
56
56
  .TP
57
57
  .B \fB\-\-defaults\fP
58
- Indicates that Knife will use the default value, instead of asking a user to provide one.
58
+ Use to have Knife use the default value instead of asking a user to provide one.
59
59
  .TP
60
60
  .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
61
61
  The $EDITOR that is used for all interactive commands.
@@ -73,10 +73,10 @@ Shows help for the command.
73
73
  The private key that Knife will use to sign requests made by the API client to the Chef server\&.
74
74
  .TP
75
75
  .B \fB\-\-[no\-]color\fP
76
- Indicates whether colored output will be used.
76
+ Use to view colored output.
77
77
  .TP
78
78
  .B \fB\-\-print\-after\fP
79
- Indicates that data will be shown after a destructive operation.
79
+ Use to show data after a destructive operation.
80
80
  .TP
81
81
  .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
82
82
  The URL for the Chef server\&.
@@ -91,10 +91,10 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
91
91
  The version of the chef\-client\&.
92
92
  .TP
93
93
  .B \fB\-y\fP, \fB\-\-yes\fP
94
- Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
94
+ Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
95
95
  .TP
96
96
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
97
- 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\&.
97
+ 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\&.
98
98
  .UNINDENT
99
99
  .SH BULK DELETE
100
100
  .sp
@@ -147,15 +147,18 @@ This argument has the following options:
147
147
  .INDENT 0.0
148
148
  .TP
149
149
  .B \fB\-a\fP, \fB\-\-admin\fP
150
- 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\&.
150
+ 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\&.
151
151
  .TP
152
- .B \fB\-f FILE_NAME\fP, \fB\-\-file FILE_NAME\fP
152
+ .B \fB\-f FILE\fP, \fB\-\-file FILE\fP
153
153
  Use to save a private key to the specified file name.
154
+ .TP
155
+ .B \fB\-\-validator\fP
156
+ Use to create the client as the chef\-validator\&. Default value: \fBtrue\fP\&.
154
157
  .UNINDENT
155
158
  .sp
156
159
  \fBExamples\fP
157
160
  .sp
158
- To create a Chef Admin client with the name "exampleorg" and save its private key to a file, enter:
161
+ 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:
159
162
  .INDENT 0.0
160
163
  .INDENT 3.5
161
164
  .sp
@@ -274,7 +277,7 @@ This argument has the following options:
274
277
  .INDENT 0.0
275
278
  .TP
276
279
  .B \fB\-w\fP, \fB\-\-with\-uri\fP
277
- Indicates that the corresponding URIs will be shown.
280
+ Use to show the corresponding URIs.
278
281
  .UNINDENT
279
282
  .sp
280
283
  \fBExamples\fP
@@ -1,6 +1,6 @@
1
1
  .\" Man page generated from reStructuredText.
2
2
  .
3
- .TH "KNIFE-CONFIGURE" "1" "Chef 11.12.0" "" "knife configure"
3
+ .TH "KNIFE-CONFIGURE" "1" "Chef 11.14" "" "knife configure"
4
4
  .SH NAME
5
5
  knife-configure \- The man page for the knife configure subcommand.
6
6
  .
@@ -77,13 +77,13 @@ The configuration file to use.
77
77
  The port on which chef\-zero will listen.
78
78
  .TP
79
79
  .B \fB\-\-[no\-]color\fP
80
- Indicates whether colored output will be used.
80
+ Use to view colored output.
81
81
  .TP
82
82
  .B \fB\-d\fP, \fB\-\-disable\-editing\fP
83
- Indicates that $EDITOR will not be opened; data will be accepted as\-is.
83
+ Use to prevent the $EDITOR from being opened and to accept data as\-is.
84
84
  .TP
85
85
  .B \fB\-\-defaults\fP
86
- Indicates that Knife will use the default value, instead of asking a user to provide one.
86
+ Use to have Knife use the default value instead of asking a user to provide one.
87
87
  .TP
88
88
  .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
89
89
  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
104
104
  The private key that Knife will use to sign requests made by the API client to the Chef server\&.
105
105
  .TP
106
106
  .B \fB\-\-print\-after\fP
107
- Indicates that data will be shown after a destructive operation.
107
+ Use to show data after a destructive operation.
108
108
  .TP
109
109
  .B \fB\-r REPO\fP, \fB\-\-repository REPO\fP
110
110
  The path to the chef\-repo\&.
@@ -128,10 +128,10 @@ The name of the validation client.
128
128
  The path to the validation key used by the client, typically a file named \fBvalidation.pem\fP\&.
129
129
  .TP
130
130
  .B \fB\-y\fP, \fB\-\-yes\fP
131
- Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
131
+ Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
132
132
  .TP
133
133
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
134
- 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\&.
134
+ 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\&.
135
135
  .UNINDENT
136
136
  .sp
137
137
  \fBExamples\fP
@@ -1,6 +1,6 @@
1
1
  .\" Man page generated from reStructuredText.
2
2
  .
3
- .TH "KNIFE-COOKBOOK-SITE" "1" "Chef 11.12.0" "" "knife cookbook site"
3
+ .TH "KNIFE-COOKBOOK-SITE" "1" "Chef 11.14" "" "knife cookbook site"
4
4
  .SH NAME
5
5
  knife-cookbook-site \- The man page for the knife cookbook site subcommand.
6
6
  .
@@ -31,9 +31,9 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
31
31
  .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
32
32
  ..
33
33
  .sp
34
- 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.
34
+ 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.
35
35
  .sp
36
- 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\&.
36
+ 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\&.
37
37
  .SH COMMON OPTIONS
38
38
  .sp
39
39
  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.
46
46
  The configuration file to use.
47
47
  .TP
48
48
  .B \fB\-d\fP, \fB\-\-disable\-editing\fP
49
- Indicates that $EDITOR will not be opened; data will be accepted as\-is.
49
+ Use to prevent the $EDITOR from being opened and to accept data as\-is.
50
50
  .TP
51
51
  .B \fB\-\-defaults\fP
52
- Indicates that Knife will use the default value, instead of asking a user to provide one.
52
+ Use to have Knife use the default value instead of asking a user to provide one.
53
53
  .TP
54
54
  .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
55
55
  The $EDITOR that is used for all interactive commands.
@@ -67,10 +67,10 @@ Shows help for the command.
67
67
  The private key that Knife will use to sign requests made by the API client to the Chef server\&.
68
68
  .TP
69
69
  .B \fB\-\-[no\-]color\fP
70
- Indicates whether colored output will be used.
70
+ Use to view colored output.
71
71
  .TP
72
72
  .B \fB\-\-print\-after\fP
73
- Indicates that data will be shown after a destructive operation.
73
+ Use to show data after a destructive operation.
74
74
  .TP
75
75
  .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
76
76
  The URL for the Chef server\&.
@@ -85,10 +85,10 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
85
85
  The version of the chef\-client\&.
86
86
  .TP
87
87
  .B \fB\-y\fP, \fB\-\-yes\fP
88
- Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
88
+ Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
89
89
  .TP
90
90
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
91
- 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\&.
91
+ 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\&.
92
92
  .UNINDENT
93
93
  .SH DOWNLOAD
94
94
  .sp
@@ -114,13 +114,13 @@ This argument has the following options:
114
114
  .INDENT 0.0
115
115
  .TP
116
116
  .B \fBCOOKBOOK_VERSION\fP
117
- 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.
117
+ 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.
118
118
  .TP
119
119
  .B \fB\-f FILE\fP, \fB\-\-file FILE\fP
120
120
  The file to which a cookbook download is written.
121
121
  .TP
122
122
  .B \fB\-\-force\fP
123
- Indicates that an existing directory will be overwritten.
123
+ Use to overwrite an existing directory.
124
124
  .UNINDENT
125
125
  .sp
126
126
  \fBExamples\fP
@@ -152,7 +152,7 @@ Cookbook saved: /Users/sdanna/opscodesupport/getting\-started\-0.3.0.tar.gz
152
152
  .UNINDENT
153
153
  .SH INSTALL
154
154
  .sp
155
- 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:
155
+ 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:
156
156
  .INDENT 0.0
157
157
  .INDENT 3.5
158
158
  .INDENT 0.0
@@ -161,7 +161,7 @@ A new "pristine copy" branch is created in git for tracking the upstream.
161
161
  .IP 2. 3
162
162
  All existing versions of a cookbook are removed from the branch.
163
163
  .IP 3. 3
164
- The cookbook is downloaded from \fI\%http://community.opscode.com/\fP in the tar.gz format.
164
+ The cookbook is downloaded from \fI\%http://community.opscode.com/cookbooks\fP in the tar.gz format.
165
165
  .IP 4. 3
166
166
  The downloaded cookbook is untarred and its contents are committed to git and a tag is created.
167
167
  .IP 5. 3
@@ -192,7 +192,7 @@ This argument has the following options:
192
192
  .INDENT 0.0
193
193
  .TP
194
194
  .B \fB\-b\fP, \fB\-\-use\-current\-branch\fP
195
- Indicates that the current branch will be used.
195
+ Use to ensure that the current branch is used.
196
196
  .TP
197
197
  .B \fB\-B BRANCH\fP, \fB\-\-branch BRANCH\fP
198
198
  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.
201
201
  The version of the cookbook to be installed. If a version is not specified, the most recent version of the cookbook will be installed.
202
202
  .TP
203
203
  .B \fB\-D\fP, \fB\-\-skip\-dependencies\fP
204
- Indicates that all cookbooks to which the installed cookbook has a dependency will not be installed.
204
+ Use to ensure that all cookbooks to which the installed cookbook has a dependency will not be installed.
205
205
  .TP
206
206
  .B \fB\-o PATH:PATH\fP, \fB\-\-cookbook\-path PATH:PATH\fP
207
207
  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
261
261
  .UNINDENT
262
262
  .SH LIST
263
263
  .sp
264
- The \fBlist\fP argument is used to view a list of cookbooks that are currently available at \fI\%http://community.opscode.com/\fP\&.
264
+ The \fBlist\fP argument is used to view a list of cookbooks that are currently available at \fI\%http://community.opscode.com/cookbooks\fP\&.
265
265
  .sp
266
266
  \fBSyntax\fP
267
267
  .sp
@@ -283,12 +283,12 @@ This argument has the following options:
283
283
  .INDENT 0.0
284
284
  .TP
285
285
  .B \fB\-w\fP, \fB\-\-with\-uri\fP
286
- Indicates that the corresponding URIs will be shown.
286
+ Use to show the corresponding URIs.
287
287
  .UNINDENT
288
288
  .sp
289
289
  \fBExamples\fP
290
290
  .sp
291
- To view a list of cookbooks at \fI\%http://community.opscode.com/\fP server, enter:
291
+ To view a list of cookbooks at \fI\%http://community.opscode.com/cookbooks\fP server, enter:
292
292
  .INDENT 0.0
293
293
  .INDENT 3.5
294
294
  .sp
@@ -323,7 +323,7 @@ ant iis redmine
323
323
  .UNINDENT
324
324
  .SH SEARCH
325
325
  .sp
326
- 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.
326
+ 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.
327
327
  .sp
328
328
  \fBSyntax\fP
329
329
  .sp
@@ -385,7 +385,7 @@ kickstart:
385
385
  .UNINDENT
386
386
  .SH SHARE
387
387
  .sp
388
- 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.
388
+ 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.
389
389
  .sp
390
390
  \fBSyntax\fP
391
391
  .sp
@@ -407,7 +407,7 @@ This argument has the following options:
407
407
  .INDENT 0.0
408
408
  .TP
409
409
  .B \fBCATEGORY\fP
410
- 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\&.
410
+ 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\&.
411
411
  .TP
412
412
  .B \fB\-o PATH:PATH\fP, \fB\-\-cookbook\-path PATH:PATH\fP
413
413
  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"
428
428
  .UNINDENT
429
429
  .SH SHOW
430
430
  .sp
431
- The \fBshow\fP argument is used to view information about a cookbook on \fI\%http://community.opscode.com/\fP\&.
431
+ The \fBshow\fP argument is used to view information about a cookbook on \fI\%http://community.opscode.com/cookbooks\fP\&.
432
432
  .sp
433
433
  \fBSyntax\fP
434
434
  .sp
@@ -510,7 +510,7 @@ $ knife role show devops \-F json
510
510
  Other formats available include \fBtext\fP, \fByaml\fP, and \fBpp\fP\&.
511
511
  .SH UNSHARE
512
512
  .sp
513
- 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.
513
+ 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.
514
514
  .sp
515
515
  \fBSyntax\fP
516
516
  .sp
@@ -1,6 +1,6 @@
1
1
  .\" Man page generated from reStructuredText.
2
2
  .
3
- .TH "KNIFE-COOKBOOK" "1" "Chef 11.12.0" "" "knife cookbook"
3
+ .TH "KNIFE-COOKBOOK" "1" "Chef 11.14" "" "knife cookbook"
4
4
  .SH NAME
5
5
  knife-cookbook \- The man page for the knife cookbook subcommand.
6
6
  .
@@ -66,10 +66,10 @@ The port on which chef\-zero will listen.
66
66
  The configuration file to use.
67
67
  .TP
68
68
  .B \fB\-d\fP, \fB\-\-disable\-editing\fP
69
- Indicates that $EDITOR will not be opened; data will be accepted as\-is.
69
+ Use to prevent the $EDITOR from being opened and to accept data as\-is.
70
70
  .TP
71
71
  .B \fB\-\-defaults\fP
72
- Indicates that Knife will use the default value, instead of asking a user to provide one.
72
+ Use to have Knife use the default value instead of asking a user to provide one.
73
73
  .TP
74
74
  .B \fB\-e EDITOR\fP, \fB\-\-editor EDITOR\fP
75
75
  The $EDITOR that is used for all interactive commands.
@@ -87,10 +87,10 @@ Shows help for the command.
87
87
  The private key that Knife will use to sign requests made by the API client to the Chef server\&.
88
88
  .TP
89
89
  .B \fB\-\-[no\-]color\fP
90
- Indicates whether colored output will be used.
90
+ Use to view colored output.
91
91
  .TP
92
92
  .B \fB\-\-print\-after\fP
93
- Indicates that data will be shown after a destructive operation.
93
+ Use to show data after a destructive operation.
94
94
  .TP
95
95
  .B \fB\-s URL\fP, \fB\-\-server\-url URL\fP
96
96
  The URL for the Chef server\&.
@@ -105,10 +105,10 @@ Set for more verbose outputs. Use \fB\-VV\fP for maximum verbosity.
105
105
  The version of the chef\-client\&.
106
106
  .TP
107
107
  .B \fB\-y\fP, \fB\-\-yes\fP
108
- Indicates that the response to all confirmation prompts will be "Yes" (and that Knife will not ask for confirmation).
108
+ Use to respond to all confirmation prompts with "Yes". Knife will not ask for confirmation.
109
109
  .TP
110
110
  .B \fB\-z\fP, \fB\-\-local\-mode\fP
111
- 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\&.
111
+ 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\&.
112
112
  .UNINDENT
113
113
  .SH BULK DELETE
114
114
  .sp
@@ -134,7 +134,7 @@ This argument has the following options:
134
134
  .INDENT 0.0
135
135
  .TP
136
136
  .B \fB\-p\fP, \fB\-\-purge\fP
137
- 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.
137
+ 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.
138
138
  .UNINDENT
139
139
  .sp
140
140
  \fBExamples\fP
@@ -270,13 +270,13 @@ This argument has the following options:
270
270
  .INDENT 0.0
271
271
  .TP
272
272
  .B \fB\-a\fP, \fB\-\-all\fP
273
- Indicates that a cookbook and every version of that cookbook will be deleted.
273
+ Use to delete all cookbooks (and cookbook versions).
274
274
  .TP
275
275
  .B \fBCOOKBOOK_VERSION\fP
276
276
  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.
277
277
  .TP
278
278
  .B \fB\-p\fP, \fB\-\-purge\fP
279
- 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.
279
+ 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.
280
280
  .UNINDENT
281
281
  .sp
282
282
  \fBExamples\fP
@@ -331,10 +331,10 @@ This argument has the following options:
331
331
  The directory into which a cookbook will be downloaded.
332
332
  .TP
333
333
  .B \fB\-f\fP, \fB\-\-force\fP
334
- Indicates that an existing directory will be overwritten.
334
+ Use to overwrite an existing directory.
335
335
  .TP
336
336
  .B \fB\-N\fP, \fB\-\-latest\fP
337
- Indicates that the most recent version of a cookbook will be downloaded.
337
+ Use to download the most recent version of a cookbook.
338
338
  .UNINDENT
339
339
  .sp
340
340
  \fBExamples\fP
@@ -374,10 +374,10 @@ This argument has the following options:
374
374
  .INDENT 0.0
375
375
  .TP
376
376
  .B \fB\-a\fP, \fB\-\-all\fP
377
- Indicates that all available versions of each cookbook will be returned.
377
+ Use to return all available versions for every cookbook.
378
378
  .TP
379
379
  .B \fB\-w\fP, \fB\-\-with\-uri\fP
380
- Indicates that the corresponding URIs will be shown.
380
+ Use to show the corresponding URIs.
381
381
  .UNINDENT
382
382
  .sp
383
383
  \fBExamples\fP
@@ -417,7 +417,7 @@ This argument has the following options:
417
417
  .INDENT 0.0
418
418
  .TP
419
419
  .B \fB\-a\fP, \fB\-\-all\fP
420
- Indicates that metadata should be generated for all cookbooks, and not just for a specified cookbook.
420
+ Use to generate metadata for all cookbooks.
421
421
  .TP
422
422
  .B \fB\-o PATH:PATH\fP, \fB\-\-cookbook\-path PATH:PATH\fP
423
423
  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.
462
462
  .sp
463
463
  .nf
464
464
  .ft C
465
- $ knife cookbook metadta from file /path/to/file
465
+ $ knife cookbook metadata from file /path/to/file
466
466
  .ft P
467
467
  .fi
468
468
  .UNINDENT
@@ -509,7 +509,7 @@ The part of the cookbook to show: \fBattributes\fP, \fBdefinitions\fP, \fBfiles\
509
509
  The version of the platform.
510
510
  .TP
511
511
  .B \fB\-w\fP, \fB\-\-with\-uri\fP
512
- Indicates that the corresponding URIs will be shown.
512
+ Use to show the corresponding URIs.
513
513
  .UNINDENT
514
514
  .sp
515
515
  \fBExamples\fP
@@ -617,7 +617,7 @@ $ knife role show devops \-F json
617
617
  Other formats available include \fBtext\fP, \fByaml\fP, and \fBpp\fP\&.
618
618
  .SH TEST
619
619
  .sp
620
- 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)\&.
620
+ 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.
621
621
  .sp
622
622
  \fBSyntax\fP
623
623
  .sp
@@ -639,7 +639,7 @@ This argument has the following options:
639
639
  .INDENT 0.0
640
640
  .TP
641
641
  .B \fB\-a\fP, \fB\-\-all\fP
642
- Indicates that all cookbooks will be tested.
642
+ Use to test all cookbooks.
643
643
  .TP
644
644
  .B \fB\-o PATH:PATH\fP, \fB\-\-cookbook\-path PATH:PATH\fP
645
645
  The directory in which cookbook are created. This can be a colon\-separated path.
@@ -694,22 +694,22 @@ This argument has the following options:
694
694
  .INDENT 0.0
695
695
  .TP
696
696
  .B \fB\-a\fP, \fB\-\-all\fP
697
- Indicates that all cookbooks will be uploaded.
697
+ Use to upload all cookbooks.
698
698
  .TP
699
699
  .B \fB\-\-concurrency\fP
700
700
  The number of allowed concurrent connections. Default: \fB10\fP\&.
701
701
  .TP
702
702
  .B \fB\-d\fP, \fB\-\-include\-dependencies\fP
703
- Indicates that when a cookbook has a dependency on one (or more) cookbooks, those cookbooks will also be uploaded.
703
+ Use to ensure that when a cookbook has a dependency on one (or more) cookbooks, those cookbooks will also be uploaded.
704
704
  .TP
705
705
  .B \fB\-E ENVIRONMENT\fP, \fB\-\-environment ENVIRONMENT\fP
706
706
  Use to set the environment version dependency to the cookbook version being uploaded.
707
707
  .TP
708
708
  .B \fB\-\-force\fP
709
- Indicates that a cookbook should be updated even if the \fB\-\-freeze\fP flag has been set.
709
+ Use to update a cookbook even if the \fB\-\-freeze\fP flag has been set.
710
710
  .TP
711
711
  .B \fB\-\-freeze\fP
712
- 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.
712
+ Use to require changes to a cookbook be included as a new version. Only the \fB\-\-force\fP option can override this setting.
713
713
  .TP
714
714
  .B \fB\-o PATH:PATH\fP, \fB\-\-cookbook\-path PATH:PATH\fP
715
715
  The directory in which cookbook are created. This can be a colon\-separated path.