summaryrefslogtreecommitdiff
path: root/distro/common/man/man1/knife-data-bag.1
diff options
context:
space:
mode:
Diffstat (limited to 'distro/common/man/man1/knife-data-bag.1')
-rw-r--r--distro/common/man/man1/knife-data-bag.126
1 files changed, 13 insertions, 13 deletions
diff --git a/distro/common/man/man1/knife-data-bag.1 b/distro/common/man/man1/knife-data-bag.1
index f0ec22f722..a756490846 100644
--- a/distro/common/man/man1/knife-data-bag.1
+++ b/distro/common/man/man1/knife-data-bag.1
@@ -1,6 +1,6 @@
.\" Man page generated from reStructuredText.
.
-.TH "KNIFE-DATA-BAG" "1" "Chef 11.12.0" "" "knife data bag"
+.TH "KNIFE-DATA-BAG" "1" "Chef 11.14" "" "knife data bag"
.SH NAME
knife-data-bag \- The man page for the knife data bag subcommand.
.
@@ -48,10 +48,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.
@@ -69,10 +69,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\&.
@@ -87,10 +87,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 CREATE
.sp
@@ -308,15 +308,15 @@ to:
.UNINDENT
.SH FROM FILE
.sp
-The \fBfrom file\fP argument is used to create a data bag on the Chef server from a file. The path to the data bag file must specify one of the following:
+The \fBfrom file\fP argument is used to:
.INDENT 0.0
.IP \(bu 2
-the name of a data bag
+Add a data bag item to a data bag
.IP \(bu 2
-a relative or absolute path to a file
+Update the contents of an existing data bag item
.UNINDENT
.sp
-If the name of a data bag is specified, Knife will search for the data bag in \fB\&./data_bags/bag_name/file\fP\&. Once opened, the JSON file should be a hash that contains at least an ID key which represents the name of the data bag item.
+The data bag itself must already exist on the Chef server and must be specified as part of the command. The contents of the data bag item are specified using a JSON file. This JSON file may be located at a relative or absolute path; its location must be specified as part of the command. The JSON file that defines the contents of the data bag item must at least contain the name of the data bag item\-\-\-\fB"id": "name"\fP\&.
.sp
\fBWARNING:\fP
.INDENT 0.0
@@ -345,7 +345,7 @@ This argument has the following options:
.INDENT 0.0
.TP
.B \fB\-a\fP, \fB\-\-all\fP
-Indicates that all data bags found at the specified path will be uploaded.
+Use to upload all data bags found at the specified path.
.TP
.B \fB\-\-secret SECRET\fP
The encryption key that is used for values contained within a data bag item.
@@ -410,7 +410,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