xen: add troubleshooting section

[royger]

Summary

This contains some tips to troubleshoot FreeBSD as a host or when
attempting to create guests.

[bcr]

It seems like a lot, but most of these are easy to fix. Let textproc/igor run over it a couple of times and you'll get the exact spots where you need to fix things.
Thank you for the work writing these. I'd be happy to review an updated diff.

en_US.ISO8859-1/books/handbook/virtualization/chapter.xml

1725

There should be an empty line after the title tag.

1726

s/constain/contains/

1727

s/troubleshot/troubleshoot/

1729

You can move the closing <para> up right behind the "guest." part. textproc/igor will tell you about these.

1733

You can start writing right after <para>, no need for a line break here.

1734

s/troubleshootting/troubleshooting/

1740

Extra space after a sentence stop. textproc/igor will also find and tell you about those occurances (what a snitch). ;-)

1762

The "in order" can be left out.

1763

s/reate/rate/

1764

s/guest/guests/

1772

I'd add: "To activate verbose booting, run this command:"

1780

s/this/these/
s/helps/help/

1783

s/diagnostic/diagnostics/ (or even analysis?)

1788

The "creation" should be capitalized. textproc/igor will remind you of that. Only a few words in title tags are lowercase like "the", "a", or "of".

1799

I'd also add <literal> tags to this instance of xl.

1800

Sentence stop missing here. Not sure if textproc/igor is looking for those...

1824

you can also use the &os; placeholder here (and in the next two lines) if you like, but it's optional.

1826

I'd add a sentence stop after the </filename> here and start a new sentence: Both log files can contain useful information for debugging.

[royger]

Thanks, new version coming.

en_US.ISO8859-1/books/handbook/virtualization/chapter.xml

1824

I've left this as 'freebsd', since the guest name in the example config name uses 'freebsd' instead of &os;

[royger]

Apply requested fixes, run igor.

[bcr]

OK as well. Thanks for doing the work. Let me know if I should commit it (giving proper attribution, of course).

[royger]

If it's not too much hassle please commit it :)

Thanks for the reviews!