doc: Fix some typos and add some missing references

Building the docs point out a few issues:

abidiff.rst:238: WARNING: Unknown target name: "linux kernel".
abidiff.rst:249: WARNING: Unknown target name: "linux kernel".
abidiff.rst:263: WARNING: Unknown target name: "linux kernel".
abidiff.rst:274: WARNING: Unknown target name: "linux kernel".
abidw.rst:23: WARNING: Unknown target name: "btf`_formats, if present. finally, if no debug info in these formats is found, it only considers `elf".
abidw.rst:34: WARNING: duplicate label abidiff_invocation_label, other instance in doc/manuals/abidiff.rst
abipkgdiff.rst:298: WARNING: Unknown target name: "linux kernel".
abipkgdiff.rst:309: WARNING: Unknown target name: "linux kernel".
abipkgdiff.rst:323: WARNING: Unknown target name: "linux kernel".
abipkgdiff.rst:334: WARNING: Unknown target name: "linux kernel".
libabigail-concepts.rst:620: WARNING: Block quote ends without a blank line; unexpected unindent.
libabigail-overview.rst:1: WARNING: Title overline too short.

Fix those as follows:

    * doc/manuals/abidiff.rst: Add Linux Kernel reference.
    * doc/manuals/abipkgdiff.rst: Likewise.
    * doc/manuals/abidw.rst: Add space between `BTF`_ and formats.
    Rename _abidiff_invocation_label to _abidw_invocation_label.
    * doc/manuals/libabigail-concepts.rst: Add empty line between
    _suppr_has_size_change_property_label and has_size_change.
    * doc/manuals/libabigail-overview.rst: Extend title overlines.

Signed-off-by: Mark Wielaard <mark@klomp.org>
Signed-off-by: Dodji Seketeli <dodji@redhat.com>

diff --git a/doc/manuals/abidiff.rst b/doc/manuals/abidiff.rst
index d5dc96991cfe14a6dda7b01f8ee632c4429f59aa..0c965c412c3b0043a53af03afe4d2cc8f09069b9 100644 (file)
--- a/doc/manuals/abidiff.rst
+++ b/doc/manuals/abidiff.rst
@@ -852,3 +852,4 @@ Usage examples
 .. _ODR: https://en.wikipedia.org/wiki/One_Definition_Rule
 .. _One Definition Rule: https://en.wikipedia.org/wiki/One_Definition_Rule
 .. _DWZ: https://sourceware.org/dwz
+.. _Linux Kernel: https://kernel.org/

diff --git a/doc/manuals/abidw.rst b/doc/manuals/abidw.rst
index 93eced711df2358ea15ed2fdf1382587bcdc16f0..3cba434cfcbd9b0b1d60c2dbc714cc293df26b2b 100644 (file)
--- a/doc/manuals/abidw.rst
+++ b/doc/manuals/abidw.rst
@@ -22,13 +22,13 @@ types.
 
 To generate either ABI or KMI representation, by default ``abidw``
 uses debug information in the `DWARF`_ format, if present, otherwise
-it looks for debug information in `CTF`_ or `BTF`_formats, if present.
+it looks for debug information in `CTF`_ or `BTF`_ formats, if present.
 Finally, if no debug info in these formats is found, it only considers
 `ELF`_ symbols and report about their addition or removal.
 
 .. include:: tools-use-libabigail.txt
 
-.. _abidiff_invocation_label:
+.. _abidw_invocation_label:
 
 Invocation
 ==========

diff --git a/doc/manuals/abipkgdiff.rst b/doc/manuals/abipkgdiff.rst
index d448ad3ebb009fab63da717a414100d60aec1377..5f499ae15b763e07bda27a9e4f571156d660a43c 100644 (file)
--- a/doc/manuals/abipkgdiff.rst
+++ b/doc/manuals/abipkgdiff.rst
@@ -583,3 +583,4 @@ In the later case, the value of the exit code is the same as for the
 .. _ODR: https://en.wikipedia.org/wiki/One_Definition_Rule
 .. _One Definition Rule: https://en.wikipedia.org/wiki/One_Definition_Rule
 .. _DWZ: https://sourceware.org/dwz
+.. _Linux Kernel: https://kernel.org/

diff --git a/doc/manuals/libabigail-concepts.rst b/doc/manuals/libabigail-concepts.rst
index 326a346eb1762acdaa13e9b2b709352bbc527ee6..4f26932c043ba7e1e1bff362d7c6b221be6fcfbf 100644 (file)
--- a/doc/manuals/libabigail-concepts.rst
+++ b/doc/manuals/libabigail-concepts.rst
@@ -617,6 +617,7 @@ names start with the string "private_data_member".
 
 
  .. _suppr_has_size_change_property_label:
+
 * ``has_size_change``
 
  Usage:

diff --git a/doc/manuals/libabigail-overview.rst b/doc/manuals/libabigail-overview.rst
index 88832ab30dd231005601683be64361e94a7ba1fe..73f4e1f7932f826af977e10d8bf276ad4fd34d71 100644 (file)
--- a/doc/manuals/libabigail-overview.rst
+++ b/doc/manuals/libabigail-overview.rst
@@ -1,6 +1,6 @@
-####################
+#################################
 Overview of the Abigail framework
-####################
+#################################
 
 **ABIGAIL** stands for the Application Binary Interface Generic
 Analysis and Instrumentation Library.