string_copying.7: Use real examples with utmp(5)

For the functions that are designed to be used with utmp(5) or similar
APIs, use utmp(5) in the example, which results in a clearer example,
and also more realistic.  It better clarifies how these functions are to
be used.

Signed-off-by: Alejandro Colomar <alx@kernel.org>

diff --git a/man7/string_copying.7 b/man7/string_copying.7
index 6b7bbb2b0d9bc203e11c9a022ba4234104cc9740..a096bf21e3a938491b2c9d9af58489d9be4b1053 100644 (file)
--- a/man7/string_copying.7
+++ b/man7/string_copying.7
@@ -626,33 +626,31 @@ puts(buf);
 .TP
 .BR stpncpy (3)
 .EX
-p = stpncpy(buf, "Hello world!", sizeof(buf));
-if (sizeof(buf) < strlen("Hello world!"))
+p = stpncpy(u->ut_user, "alx", sizeof(u->ut_user));
+if (sizeof(u->ut_user) < strlen("alx"))
     goto toolong;
-len = p \- buf;
-for (size_t i = 0; i < sizeof(buf); i++)
-    putchar(buf[i]);
+len = p \- u->ut_user;
+for (size_t i = 0; i < sizeof(u->ut_user); i++)
+    putchar(u->ut_user[i]);
 .EE
 .\" ----- EXAMPLES :: strncpy(3) --------------------------------------/
 .TP
 .BR strncpy (3)
 .EX
-strncpy(buf, "Hello world!", sizeof(buf));
-if (sizeof(buf) < strlen("Hello world!"))
+strncpy(u->ut_user, "alx", sizeof(u->ut_user));
+if (sizeof(u->ut_user) < strlen("alx"))
     goto toolong;
-len = strnlen(buf, sizeof(buf));
-for (size_t i = 0; i < sizeof(buf); i++)
-    putchar(buf[i]);
+len = strnlen(u->ut_user, sizeof(u->ut_user));
+for (size_t i = 0; i < sizeof(u->ut_user); i++)
+    putchar(u->ut_user[i]);
 .EE
 .\" ----- EXAMPLES :: mempcpy(dst, src, strnlen(src, NITEMS(src))) ----/
 .TP
 .I mempcpy(dst, src, strnlen(src, NITEMS(src)))
 .EX
-char  h[42] = "Hello ";
-char  w[6] = "world!";
+char  buf[NITEMS(u->ut_user)];
 p = buf;
-p = mempcpy(p, h, strnlen(h, NITEMS(h)));
-p = mempcpy(p, w, strnlen(w, NITEMS(w)));
+p = mempcpy(p, u->ut_user, strnlen(u->ut_user, NITEMS(u->ut_user)));
 len = p \- buf;
 printf("%.*s\en", (int) len, buf);
 .EE
@@ -660,11 +658,9 @@ printf("%.*s\en", (int) len, buf);
 .TP
 .I stpcpy(mempcpy(dst, src, strnlen(src, NITEMS(src))), \[dq]\[dq])
 .EX
-char  h[42] = "Hello ";
-char  w[6] = "world!";
+char  buf[NITEMS(u->ut_user) + 1];
 p = buf;
-p = mempcpy(p, h, strnlen(h, NITEMS(h)));
-p = mempcpy(p, w, strnlen(w, NITEMS(w)));
+p = mempcpy(p, u->ut_user, strnlen(u->ut_user, NITEMS(u->ut_user)));
 p = stpcpy(p, "");
 len = p \- buf;
 puts(buf);
@@ -673,11 +669,9 @@ puts(buf);
 .TP
 .BR strncat (3)
 .EX
-char  h[42] = "Hello ";
-char  w[6] = "world!";
+char  buf[NITEMS(u->ut_user) + 1];
 strcpy(buf, "");
-strncat(buf, h, NITEMS(h));
-strncat(buf, w, NITEMS(w));
+strncat(buf, u->ut_user, NITEMS(u->ut_user));
 len = strlen(buf);
 puts(buf);
 .EE