Issue #7833 has been updated by Nick Fagerlund.

Daniel Pittman wrote:
> I am not clear why it wraps to *two* extra lines...

Oh, cool, I didn't know it auto-wrapped synopses. 

I thought this might the same thing as the RETURNS issue I mentioned (we're 
making the string longer by prepending a label), but starting it on the next 
line down didn't help. Hmm.

> Perhaps \["RETURNS:"\] should be called out more as a header, than inline to 
> the first line?

Yeah... it makes the help taller, but... hrm. Well, it's not urgent; I've 
cleaned up the two actions it was affecting, so we can delay that thought for 
now.
----------------------------------------
Bug #7833: Further small issues with Faces CLI help
https://projects.puppetlabs.com/issues/7833

Author: Randall Hansen
Status: Accepted
Priority: Normal
Assignee: Nick Fagerlund
Category: 
Target version: 2.7.0
Affected Puppet version: 
Keywords: 
Branch: 


<pre>
    puppet help catalog apply
</pre>
* "RETURNS" wraps at 85 characters.  I thought our wrap limit was lower?

<pre>
    puppet help certificate *
    --ca-location LOCATION         - The certificate authority to query (local 
or
                                   remote).
</pre>
  * would be nice if this didn't wrap

<pre>
    puppet help certificate destroy
    puppet help certificate generate
    puppet help certificate search
</pre>
* USAGE is broken over multiple lines

<pre>
    puppet help certificate save
    puppet help certificate_revocation_list save
    puppet help node save
    puppet help resource_type save
    puppet help status save
</pre>
* `puppet help certificate` says "Invalid for this subcommand" but the help 
says "API only."
  * summary should lead with "API only"

<pre>
    puppet help certificate_request search
</pre>
* what's <dummy_key> and why is it necessary?

<pre>
    puppet help facts find
</pre>
* "RENDERING ISSUES: Facts cannot currently be rendered as a string."
  * how are they rendered?  binary?  we should clarify this.

<pre>
    puppet help facts upload
</pre>
* I'm not sure how you include TERMINI:  is it only per subcommand, not per 
action?  Can we make this clearer?



-- 
You have received this notification because you have either subscribed to it, 
or are involved in it.
To change your notification preferences, please click here: 
http://projects.puppetlabs.com/my/account

-- 
You received this message because you are subscribed to the Google Groups 
"Puppet Bugs" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/puppet-bugs?hl=en.

Reply via email to