[PATCH 1/3] man2/syscalls.2: srcfix (1/3)

[PATCH 1/3] man2/syscalls.2: srcfix (1/3)

[G. Branden Robinson]

[-- Attachment #1: Type: text/plain, Size: 1382 bytes --]

Migrate table entries from using font selection escape sequences to font
alternation macros to set man page cross references.

This change was automatically driven by the following sed(1) script.

$ cat pre-MR-migrate-cross-references-1.sed
/^\.\\"/b
/^\\fB[^\\]*\\fP([0-9][^\]*).*T{/s/\\fB\([^\\]*\)\\fP(\([0-9][^\]*\))\(.*\)/T{\
.BR \1 (\2)\
T}\3/

Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>

---
 man2/syscalls.2 | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/man2/syscalls.2 b/man2/syscalls.2
index 7a7d6d730..979dba538 100644
--- a/man2/syscalls.2
+++ b/man2/syscalls.2
@@ -187,7 +187,8 @@ .SS System call list
 \fBchdir\fP(2)	1.0
 \fBchmod\fP(2)	1.0
 \fBchown\fP(2)	2.2	T{
-See \fBchown\fP(2) for
+See .BR chown (2)
+for
 version details
 T}
 \fBchown32\fP(2)	2.4
@@ -398,7 +399,8 @@ .SS System call list
 \fBlandlock_create_ruleset\fP(2)	5.13
 \fBlandlock_restrict_self\fP(2)	5.13
 \fBlchown\fP(2)	1.0	T{
-See \fBchown\fP(2) for
+See .BR chown (2)
+for
 version details
 T}
 \fBlchown32\fP(2)	2.4
@@ -679,7 +681,8 @@ .SS System call list
 \fBsetns\fP(2)	3.0
 \fBsetpgid\fP(2)	1.0
 \fBsetpgrp\fP(2)	2.0	T{
-Alternative name for \fBsetpgid\fP(2) on Alpha
+Alternative name for .BR setpgid (2)
+on Alpha
 T}
 \fBsetpriority\fP(2)	1.0
 \fBsetregid\fP(2)	1.0
-- 
2.30.2


[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: [PATCH 1/3] man2/syscalls.2: srcfix (1/3)

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 2151 bytes --]

Hi Branden,

On Fri, Apr 26, 2024 at 04:44:03PM -0500, G. Branden Robinson wrote:
> Migrate table entries from using font selection escape sequences to font
> alternation macros to set man page cross references.
> 
> This change was automatically driven by the following sed(1) script.
> 
> $ cat pre-MR-migrate-cross-references-1.sed
> /^\.\\"/b
> /^\\fB[^\\]*\\fP([0-9][^\]*).*T{/s/\\fB\([^\\]*\)\\fP(\([0-9][^\]*\))\(.*\)/T{\
> .BR \1 (\2)\
> T}\3/

Are you sure?  I tried running it, but got a different diff.

> 
> Signed-off-by: "G. Branden Robinson" <g.branden.robinson@gmail.com>
> 
> ---
>  man2/syscalls.2 | 9 ++++++---
>  1 file changed, 6 insertions(+), 3 deletions(-)
> 
> diff --git a/man2/syscalls.2 b/man2/syscalls.2
> index 7a7d6d730..979dba538 100644
> --- a/man2/syscalls.2
> +++ b/man2/syscalls.2
> @@ -187,7 +187,8 @@ .SS System call list
>  \fBchdir\fP(2)	1.0
>  \fBchmod\fP(2)	1.0
>  \fBchown\fP(2)	2.2	T{
> -See \fBchown\fP(2) for
> +See .BR chown (2)
> +for
>  version details
>  T}
>  \fBchown32\fP(2)	2.4

I see the following, after applying this script:

	$ git diff | head -n30
	diff --git a/man2/syscalls.2 b/man2/syscalls.2
	index 7a7d6d730..278fa3361 100644
	--- a/man2/syscalls.2
	+++ b/man2/syscalls.2
	@@ -146,7 +146,9 @@ .SS System call list
	 \fB_llseek\fP(2)	1.2
	 \fB_newselect\fP(2)	2.0
	 \fB_sysctl\fP(2)	2.0	Removed in 5.5
	-\fBaccept\fP(2)	2.0	T{
	+T{
	+.BR accept (2)
	+T}	2.0	T{
	 See notes on \fBsocketcall\fP(2)
	 T}
	 \fBaccept4\fP(2)	2.6.28
	@@ -162,22 +164,30 @@ .SS System call list
	 .\" 91e040a79df73d371f70792f30380d4e44805250
	 \fBarc_usr_cmpxchg\fP(2)	4.9	ARC only
	 .\" x86: 79170fda313ed5be2394f87aa2a00d597f8ed4a1
	-\fBarch_prctl\fP(2)	2.6	T{
	+T{
	+.BR arch_prctl (2)
	+T}	2.6	T{
	 x86_64, x86 since 4.12
	 T}
	 .\" 9674cdc74d63f346870943ef966a034f8c71ee57
	 \fBatomic_barrier\fP(2)	2.6.34	m68k only
	 \fBatomic_cmpxchg_32\fP(2)	2.6.34	m68k only
	-\fBbdflush\fP(2)	1.2	T{
	+T{

Did you maybe apply the scripts in a different order by accident?

Have a lovely ngiht!
Alex

-- 
<https://www.alejandro-colomar.es/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]

Re: [PATCH 1/3] man2/syscalls.2: srcfix (1/3)

[G. Branden Robinson]

[-- Attachment #1: Type: text/plain, Size: 841 bytes --]

Hi Alex,

At 2024-04-27T00:27:31+0200, Alejandro Colomar wrote:
> On Fri, Apr 26, 2024 at 04:44:03PM -0500, G. Branden Robinson wrote:
> > Migrate table entries from using font selection escape sequences to
> > font alternation macros to set man page cross references.
> > 
> > This change was automatically driven by the following sed(1) script.
> > 
> > $ cat pre-MR-migrate-cross-references-1.sed
> > /^\.\\"/b
> > /^\\fB[^\\]*\\fP([0-9][^\]*).*T{/s/\\fB\([^\\]*\)\\fP(\([0-9][^\]*\))\(.*\)/T{\
> > .BR \1 (\2)\
> > T}\3/
> 
> Are you sure?  I tried running it, but got a different diff.

You're right.  I was switching between two branches in my working copy
and managed to confuse myself.

So that was a failure to launch.  :-/

Okay, I'll be back with a v3, and will triple-check this time.

Regards,
Branden

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]