New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

xe manpages #957

Merged
merged 6 commits into from Apr 22, 2013

Conversation

Projects
None yet
6 participants
@grantmcwilliams
Contributor

grantmcwilliams commented Dec 31, 2012

Manpages for the following xe subcommands.

xe-pif-param-clear
xe-pif-param-get
xe-pif-param-list
xe-pif-param-remove

Let us know about syntax, formatting etc. on these 4. We 50 more in the pipe passing internal peer review.

@xen-git

This comment has been minimized.

Member

xen-git commented Dec 31, 2012

Can one of the admins verify this patch?

@jonludlam

This comment has been minimized.

Member

jonludlam commented Jan 14, 2013

Thanks, the man pages look great!

I have a minor question - I'm simply not sure of the protocol here, but what does the 'AUTHORS' section mean? Is it authorship of the manpage or of the tool it's describing?

BUGS
----
Send bugs to xen-devel@lists.xen.org, see http://wiki.xen.org/wiki/Reporting_Bugs_against_XCP on how to send bug reports. General questions can be sent to xen-api@lists.xen.org.

This comment has been minimized.

@robhoes

robhoes Jan 14, 2013

Member

Bugs in xe/xapi are better sent to xen-api@lists.xen.org, not xen-devel. Xen-devel is more for hypervisor-level matter.

This comment has been minimized.

@grantmcwilliams

grantmcwilliams Jan 14, 2013

Contributor

Noted, we'll make the changes.

Also for Jon - This is from the manpage Howto.

"The AUTHOR section

...is nice to have in case there are gross errors in the documentation or program behaviour (Bzzt!) and you want to mail a bug report."

So it appears to be either/or. Perhaps we should specify. I want the manpage team to get credit but not undue credit.

@Mattsface

This comment has been minimized.

Member

Mattsface commented on 1719580 Jan 16, 2013

What do you guys think of changes?

This comment has been minimized.

Member

grantmcwilliams replied Jan 16, 2013

Looks good.

@jonludlam

This comment has been minimized.

Member

jonludlam commented Jan 20, 2013

Look good thanks! What do you want to do about installing these? At the moment this is just adding the man pages to the repository - are you intending to add them to the RPMs so they're present in dom0?

@grantmcwilliams

This comment has been minimized.

Contributor

grantmcwilliams commented Jan 21, 2013

Preferably they'd be distributed. On our side we have a script that creates manpages from the asciidoc source and we've created a SPEC file for the RPM itself. None of this is done though. When it's done we can share that too if there's interest.

@xen-git

This comment has been minimized.

Member

xen-git commented Feb 2, 2013

Can one of the admins verify this patch?

1 similar comment
@xen-git

This comment has been minimized.

Member

xen-git commented Feb 25, 2013

Can one of the admins verify this patch?

@xen-git

This comment has been minimized.

Member

xen-git commented Mar 27, 2013

Can one of the admins verify this patch?

@djs55

This comment has been minimized.

Collaborator

djs55 commented Mar 27, 2013

ok to test

On Wed, Mar 27, 2013 at 5:30 PM, xen-git notifications@github.com wrote:

Can one of the admins verify this patch?

Reply to this email directly or view it on GitHubhttps://github.com//pull/957#issuecomment-15538644
.

Dave Scott

@jonludlam

This comment has been minimized.

Member

jonludlam commented Apr 22, 2013

Apologies for the delay in merging - I think we had aspirations of doing some more autogeneration in this area, but it's not going to happen soon. Thanks very much for doing this work - we'd certainly be interested in the spec file changes to get these installed.

jonludlam pushed a commit that referenced this pull request Apr 22, 2013

@jonludlam jonludlam merged commit 2b057d9 into xapi-project:master Apr 22, 2013

@grantmcwilliams

This comment has been minimized.

Contributor

grantmcwilliams commented Apr 22, 2013

Thanks Jon. We're upping our schedule to get more pages. Out we have a ton in the works but need to sign off on them internally before handing them over. Also we're working on moving our project more public so people can see what we're working on.

I'll put the RPM generation back on front burner.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment