[2299] in testers
Something is wrong with some of the manual pages...
daemon@ATHENA.MIT.EDU (wchuang@Athena.MIT.EDU)
Sat Jul 31 15:59:35 1993
From: wchuang@Athena.MIT.EDU
Date: Sat, 31 Jul 93 15:59:26 -0400
To: testers@Athena.MIT.EDU
On the DECstations (Dec5000/133, probably for all the others too)
running 7.6C), I get some odd behavior:
Try typing:
athena% man 3 exp
or
athena% man 3 string
Paging down through the manual page for "string" gets me:
> The arguments s1, s2, and s point to strings (arrays of
> characters terminated by a null character). The functions
> and subroutines all alter s1. These functions do not check
> for overflow of the array pointed to by s1.
>
> The subroutine appends a copy of string s2 to the end of
> string s1. The subroutine copies at most n characters.
> Both return a pointer to the null-terminated result.
>
> The subroutine compares its arguments and returns an integer
> greater than, equal to, or less than 0, according as s1 is
> lexicographically greater than, equal to, or less than s2.
> The subroutine makes the same comparison but looks at at
> most n characters. The and subroutines are identical in
> function, but are case insensitive. The returned lexico-
> graphic difference reflects a conversion to lower-case.
and further down...
> The ( ) function returns a pointer to the first (last)
> occurrence of character c in string s, or a NULL pointer is
> c does not occur in the string. The null character ter-
> minating a string is considered to be part of the string.
>
> The subroutine returns a pointer to the first occurrence in
> string s1 of any character from string s2, or a NULL pointer
> if no character from s2 exists in s1.
>
> The ( ) subroutine returns the length of the initial segment
> of string s1 which consists entirely of characters from (not
> from) string s2.
Obviously something is missing. For comparison, if I do:
athena% nroff -man /usr/man/man3/string.3 | more
I get the correct output:
> The arguments s1, s2, and s point to strings (arrays of characters ter-
> minated by a null character). The functions strcat, strncat, strcpy,
> and strncpy subroutines all alter s1. These functions do not check for
> overflow of the array pointed to by s1.
>
> The strcat subroutine appends a copy of string s2 to the end of string
> s1. The strncat subroutine copies at most n characters. Both return a
> pointer to the null-terminated result.
>
> The strcmp subroutine compares its arguments and returns an integer
> greater than, equal to, or less than 0, according as s1 is lexicographi-
> cally greater than, equal to, or less than s2. The strncmp subroutine
> makes the same comparison but looks at at most n characters. The
> strcasecmp and strncasecmp subroutines are identical in function, but
> are case insensitive. The returned lexicographic difference reflects a
> conversion to lower-case.
and:
> The strchr ( strrchr ) function returns a pointer to the first (last)
> occurrence of character c in string s, or a NULL pointer is c does not
> occur in the string. The null character terminating a string is con-
> sidered to be part of the string.
>
> The strpbrk subroutine returns a pointer to the first occurrence in
> string s1 of any character from string s2, or a NULL pointer if no char-
> acter from s2 exists in s1.
>
> The strspn ( strcspn ) subroutine returns the length of the initial seg-
> ment of string s1 which consists entirely of characters from (not from)
> string s2.
For more information:
navigator% where man
/usr/athena/bin/man
/usr/ucb/man
/usr/bin/man
navigator% where more
/usr/athena/bin/more
/usr/ucb/more
navigator% echo $PAGER
PAGER: Undefined variable.
navigator% where nroff
/usr/bin/nroff
navigator% echo $MORE
-csd
-William
