Extend documentation (was: Re: Issue getting my first Xen domU up)

[Rodney W. Grimes]

> On Wed, Feb 06, 2019 at 11:45:35PM +0000, Andrew Daugherity wrote:
> > > On Feb 6, 2019, at 11:17 AM, Roger Pau Monn? <roger.pau at citrix.com> wrote:
> > > 
> > > Adding Benedict who wrote the Xen handbook documentation, and
> > > hopefully would be able to fix it :).
> > > 
> > > I suggest the following is added to the handbook:
> > > [?]
> > 
> > 
> > 
> > While you?re at it, I think some other updates to that handbook page are in order.  I just read it again for the first time in a good while and the following things caught my eye:
> 
> Thanks for the feedback!
> 
> > - 21.8.2 mentions using Xen 4.7 on FreeBSD 11 and Xen 4.11 on FreeBSD-CURRENT >= r336475.  As 12.0 has been released, that merits a mention here? while "FreeBSD 12.0-RELEASE r341666 GENERIC" does have a higher rev number, I?m not sure whether or not it contains the necessary stuff for Xen 4.11.
> 
> FreeBSD 12.0 or FreeBSD-HEAD are all capable of using Xen 4.11.
> 
> > - The /var/log/xen dir is created (and owned) by the xen-tools4{7,11} packages, so no need to manually create it.
> > 
> > - Wouldn?t 'onifpresent' be a better setting for xc0 in /etc/ttys? Then if you booted back to a vanilla kernel, it won?t try (and fail) to start a getty for a nonexistent device.
> > 
> > - The DomU example creates a FreeBSD 10.3 VM.  Probably better to showcase a supported release?
> 
> Right, let me see about this.
> 
> > - Seeing "Xen(TM)" sprinkled throughout the document interrupts the reading flow.  Surely it?s enough to use the trademark symbol for the first mention and then simply "Xen" thereafter?
> 
> I don't have an opinion here, I don't know whether using Xen^TM is
> mandatory.

Using Trademark Symbols

    Preferred Usage: In press releases and business writing, it is recommended
to use the trademark symbol [superscript ® or TM] on the first instance only
or with the most prominent use of the mark. ...

    Possible Exceptions: If the first instance is in the title, then can use
the symbol on the first instance in the text.

So I would summarize we can safely remove all but 2 of the TM's since
it probably appears in the title of the page.

> 
> > - Is it really necessary to 'xl destroy' the DomU after shutting it down?  Once it?s shut down, it shouldn?t be in the list any more, and you just 'xl create' with the new config, right?
> 
> I don't see the manual suggesting to perform an `xl shutdown ...`, am
> I missing something?
> 
> It suggests to destroy the domain after install is finished, there's
> no need to perform a graceful shutdown of the installer.
> 
> Thanks, Roger.

-- 
Rod Grimes                                                 rgrimes at freebsd.org