Hello Helge,

On 8/17/21 3:51 PM, Helge Kreutzmann wrote:

Hello Michael,
On Mon, Jul 26, 2021 at 01:02:10AM +0200, Michael Kerrisk (man-pages) wrote:

quoted

quoted

Man page: shmop.2
Issue: file → files

"The following header file is included by the \"reader\" and \"writer\" "
"programs."

The existing text looks correct to me. Please let me know further
details if you still think there's a problem after reviewing.

Probably we do not understand the sentence correctly, so bear with me.
Currently, the man page reads as follows:

   Program source: svshm_string.h
       The following header file is included by the "reader" and "writer" programs.

           #include <sys/types.h>
           #include <sys/ipc.h>
           #include <sys/shm.h>
           #include <sys/sem.h>
           #include <stdio.h>
           #include <stdlib.h>
           #include <string.h>

           #define errExit(msg)    do { perror(msg); exit(EXIT_FAILURE); \
                                   } while (0)

The sentence in question seems to refer to the next paragraph, i.e.
the beginning of the program source. There 7 header files (from
types.h up to string.h) are mentioned. In the translation we also
replaced the full stop by a colon. Since there are 7 header files, we
assume that it needs to be plural.

Now explaining this and reading it again, I think I understand the
sentence now (better). The header file is "svshm_string.h" and thus
singular. So logically (but it does not work in the overall formatting
of the man page), the first two lines above would need to be read in a
different order. 

       The following header file is included by the "reader" and "writer" programs.
   Program source: svshm_string.h

If this interpetation is correct, maybe the following change could be
made:

   Program source: svshm_string.h
       This header file is included by the "reader" and "writer" programs:
       ~~~~~~~~~~                                                       ~~

Once I've your confirmation, I'll align the translation.

Thanks for the clarification. I have applied the following patch.

Cheers,

Michael

diff --git a/man2/shmop.2 b/man2/shmop.2
index c9bd92986..2cc49933c 100644
--- a/man2/shmop.2
+++ b/man2/shmop.2

@@ -324,10 +324,14 @@ Hello, world
 .in
 .\"
 .SS Program source: svshm_string.h
-The following header file is included by the "reader" and "writer" programs.
+The following header file is included by the "reader" and "writer" programs:
 .PP
 .in +4n
 .EX
+/* svshm_string.h
+
+   Licensed under GNU General Public License v2 or later.
+*/
 #include <sys/types.h>
 #include <sys/ipc.h>
 #include <sys/shm.h>

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/