airship/shipyard
Code Issues Proposed changes

Update shipyard CLI documentation for shipyard create configdocs command.

Browse Source 
Change-Id: Iec215848c2a65d9d83d56a7aa293b24ea6a03d55
This commit is contained in:
Bryan Strassner 2017-10-12 20:56:00 -05:00
parent ab3ae1a86c
commit 823df44501
1 changed files with 14 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
docs/CLI.md
View File

@ -156,18 +156,25 @@ Example:
</dl> </dl>
## create configdocs ## create configdocs
Load documents into the Shipyard Buffer. Load documents into the Shipyard Buffer. The use of one or more filename or
a single directory option must be specified.
``` ```
shipyard create configdocs shipyard create configdocs
<collection> <collection>
[--append | --replace] [--append | --replace]
[--filename=<filename> (repeatable) --filename=<filename> (repeatable)
| |
--directory=<directory>] --directory=<directory>
Example: Example:
shipyard create configdocs design --append --filename=site_design.yaml shipyard create configdocs design --append --filename=site_design.yaml
``` ```
Note: If neither append or replace are specified, the Shipyard API default
value of rejectoncontents will be used.
Note: Either --filename or --directory must be specified, but both may not be
specified for the same invocation of shipyard.
<dl> <dl>
<dt>&lt;collection&gt;</dt> <dt>&lt;collection&gt;</dt>
<dd> <dd>
@ -186,13 +193,15 @@ Example:
<dd> <dd>
The file name to use as the contents of the collection. (repeatable) The file name to use as the contents of the collection. (repeatable)
If any documents specified fail basic validation, all of the documents If any documents specified fail basic validation, all of the documents
will be rejected. will be rejected. Use of filename parameters may not be used in
conjunction with the directory parameter.
</dd> </dd>
<dt>--directory=&lt;directory&gt;</dt> <dt>--directory=&lt;directory&gt;</dt>
<dd> <dd>
A directory containing documents that will be joined and loaded as a A directory containing documents that will be joined and loaded as a
collection. Any documents that fail basic validation will reject the collection. Any documents that fail basic validation will reject the
whole set. whole set. Use of the directory parameter may not be used with the filename
parameter.
</dd> </dd>
</dl> </dl>