Signed-off-by: Alejandro Colomar <alx.manpages@xxxxxxxxx>
---
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
