Skip to contentSkip to conversation

clone.2: refer to VERSIONS for raw clone prototype

PATCH In review Kir Kolyshkin 2 participants 2 messages Aug 24, 2023 – Aug 25, 2023 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 clone.2: refer to VERSIONS for raw clone prototype

Commit 2a15a76bba35c ("clone.2: Document raw syscall interfaces on various other architectures") adds this note:

	/* For the prototype of the raw system call, see NOTES */

but places the raw syscall prototypes into DESCRIPTION.

Next, commit 1874193ebf07068b ("clone.2: Add NOTES heading") makes the information to appear in NOTES.

Finally, commit 4131356cdab8d ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections") moves the NOTES section (with some but not all of the old contents from NOTES and VERSIONS) down, and thus the raw prototypes are now under VERSIONS.

Fix the comment accordingly.

Cc:

---
 man2/clone.2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
man2/clone.2 +1 -1
index 4a75b557b..73ad5a6fa 100644
@@ -58,7 +58,7 @@ Standard C library
 .BI "                                       void *_Nullable " tls ,
 .BI "                                       pid_t *_Nullable " child_tid " \fR*/\fP );"
 .PP
-/* For the prototype of the raw clone() system call, see NOTES */
+/* For the prototype of the raw clone() system call, see VERSIONS */
 .PP
 .BR "#include <linux/sched.h>" "    /* Definition of " "struct clone_args" " */"
 .BR "#include <sched.h>" "          /* Definition of " CLONE_* " constants */"
Signature · 1 line
2.41.0
#1 lore raw

Hi Kir,

Quoted 10 lines · Kir Kolyshkin

Commit 2a15a76bba35c ("clone.2: Document raw syscall interfaces on various other architectures") adds this note:

	/* For the prototype of the raw system call, see NOTES */

but places the raw syscall prototypes into DESCRIPTION.

Next, commit 1874193ebf07068b ("clone.2: Add NOTES heading") makes the information to appear in NOTES.

Quoted 8 lines

Finally, commit 4131356cdab8d ("man*/, man-pages.7: VERSIONS, STANDARDS,
HISTORY: Reorganize sections") moves the NOTES section (with some but not all of the old contents from NOTES and VERSIONS) down, and thus the raw prototypes are now under VERSIONS.

Fix the comment accordingly.

Cc:

Did you want to CC someone? :)

Quoted 10 lines
---
 man2/clone.2 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
man2/clone.2 +0 -0
index 4a75b557b..73ad5a6fa 100644

man2/clone.2 Standard C library · line 61

Quoted 5 lines
man2/clone.2 +1 -1
@@ -58,7 +58,7 @@ Standard C library
 .BI "                                       void *_Nullable " tls ,
 .BI "                                       pid_t *_Nullable " child_tid " \fR*/\fP );"
 .PP
-/* For the prototype of the raw clone() system call, see NOTES */
+/* For the prototype of the raw clone() system call, see VERSIONS */

LGTM.

Thanks,
Alex

Quoted 3 lines
man2/clone.2 +0 -0
 .PP
 .BR "#include <linux/sched.h>" "    /* Definition of " "struct clone_args" " */"
 .BR "#include <sched.h>" "          /* Definition of " CLONE_* " constants */"
Signature · 2 lines
<http://www.alejandro-colomar.es/>
GPG key fingerprint: A9348594CE31283A826FBDD8D57633D441E25BB5