[libvirt] First Virsh command Reference Pages online

[Osier]

----- "Justin Clift" <jclift at redhat.com> wrote:

> On 12/11/2010, at 9:38 AM, Osier Yang wrote:
> > looks pretty good, though missed "net-info", it still need to be
> ACKed.. :-)
> 
> Yeah, trying out the net-info patch is on my list of things to try
> today (time dependant). :)
> 

great

just note: I didn't implemente the codes to display the domain interfaces
which are attached to the network, it need arbitrary API. probly we 
can do it as a next step.. :-)


> The code looked pretty straight forward from a visual inspection, so
> I'm not thinking there will be any problems with it.
> 
> 
> >> We can output to multiple formats (html, single-page-html, pdf,
> epub, txt), so it's probably a decent idea
> >> to put the downloadable ones somewhere, and have the html pages
> viewable online.
> >> 
> >> My initial thinking is adding the downloads to the Downloads page,
> with the files themselves in the libvirt FTP area.
> >> 
> >> Something like:
> >> 
> >>   ftp://libvirt.org/libvirt/virshcmdref/<stuff>
> >> 
> > 
> > also git repo?
> 
> Very good point yes.  And probably also worth including my email
> address under it directly, as it's easier than people having to go
> through the mailing list sign up process.  (same thought for the App
> Dev Guide and David Jorm's email)

> 
> 
> >> Unsure what a good menu placement for the online html pages are
> though.  This is just the first few commands, and
> >> not a "widely comprehensive" reference thing yet.
> >> 
> > 
> > will it be fine as a submenu of top "Documentation" memu? the
> > development guide is there, as Daniel P.Berrange said, probly
> > these docs will be part of "Admin guide". If so, it's reasonable
> > to put there IMHO.
> 
> Submenu of top Doc menu, yeah, that's probably workable.
> 
> Thanks Osier. :)