Skip to contentSkip to conversation

man2/syscalls.2: srcfix (1/3)

PATCH In review G. Branden Robinson 2 participants 3 messages Apr 26, 2024 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

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

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/
---
 man2/syscalls.2 | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)
man2/syscalls.2 +6 -3
index 7a7d6d730..979dba538 100644
@@ -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
Signature · 1 line
2.30.2
#1 lore raw

Hi Branden,

Quoted 10 lines · G. Branden Robinson

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.

Quoted 12 lines
---
 man2/syscalls.2 | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)
man2/syscalls.2 +0 -0
index 7a7d6d730..979dba538 100644

man2/syscalls.2 .SS System call list · line 194

Quoted 9 lines
man2/syscalls.2 +2 -1
@@ -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

Signature · 1 line
<https://www.alejandro-colomar.es/>
#2 lore raw

Hi Alex,

Quoted 6 lines · Alejandro Colomar
Quoted 5 lines · G. Branden Robinson

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.

Quoted 7 lines
Quoted 5 lines
$ 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