Replace LaTeX commentary blocks with [NOTE]

Add <diagram> option to <register> entries.

This enables us to override the auto-generated diagram when it doesn't
do a good job.

Hopefully we won't need it much. If we do, the auto-generation code
probably needs improvement.

Updated the table anchor for the 'Priority of reasons for entering Debug
Mode from highest to lowest' table.

Updated links to dcsr-cause.

Adding {} around links to csrs.

Updated the commentary LaTeX to admonitions.

Updated table link to asciidoc format.

Converted the Virtual address in DPC table to asciidoc.

Beginning to replace LaTeX tables with asciidoc.

Added missing words.
Added admonitions.
Clean up formatting.

Cleaned up conversion issues, formatted table correctly and added in
missing words.

Added missing words and admonitions.
Reformatted table.
Added anchors.

Draw register diagrams using bytefield-svg

Fix some macro uses that my script got wrong.

Bold field access (WARL etc.)

In asciidoc that totally breaks the tables.

Added a newline to the end of the comment at the top of generated files.
Added include of hwdp_registers.

Clean up remaining LaTeX register/field macros.

Surprised there are so few.

Add newline to end of "Auto-generated ..."

Without this, the first line of what should be the actual file contents
ended up as part of the comment.

Added rule to ignore the generated .adoc files in the build directory.

Deleted the pdf of the spec from an old build.