arch_prctl.2, getpeername.2, getrlimit.2, ioctl_list.2, mmap2.2, mremap.2, sched_setaffinity.2, setup.2, shmop.2, argz_add.3, exec.3, fenv.3, fmtmsg.3, gethostbyname.3, posix_memalign.3, printf.3, scanf.3, sigpause.3, wordexp.3, xdr.3, st.4, tty_ioctl.4: Formatting fix: prevent '*' in declaration or cast wrapping to next line

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

man2/arch_prctl.2

@@ -47,7 +47,7 @@ to it;
 is interpreted as either an
 .I "unsigned long"
 for the "set" operations, or as an
-.IR "unsigned long *" ,
+.IR "unsigned long\ *" ,
 for the "get" operations.
 .LP
 Subfunctions for x86-64 are:

man2/getpeername.2

@@ -106,7 +106,7 @@ function call first appeared in 4.2BSD), POSIX.1-2001.
 The third argument of
 .BR getpeername ()
 is in reality an
-.I int *
+.I "int\ *"
 (and this is what 4.x BSD and libc4 and libc5 have).
 Some POSIX confusion resulted in the present
 .IR socklen_t ,

man2/getrlimit.2

@@ -261,7 +261,7 @@ structure specified as the fourth argument to
 .BR mq_open (3).
 
 The first addend in the formula, which includes
-.I "sizeof(struct msg_msg *)"
+.I "sizeof(struct msg_msg\ *)"
 (4 bytes on Linux/i386), ensures that the user cannot
 create an unlimited number of zero-length messages (such messages
 nevertheless each consume some system memory for bookkeeping overhead).

man2/ioctl_list.2

@@ -39,9 +39,9 @@ For each ioctl, its numerical value, its name, and its argument
 type are given.
 .PP
 An argument type of
-.I const struct foo *
+.I "const struct foo\ *"
 means the argument is input to the kernel.
-.I struct foo *
+.I "struct foo\ *"
 means the kernel outputs the argument.
 If the kernel uses the argument for both input and output, this is
 marked with \fI//\ I-O\fP.
@@ -765,11 +765,11 @@ These are documented here in alphabetical order.
 
 .B CDROMREADAUDIO
 takes an input pointer
-.IR "const struct cdrom_read_audio *" .
+.IR "const struct cdrom_read_audio\ *" .
 The
 .I buf
 field points to an output buffer of length
-.IR "nframes * CD_FRAMESIZE_RAW" .
+.IR "nframes\ * CD_FRAMESIZE_RAW" .
 
 .BR CDROMREADCOOKED ,
 .BR CDROMREADMODE1 ,
@@ -777,7 +777,7 @@ field points to an output buffer of length
 and
 .B CDROMREADRAW
 take an input pointer
-.IR "const struct cdrom_msf *" .
+.IR "const struct cdrom_msf\ *" .
 They use the same pointer as an output pointer to
 .IR "char []" .
 The length varies by request.
@@ -802,7 +802,7 @@ driver uses OPT_BLOCKSIZE instead (both have the numerical value
 and
 .B EQL_SETMASTERCFG
 take a
-.IR "struct ifreq *" .
+.IR "struct ifreq\ *" .
 The
 .I ifr_data
 field is a pointer to another structure as follows:
@@ -818,7 +818,7 @@ field is a pointer to another structure as follows:
 .fi
 .B FDRAWCMD
 takes a
-.IR "struct floppy raw_cmd *" .
+.IR "struct floppy raw_cmd\ *" .
 If
 .I flags & FD_RAW_WRITE
 is nonzero, then
@@ -836,9 +836,9 @@ points to an output buffer of length
 and
 .B PIO_FONTX
 take a
-.I struct console_font_desc *
+.I struct console_font_desc\ *
 or a
-.IR "const struct console_font_desc *" ,
+.IR "const struct console_font_desc\ *" ,
 respectively.
 .I chardata
 points to a buffer of
@@ -852,9 +852,9 @@ and an input buffer for
 and
 .B PIO_UNIMAP
 take a
-.I struct unimapdesc *
+.I "struct unimapdesc\ *"
 or a
-.IR "const struct unimapdesc *" ,
+.IR "const struct unimapdesc\ *" ,
 respectively.
 .I entries
 points to a buffer of
@@ -876,7 +876,7 @@ They are not implemented in the kernel.
 
 .B SCSI_IOCTL_PROBE_HOST
 takes an input pointer
-.IR "const int *" ,
+.IR "const int\ *" ,
 which is a length.
 It uses the same pointer as an output pointer to a
 .I char []
@@ -896,7 +896,7 @@ the protocol:
 .fi
 .B SIOCGIFCONF
 takes a
-.IR "struct ifconf *" .
+.IR "struct ifconf\ *" .
 The
 .I ifc_buf
 field points to a buffer of length
@@ -914,7 +914,7 @@ takes an input pointer whose type depends on the protocol:
 .fi
 .B TIOCLINUX
 takes a
-.IR "const char *" .
+.IR "const char\ *" .
 It uses this to distinguish several
 independent subcases.
 In the table below,

man2/mmap2.2

@@ -65,7 +65,7 @@ Problem with getting the data from user space.
 .TP
 .B EINVAL
 (Various platforms where the page size is not 4096 bytes.)
-.I offset * 4096
+.I "offset\ *\ 4096"
 is not a multiple of the system page size.
 .PP
 .BR mmap2 ()

man2/mremap.2

@@ -101,7 +101,7 @@ flag of
 If this flag is specified, then
 .BR mremap ()
 accepts a fifth argument,
-.IR "void *new_address" ,
+.IR "void\ *new_address" ,
 which specifies a page-aligned address to which the mapping must
 be moved.
 Any previous mapping at the address range specified by

man2/sched_setaffinity.2

@@ -202,7 +202,7 @@ This manual page describes the glibc interface for the CPU affinity calls.
 The actual system call interface is slightly different, with the
 .I mask
 being typed as
-.IR "unsigned long *" ,
+.IR "unsigned long\ *" ,
 reflecting the fact that the underlying implementation of CPU
 sets is a simple bit mask.
 On success, the raw

man2/setup.2

@@ -66,6 +66,6 @@ intended to be portable, or indeed in any programs at all.
 The calling sequence varied: at some times
 .I setup ()
 has had a single argument
-.I "void *BIOS"
+.I "void\ *BIOS"
 and at other times a single argument
 .IR "int magic" .

man2/shmop.2

@@ -234,19 +234,19 @@ SVr4, POSIX.1-2001.
 
 In SVID 3 (or perhaps earlier)
 the type of the \fIshmaddr\fP argument was changed from
-.I "char *"
+.I "char\ *"
 into
-.IR "const void *" ,
+.IR "const void\ *" ,
 and the returned type of
 .BR shmat ()
 from
-.I "char *"
+.I "char\ *"
 into
-.IR "void *" .
+.IR "void\ *" .
 (Linux libc4 and libc5 have the
-.I "char *"
+.I "char\ *"
 prototypes; glibc2 has
-.IR "void *" .)
+.IR "void\ *" .)
 .SH NOTES
 Using
 .BR shmat ()

man3/argz_add.3

@@ -91,9 +91,9 @@ delimiter \(aq:\(aq.
 .LP
 .BR argz_append ()
 appends the argz vector
-.RI ( buf ,\  buf_len )
+.RI ( buf ,\ buf_len )
 after
-.RI ( *argz ,\  *argz_len )
+.RI ( *argz ,\ *argz_len )
 and updates
 .IR *argz
 and
@@ -106,21 +106,21 @@ will be increased by
 .BR argz_count ()
 counts the number of strings, that is,
 the number of null bytes (\(aq\\0\(aq), in
-.RI ( argz ,\  argz_len ).
+.RI ( argz ,\ argz_len ).
 .LP
 .BR argz_create ()
 converts a UNIX-style argument vector
 .IR argv ,
 terminated by
-.IR "(char *) 0" ,
+.IR "(char\ *)\ 0" ,
 into an argz vector
-.RI ( *argz ,\  *argz_len ).
+.RI ( *argz ,\ *argz_len ).
 .LP
 .BR argz_create_sep ()
 converts the null-terminated string
 .I str
 into an argz vector
-.RI ( *argz ,\  *argz_len )
+.RI ( *argz ,\ *argz_len )
 by breaking it up at every occurrence of the separator
 .IR sep .
 .LP
@@ -128,7 +128,7 @@ by breaking it up at every occurrence of the separator
 removes the substring pointed to by
 .I entry
 from the argz vector
-.RI ( *argz ,\  *argz_len )
+.RI ( *argz ,\ *argz_len )
 and updates
 .I *argz
 and
@@ -138,7 +138,7 @@ and
 is the opposite of
 .BR argz_create ().
 It takes the argz vector
-.RI ( argz ,\  argz_len )
+.RI ( argz ,\ argz_len )
 and fills the array starting at
 .I argv
 with pointers to the substrings, and a final NULL,
@@ -157,7 +157,7 @@ It inserts the argument
 at position
 .I before
 into the argz vector
-.RI ( *argz ,\  *argz_len )
+.RI ( *argz ,\ *argz_len )
 and updates
 .I *argz
 and

man3/exec.3

@@ -84,7 +84,7 @@ The initial argument for these functions is the name of a file that is
 to be executed.
 .PP
 The
-.I "const char *arg"
+.I "const char\ *arg"
 and subsequent ellipses in the
 .BR execl (),
 .BR execlp (),
@@ -103,7 +103,7 @@ The list of arguments
 .I must
 be terminated by a NULL
 pointer, and, since these are variadic functions, this pointer must be cast
-.IR "(char *) NULL" .
+.IR "(char\ *) NULL" .
 .PP
 The
 .BR execv (),

man3/fenv.3

@@ -213,7 +213,7 @@ as one opaque object, of type
 The default environment is denoted by
 .B FE_DFL_ENV
 (of type
-.IR "const fenv_t *" ).
+.IR "const fenv_t\ *" ).
 This is the environment setup at program start and it is defined by
 ISO C to have round to nearest, all exceptions cleared and a nonstop
 (continue on exceptions) mode.

man3/fmtmsg.3

@@ -71,7 +71,7 @@ The values
 .BR MM_NULLACT ,
 .B MM_NULLTAG
 are synonyms for
-.IR "((char *) 0)" ,
+.IR "((char\ *)\ 0)" ,
 the empty string, and
 .B MM_NULLSEV
 is a synonym for

man3/gethostbyname.3

@@ -362,7 +362,7 @@ See also
 The BSD prototype for
 .BR gethostbyaddr ()
 uses
-.I const char *
+.I "const char\ *"
 for the first argument.
 .SS System V/POSIX extension
 POSIX requires the

man3/posix_memalign.3

@@ -91,7 +91,7 @@ bytes and places the address of the allocated memory in
 The address of the allocated memory will be a multiple of
 .IR "alignment" ,
 which must be a power of two and a multiple of
-.IR "sizeof(void *)".
+.IR "sizeof(void\ *)" .
 If
 .I size
 is 0, then
@@ -158,7 +158,7 @@ is not set.
 The
 .I alignment
 argument was not a power of two, or was not a multiple of
-.IR "sizeof(void *)" .
+.IR "sizeof(void\ *)" .
 .TP
 .B ENOMEM
 There was insufficient memory to fulfill the allocation request.

man3/printf.3

@@ -727,7 +727,7 @@ resulting multibyte string is written.
 If no
 .B l
 modifier is present: The
-.I "const char *"
+.I "const char\ *"
 argument is expected to be a pointer to an array of character type (pointer
 to a string).
 Characters from the array are written up to (but not
@@ -741,7 +741,7 @@ array, the array must contain a terminating null byte.
 If an
 .B l
 modifier is present: The
-.I "const wchar_t *"
+.I "const wchar_t\ *"
 argument is expected to be a pointer to an array of wide characters.
 Wide characters from the array are converted to multibyte characters
 (each by a call to the
@@ -779,7 +779,7 @@ Don't use.
 .TP
 .B p
 The
-.I "void *"
+.I "void\ *"
 pointer argument is printed in hexadecimal (as if by
 .B %#x
 or
@@ -788,7 +788,7 @@ or
 .B n
 The number of characters written so far is stored into the integer
 indicated by the
-.I "int *"
+.I "int\ *"
 (or variant) pointer argument.
 No argument is converted.
 .TP

man3/scanf.3

@@ -212,7 +212,7 @@ allocates a buffer of sufficient size,
 and assigns the address of this buffer to the corresponding
 .I pointer
 argument, which should be a pointer to a
-.I "char *"
+.I "char\ *"
 variable (this variable does not need to be initialized before the call).
 The caller should subsequently
 .BR free (3)

man3/sigpause.3

@@ -71,7 +71,7 @@ The unfortunate situation with two incompatible functions with the
 same name was solved by the
 .BR \%sigsuspend (2)
 function, that takes a
-.I "sigset_t *"
+.I "sigset_t\ *"
 argument (instead of an
 .IR int ).
 .SS Linux notes

man3/wordexp.3

@@ -62,7 +62,7 @@ that gives the number of words in the expansion of
 The field
 .I we_wordv
 is a
-.I char **
+.I "char\ **"
 that points to the array of words found.
 The field
 .I we_offs

man3/xdr.3

@@ -182,7 +182,7 @@ to a contiguous piece of the stream's buffer;
 .I len
 is the byte length of the desired buffer.
 Note: pointer is cast to
-.IR "long *" .
+.IR "long\ *" .
 .IP
 Warning:
 .BR xdr_inline ()

man4/st.4

@@ -241,7 +241,7 @@ The definitions below are from
 .SS MTIOCTOP \(em perform a tape operation
 .PP
 This request takes an argument of type
-.IR "(struct mtop *)" .
+.IR "(struct mtop\ *)" .
 Not all drives support all operations.
 The driver returns an
 .B EIO
@@ -682,7 +682,7 @@ the masked sense data byte.
 .SS MTIOCGET \(em get status
 .PP
 This request takes an argument of type
-.IR "(struct mtget *)" .
+.IR "(struct mtget\ *)" .
 .PP
 .in +4n
 .nf
@@ -804,7 +804,7 @@ or
 .SS MTIOCPOS \(em get tape position
 .PP
 This request takes an argument of type
-.I "(struct mtpos *)"
+.I "(struct mtpos\ *)"
 and reports the drive's notion of the current tape block number,
 which is not the same as
 .I mt_blkno

man4/tty_ioctl.4

@@ -61,9 +61,9 @@ The following four ioctls are just like
 .BR TCSETSW ,
 .BR TCSETSF ,
 except that they take a
-.I "struct termio *"
+.I "struct termio\ *"
 instead of a
-.IR "struct termios *" .
+.IR "struct termios\ *" .
 .TP
 .BI "TCGETA	struct termio *" argp
 .TP