Skip to content
This repository has been archived by the owner on Feb 24, 2020. It is now read-only.

rkt: add long command descriptions #2098

Merged
merged 2 commits into from Feb 4, 2016

Conversation

blixtra
Copy link
Collaborator

@blixtra blixtra commented Feb 3, 2016

Most of these changes were inspired by the rkt subcommand documentation.

Closes #2080

@blixtra
Copy link
Collaborator Author

blixtra commented Feb 3, 2016

Is this worth a CHANGELOG entry? I say yeah.

@iaguis iaguis added this to the v1.0.0 milestone Feb 3, 2016
@blixtra blixtra force-pushed the blixtra/add-long-command-descriptions branch 2 times, most recently from 6bd2ff1 to 6aa461e Compare February 3, 2016 16:01

Long: `UUID should be the UUID of a running pod.

By default the CMD run is bash, providing the user with shell access to the
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

bash -> /bin/bash

@blixtra blixtra force-pushed the blixtra/add-long-command-descriptions branch from 6aa461e to 4d0a66b Compare February 3, 2016 18:00
@blixtra
Copy link
Collaborator Author

blixtra commented Feb 3, 2016

Updated

Short: "Garbage collect rkt pods no longer in use",
Long: `This is intended to be run periodically from a timer or cron job.

Garbage collection is a 2 step process. First, stopped pods are moved to the
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/2 step/2-step/?

@blixtra blixtra force-pushed the blixtra/add-long-command-descriptions branch from 4d0a66b to 38b6b22 Compare February 3, 2016 18:29
@alban
Copy link
Member

alban commented Feb 3, 2016

LGTM

@@ -34,7 +34,10 @@ var (
cmdFetch = &cobra.Command{
Use: "fetch IMAGE_URL...",
Short: "Fetch image(s) and store them in the local store",
Run: runWrapper(runFetch),
Long: `Locates and downloads remote ACIs and their attached signatures.
If the ACI image is available in the local store, the image will not be fetched
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ACI image is redundant

@jonboulle
Copy link
Contributor

Paging @joshix

@alban
Copy link
Member

alban commented Feb 3, 2016

This needs to be rebased, it has some conflicts.

@@ -42,7 +42,11 @@ var (
cmdAPIService = &cobra.Command{
Use: `api-service [--listen="localhost:15441"]`,
Short: "Run API service (experimental, DO NOT USE IT)",
Run: runWrapper(runAPIService),
Long: `The API service listens for gRPC requests on the address and
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Quoting style: Should Run: value be quoted as it is here, with backticks, or as the value for Short: is quoted, in double quotes?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it is fine as it is: double quotes for single-line strings and backticks for multi-line strings.

@blixtra blixtra force-pushed the blixtra/add-long-command-descriptions branch from 38b6b22 to d5a45f1 Compare February 3, 2016 23:29
@blixtra
Copy link
Collaborator Author

blixtra commented Feb 3, 2016

updated and rebased

@alban
Copy link
Member

alban commented Feb 4, 2016

Thanks

alban added a commit that referenced this pull request Feb 4, 2016
…ptions

rkt: add long command descriptions
@alban alban merged commit bb1cabe into rkt:master Feb 4, 2016
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

5 participants