do not use plain-text ELF(3) to reference page titles, use .Nm or .Xr.:

issue noticed by naddy@ when he inspected a bug report from aalm@;
while here, use .At where appropriate;
OK naddy@ jmc@

6 files changed, 34 insertions, 16 deletions

diff --git a/lib/libelf/elf.3 b/lib/libelf/elf.3
index f946fb936b8..497808efd3f 100644
--- a/lib/libelf/elf.3
+++ b/lib/libelf/elf.3
@@ -21,7 +21,7 @@
 .\" out of the use of this software, even if advised of the possibility of
 .\" such damage.
 .\"
-.\" $Id: elf.3,v 1.2 2019/03/19 02:31:35 jsg Exp $
+.\" $Id: elf.3,v 1.3 2019/06/11 18:30:31 schwarze Exp $
 .\"
 .Dd February 5, 2019
 .Dt ELF 3
@@ -615,8 +615,11 @@ descriptor itself.
 .Xr ar 5 ,
 .Xr elf 5
 .Sh HISTORY
-The original ELF(3) API was developed for Unix System V.
-The current implementation of the ELF(3) API appeared in
+The original
+.Nm
+API was developed for
+.At V .
+The current implementation of the API appeared in
 .Fx 7.0 .
 .Sh AUTHORS
 The ELF library was written by
diff --git a/lib/libelf/elf_flagdata.3 b/lib/libelf/elf_flagdata.3
index f2cb2126e3b..c099c43fde2 100644
--- a/lib/libelf/elf_flagdata.3
+++ b/lib/libelf/elf_flagdata.3
@@ -21,7 +21,7 @@
 .\" out of the use of this software, even if advised of the possibility of
 .\" such damage.
 .\"
-.\" $Id: elf_flagdata.3,v 1.1 2019/02/01 05:27:37 jsg Exp $
+.\" $Id: elf_flagdata.3,v 1.2 2019/06/11 18:30:31 schwarze Exp $
 .\"
 .Dd December 3, 2011
 .Dt ELF_FLAGDATA 3
@@ -34,7 +34,7 @@
 .Nm elf_flagphdr ,
 .Nm elf_flagscn ,
 .Nm elf_flagshdr
-.Nd manipulate flags associated with ELF(3) data structures
+.Nd manipulate flags associated with ELF data structures
 .Sh LIBRARY
 .Lb libelf
 .Sh SYNOPSIS
@@ -65,7 +65,9 @@ and
 .Ar scn
 denote the data structures whose flags need to be changed.
 These values should have been returned by prior calls to
-functions in the ELF(3) API set:
+functions in the
+.Xr elf 3
+API set:
 .Bl -bullet -compact
 .It
 Argument
@@ -175,7 +177,9 @@ function and the
 .Dv ELF_F_ARCHIVE
 and
 .Dv ELF_F_ARCHIVE_SYSV
-flags are an extension to the ELF(3) API.
+flags are an extension to the
+.Xr elf 3
+API.
 .Sh ERRORS
 These functions may fail with the following errors:
 .Bl -tag -width "[ELF_E_RESOURCE]"
diff --git a/lib/libelf/elf_open.3 b/lib/libelf/elf_open.3
index 7b6da8f2d3e..ec01f438228 100644
--- a/lib/libelf/elf_open.3
+++ b/lib/libelf/elf_open.3
@@ -21,7 +21,7 @@
 .\" out of the use of this software, even if advised of the possibility of
 .\" such damage.
 .\"
-.\" $Id: elf_open.3,v 1.1 2019/02/01 05:27:37 jsg Exp $
+.\" $Id: elf_open.3,v 1.2 2019/06/11 18:30:31 schwarze Exp $
 .\"
 .Dd May 31, 2012
 .Dt ELF_OPEN 3
@@ -43,7 +43,9 @@ The functions
 .Fn elf_open
 and
 .Fn elf_openmemory
-are extensions to the ELF(3) API, for the internal use of the
+are extensions to the
+.Xr elf 3
+API, for the internal use of the
 Elftoolchain project.
 Portable applications should not use these functions.
 .Pp
@@ -71,7 +73,9 @@ specifies the size of the memory area in bytes.
 The function returns a pointer to a ELF descriptor if successful, or
 NULL if an error occurred.
 .Sh COMPATIBILITY
-These functions are non-standard extensions to the ELF(3) API set.
+These functions are non-standard extensions to the
+.Xr elf 3
+API set.
 .Pp
 The behavior of these functions differs from their counterparts
 .Xr elf_begin 3
diff --git a/lib/libelf/gelf.3 b/lib/libelf/gelf.3
index 86f146028fe..3937a15588b 100644
--- a/lib/libelf/gelf.3
+++ b/lib/libelf/gelf.3
@@ -21,7 +21,7 @@
 .\" out of the use of this software, even if advised of the possibility of
 .\" such damage.
 .\"
-.\" $Id: gelf.3,v 1.1 2019/02/01 05:27:37 jsg Exp $
+.\" $Id: gelf.3,v 1.2 2019/06/11 18:30:31 schwarze Exp $
 .\"
 .Dd September 1, 2006
 .Dt GELF 3
@@ -192,7 +192,10 @@ Copy back an ELF symbol table entry.
 .Xr elf 3 ,
 .Xr elf 5
 .Sh HISTORY
-The GELF(3) API first appeared in System V Release 4.
+The
+.Nm
+API first appeared in
+.At V.4 .
 This implementation of the API first appeared in
 .Fx 7.0 .
 .Sh AUTHORS
diff --git a/lib/libelf/gelf_newehdr.3 b/lib/libelf/gelf_newehdr.3
index 25f8657da27..7bf742a88a6 100644
--- a/lib/libelf/gelf_newehdr.3
+++ b/lib/libelf/gelf_newehdr.3
@@ -21,7 +21,7 @@
 .\" out of the use of this software, even if advised of the possibility of
 .\" such damage.
 .\"
-.\" $Id: gelf_newehdr.3,v 1.1 2019/02/01 05:27:38 jsg Exp $
+.\" $Id: gelf_newehdr.3,v 1.2 2019/06/11 18:30:31 schwarze Exp $
 .\"
 .Dd October 22, 2007
 .Dt GELF_NEWEHDR 3
@@ -134,7 +134,9 @@ The
 function uses a type of
 .Ft "void *"
 for its returned value.
-This differs from some other implementations of the ELF(3) API, which use an
+This differs from some other implementations of the
+.Xr elf 3
+API, which use an
 .Ft "unsigned long"
 return type.
 .Sh ERRORS
diff --git a/lib/libelf/gelf_newphdr.3 b/lib/libelf/gelf_newphdr.3
index 86e635022ad..61e07066f11 100644
--- a/lib/libelf/gelf_newphdr.3
+++ b/lib/libelf/gelf_newphdr.3
@@ -21,7 +21,7 @@
 .\" out of the use of this software, even if advised of the possibility of
 .\" such damage.
 .\"
-.\" $Id: gelf_newphdr.3,v 1.1 2019/02/01 05:27:38 jsg Exp $
+.\" $Id: gelf_newphdr.3,v 1.2 2019/06/11 18:30:31 schwarze Exp $
 .\"
 .Dd October 22, 2007
 .Dt GELF_NEWPHDR 3
@@ -103,7 +103,9 @@ The
 function uses a type of
 .Ft "void *"
 for its returned value.
-This differs from some other implementations of the ELF(3) API, which use an
+This differs from some other implementations of the
+.Xr elf 3
+API, which use an
 .Ft "unsigned long"
 return type.
 .Sh ERRORS