[RFC] memusage.1, uri.7, user-keyring.7, user-session-keyring.7, ld.so.8, tzselect.8: srcfix: Replace \f markup by .

[Alejandro Colomar <alx.manpages@gmail.com>]

Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
---

Hi,

I was trying to see if I can write a script to fix these.
Here's a sample of what I would change.

It seems a bit complicated. There are exceptions:

* I think for code inside [.EX/.EE], [\f] is more appropriate than [.];
  what do you think about it?

* And for [.TP] tags, [\f] seems to be the only solution
  (for more than 2 different formattings in a line).

So I would try to write a script that omits code inside [.EX/.EE],
and also just after [.TP].

And I also found a few weird files (such as zic.8 and zdump.8).
Where do those come from?
I'll try to rewrite them using man(7) markup.
In the meantime,
I would also have to omit those files from the input to the script.
Do you have a list of such files?

Cheers,

Alex


 man1/memusage.1             | 29 +++++++++++++++++++++--------
 man7/uri.7                  |  6 ++++--
 man7/user-keyring.7         |  4 +++-
 man7/user-session-keyring.7 |  4 +++-
 man8/ld.so.8                |  7 +++++--
 man8/tzselect.8             |  6 +++---
 6 files changed, 39 insertions(+), 17 deletions(-)

diff --git a/man1/memusage.1 b/man1/memusage.1
index 7ceaece56..f7b62bb6c 100644
--- a/man1/memusage.1
+++ b/man1/memusage.1
@@ -65,14 +65,20 @@ The "Memory usage summary" line output by
 contains three fields:
 .RS 4
 .TP
-\fBheap total\fR
-Sum of \fIsize\fR arguments of all
+.B heap total
+Sum of
+.I size
+arguments of all
 .BR malloc (3)
 calls,
-products of arguments (\fInmemb\fR*\fIsize\fR) of all
+products of arguments
+.RI ( nmemb * size )
+of all
 .BR calloc (3)
 calls,
-and sum of \fIlength\fR arguments of all
+and sum of
+.I length
+arguments of all
 .BR mmap (2)
 calls.
 In the case of
@@ -83,17 +89,24 @@ if the new size of an allocation is larger than the previous size,
 the sum of all such differences (new size minus old size) is added.
 .TP
 .B "heap peak"
-Maximum of all \fIsize\fR arguments of
+Maximum of all
+.I size
+arguments of
 .BR malloc (3),
-all products of \fInmemb\fR*\fIsize\fR of
+all products of
+.IR nmemb * size
+of
 .BR calloc (3),
-all \fIsize\fR arguments of
+all
+.I size
+arguments of
 .BR realloc (3),
 .I length
 arguments of
 .BR mmap (2),
 and
-\fInew_size\fR arguments of
+.I new_size
+arguments of
 .BR mremap (2).
 .TP
 .B "stack peak"
diff --git a/man7/uri.7 b/man7/uri.7
index c23cbce59..a36c2f2c3 100644
--- a/man7/uri.7
+++ b/man7/uri.7
@@ -600,10 +600,12 @@ Technically the fragment isn't part of the URI.
 .PP
 For information on how to embed URIs (including URLs) in a data format,
 see documentation on that format.
-HTML uses the format <A HREF="\fIuri\fP">
+HTML uses the format <A
+.RI HREF=\(dq uri \(dq>
 .I text
 </A>.
-Texinfo files use the format @uref{\fIuri\fP}.
+Texinfo files use the format
+.RI @uref{ uri }.
 Man and mdoc have the recently added UR macro, or just include the
 URI in the text (viewers should be able to detect :// as part of a URI).
 .PP
diff --git a/man7/user-keyring.7 b/man7/user-keyring.7
index 4b249d60d..7938bd40c 100644
--- a/man7/user-keyring.7
+++ b/man7/user-keyring.7
@@ -51,7 +51,9 @@ the calling process's user keyring.
 .PP
 From the
 .BR keyctl (1)
-utility, '\fB@u\fP' can be used instead of a numeric key ID in
+utility,
+.RB \(aq @u \(aq
+can be used instead of a numeric key ID in
 much the same way.
 .PP
 User keyrings are independent of
diff --git a/man7/user-session-keyring.7 b/man7/user-session-keyring.7
index 22560bd19..df7482b2a 100644
--- a/man7/user-session-keyring.7
+++ b/man7/user-session-keyring.7
@@ -54,7 +54,9 @@ the calling process's user session keyring.
 .PP
 From the
 .BR keyctl (1)
-utility, '\fB@us\fP' can be used instead of a numeric key ID in
+utility,
+.RB \(aq @us \(aq
+can be used instead of a numeric key ID in
 much the same way.
 .PP
 User session keyrings are independent of
diff --git a/man8/ld.so.8 b/man8/ld.so.8
index 614a112a4..553ded9f1 100644
--- a/man8/ld.so.8
+++ b/man8/ld.so.8
@@ -38,7 +38,10 @@ The program
 handles a.out binaries, a binary format used long ago.
 The program
 .B ld\-linux.so*
-(\fI/lib/ld\-linux.so.1\fP for libc5, \fI/lib/ld\-linux.so.2\fP for glibc2)
+.RI ( /lib/ld\-linux.so.1
+for libc5,
+.I /lib/ld\-linux.so.2
+for glibc2)
 handles binaries that are in the more modern ELF format.
 Both programs have the same behavior, and use the same
 support files and programs
@@ -648,7 +651,7 @@ which is now always enabled.
 The name of a (single) shared object to be profiled,
 specified either as a pathname or a soname.
 Profiling output is appended to the file whose name is:
-"\fI$LD_PROFILE_OUTPUT\fP/\fI$LD_PROFILE\fP.profile".
+.RI \(dq $LD_PROFILE_OUTPUT / $LD_PROFILE .profile\(dq.
 .IP
 Since glibc 2.2.5,
 .BR LD_PROFILE
diff --git a/man8/tzselect.8 b/man8/tzselect.8
index e9dcd1265..fd17bca53 100644
--- a/man8/tzselect.8
+++ b/man8/tzselect.8
@@ -34,14 +34,14 @@ Name of the directory containing timezone data files (default:
 .\" or perhaps /usr/local/etc/zoneinfo in some older systems.
 .SH FILES
 .TP
-\fBTZDIR\fP\fI/iso3166.tab\fP
+.BI TZDIR /iso3166.tab
 Table of ISO 3166 2-letter country codes and country names.
 .TP
-\fBTZDIR\fP\fI/zone.tab\fP
+.BI TZDIR /zone.tab
 Table of country codes, latitude and longitude, TZ values, and
 descriptive comments.
 .TP
-\fBTZDIR\fP\fI/\fP\fITZ\fP
+.BI TZDIR /TZ
 Timezone data file for timezone
 .IR TZ .
 .SH SEE ALSO
-- 
2.28.0