Re: [PATCH 1/3] strcpy.3: Rewrite page to document all string-copying functions

[Alejandro Colomar]

Hi Branden,

On 12/12/22 15:24, Alejandro Colomar wrote:

+.\" ----- RETURN VALUE :: Deprecated ----------------------------------/
+.SS Deprecated
+The following functions return
+the length of the total string that they tried to create
+(as if truncation didn't occur).
+.IP \(bu 3
+.BR strlcpy (3bsd),
+.BR strlcat (3bsd)
+.PP
+The following function returns
+the length of the destination string, or
+.B \-E2BIG
+on truncation.
+.IP \(bu 3
+.BR strscpy (9)
+.PP
+The following functions return the
+.I dst
+pointer,
+which is useless.
+.PD 0
+.IP \(bu 3
+.BR strcpy (3),
+.BR strcat (3)
+.IP \(bu
+.BR strncpy (3)
+.IP \(bu
+.BR strncat (3)
+.PD

I realized that the above doesn't produce exactly what I wanted.  I wanted this:

       The following functions return the dst pointer, which is useless.

       •  strcpy(3), strcat(3)
       •  strncpy(3)
       •  strncat(3)

But I got this:

       The following functions return the dst pointer, which is useless.
       •  strcpy(3), strcat(3)
       •  strncpy(3)
       •  strncat(3)

I see various possible solutions, but which would you recommend?

I've thought of:

[
[...]
.PP
.PD 0
.IP \(bu 3
[...]
]

or

[
[...]
.IP \(bu 3
.PD 0
[...]
]



Cheers,

Alex


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

I was thinking about your future (I hope) .LS and .LE, and how they would also fit in here.

OpenPGP_signature
Description: OpenPGP digital signature