Re: Updating related boot(8) pages

[Alistair Crooks <agc%pkgsrc.org@localhost>]

On Fri, Nov 05, 2010 at 05:13:05PM +0100, Jean-Yves Migeon wrote:
> I had to PXE boot a dom0 kernel recently, with all the boot.cfg and DOM0
> module + hypervisor deported on a host.
> 
> It took my quite some time, mainly due to lack of documentation. Finding a
> mail from Christoph [1] sent two years ago (: would have helped me, but
> IMHO, such stuff deserves to be added to boot(8) related man pages (in
> addition to doc fixes, which I checked through code reading).
> 
> Before committing this stuff, I would appreciate if some of you could
> proof-read my writings (correctness, better wording, etc.)
> 
> This diff:
> - indicates that module loading (and not only boot.cfg support) is
> disabled with PXE boot. Very helpful, as DOM0 kernel is loaded as a module.
> *sigh*
> - writes down the different arguments you can pass to a NetBSD DOM0 module
> - a few minor fixes, especially in command passed interactively to boot
> loader.

My view is that, if you, as one of the leading lights in NetBSD Xen
development, find that the documentation is lacking and inadequate,
then the documentation should be updated, whether or not the English
is good or bad (FYI, I find your English excellent), contains tyops,
etc.

So if this was me, I'd commit it, and if someone has problems with the
grammar, well, they get to do things with it.  Anything that documents
some of the intricacies of this area is to be applauded - thank you!

Best,
Alistair