19c19
< static const char rcsid[] = "$Id: ns_samedomain.c,v 1.1.2.2.4.2 2004/03/16 12:34:17 marka Exp $";
---
> static const char rcsid[] = "$Id: ns_samedomain.c,v 1.5.18.1 2005/04/27 05:01:09 sra Exp $";
22c22
< __FBSDID("$FreeBSD: head/lib/libc/nameser/ns_samedomain.c 158787 2006-05-21 11:19:36Z ume $");
---
> __FBSDID("$FreeBSD: head/lib/libc/nameser/ns_samedomain.c 170244 2007-06-03 17:20:27Z ume $");
33,35c33
< /*
< * int
< * ns_samedomain(a, b)
---
> /*%
36a35
> *
38,39c37,39
< * a - the domain whose ancestory is being verified
< * b - the potential ancestor we're checking against
---
> *\li a - the domain whose ancestory is being verified
> *\li b - the potential ancestor we're checking against
> *
41c41,42
< * boolean - is a at or below b?
---
> *\li boolean - is a at or below b?
> *
43c44
< * Trailing dots are first removed from name and domain.
---
> *\li Trailing dots are first removed from name and domain.
47c48
< * "host.foobar.top" lies in "foobar.top" and in "top" and in ""
---
> *\li "host.foobar.top" lies in "foobar.top" and in "top" and in ""
146,148c147
< /*
< * int
< * ns_subdomain(a, b)
---
> /*%
157,159c156
< /*
< * int
< * ns_makecanon(src, dst, dstsize)
---
> /*%
160a158
> *
161a160
> * \code
166a166
> * \endcode
173c173
< if (n + sizeof "." > dstsize) { /* Note: sizeof == 2 */
---
> if (n + sizeof "." > dstsize) { /*%< Note: sizeof == 2 */
178,180c178,180
< while (n >= 1U && dst[n - 1] == '.') /* Ends in "." */
< if (n >= 2U && dst[n - 2] == '\\' && /* Ends in "\." */
< (n < 3U || dst[n - 3] != '\\')) /* But not "\\." */
---
> while (n >= 1U && dst[n - 1] == '.') /*%< Ends in "." */
> if (n >= 2U && dst[n - 2] == '\\' && /*%< Ends in "\." */
> (n < 3U || dst[n - 3] != '\\')) /*%< But not "\\." */
189,191c189
< /*
< * int
< * ns_samename(a, b)
---
> /*%
192a191
> *
194,196c193,195
< * -1 on error
< * 0 if names differ
< * 1 if names are the same
---
> *\li -1 on error
> *\li 0 if names differ
> *\li 1 if names are the same
210a210,211
>
> /*! \file */