documented.sh

#!/bin/sh
bindir=$1

VERSION=1.0

egrep -h @deftypefu?nx? *.texi ../linuxthreads/*.texi |
sed -e 's/@deftypefunx*[[:space:]]*\({[^{]*}\|[[:alnum:]_]*\)[[:space:]]*\([[:alnum:]_]*\).*/\2/' -e 's/@deftypefn {[^}]*function}*[[:space:]]*\({[^{]*}\|[[:alnum:]_]*\)[[:space:]]*\([[:alnum:]_]*\).*/\2/' -e '/^@/d' |
sed -e '/^obstack_/d' -e '/^\([lf]\|\)stat\(\|64\)$/d' -e '/^mknod$/d' |
sed -e '/^signbit$/d' -e '/^sigsetjmp$/d' |
sed -e '/^pthread_cleanup/d' -e '/^IFTODT$/d' -e '/^DTTOIF$/d' |
sed -e '/^__fwriting$/d' -e '/^__fwritable$/d' -e '/^__fsetlocking$/d' |
sed -e '/^__freading$/d' -e '/^__freadable$/d' -e '/^__fpurge$/d' |
sed -e '/^__fpending$/d' -e '/^__flbf$/d' -e '/^__fbufsize$/d' |
sed -e '/^alloca$/d' |
sort -u > DOCUMENTED

nm --extern --define $bindir/libc.so $bindir/math/libm.so $bindir/rt/librt.so $bindir/linuxthreads/libpthread.so $bindir/dlfcn/libdl.so $bindir/crypt/libcrypt.so $bindir/login/libutil.so |
egrep " [TW] ([[:alpha:]]|_[[:alpha:]])" |
sed 's/\(@.*\)//' |
cut -b 12- |
sed -e '/^_IO/d' -e '/^_dl/d' -e '/^_pthread/d' -e '/^_obstack/d' |
sed -e '/^_argp/d' -e '/^_authenticate$/d' -e '/^_environ$/d' |
sed -e '/^_errno$/d' -e '/^_h_errno$/d' -e '/^_longjmp$/d' |
sed -e '/^_mcleanup$/d' -e '/^_rpc_dtablesize$/d' -e '/^_seterr_reply$/d' |
sed -e '/^_nss/d' -e '/^_setjmp$/d' |
sort -u > AVAILABLE

cat <<EOF
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<html>
  <head>
    <title>Undocumented glibc functions</title>
  </head>

  <body>
    <center><h1>Undocumented <tt>glibc</tt> functions</h1></center>

    <p>The following table includes names of the function in glibc
    which are not yet documented in the manual.  This list is
    automatically created and therefore might contain errors.  Please
    check the latest manual (available from the CVS archive) before
    starting to work.  It might also be good to let me know in
    advanace on which functions you intend to work to avoid
    duplication.</p>

    <p>A few comments:</p>

    <ul>
      <li>Some functions in the list are much less important than
      others.  Please prioritize.</li>

      <li>Similarly for the LFS functions (those ending in 64).</li>
    </ul>

    <p>The function sombody already volunteered to document are marked
    with a reference to the person.</p>

    <center><table>
EOF

n=0
diff -y --width=60 --suppress-common-lines DOCUMENTED AVAILABLE |
expand | cut -b 33- | sed '/^[[:space:]]*$/d' |
while read name; do
  line="$line
<td><tt>$name</tt></td>"
  n=$(expr $n + 1)
  if [ $n -eq 4 ]; then
    echo "<tr>
$line
</tr>"
    line=""
    n=0
  fi
done
if [ $n -gt 0 ]; then
  if [ $n -eq 1 ]; then
    line="$line
<td></td>"
  fi
  if [ $n -eq 2 ]; then
    line="$line
<td></td>"
  fi
  if [ $n -eq 3 ]; then
    line="$line
<td></td>"
  fi
  echo "<tr>
$line
</tr>"
fi

cat <<EOF
    </table></center>

    <hr>
    <address><a href="mailto:drepper@redhat.com">Ulrich Drepper</a></address>
Generated on $(date) with documented.sh version $VERSION
  </body>
</html>
EOF
	#!/bin/sh
	bindir=$1

	VERSION=1.0

	egrep -h @deftypefu?nx? .texi ../linuxthreads/.texi \|
	sed -e 's/@deftypefunx[[:space:]]\({[^{]}\\|[[:alnum:]_]\)[[:space:]]\([[:alnum:]_]\)./\2/' -e 's/@deftypefn {[^}]function}[[:space:]]\({[^{]}\\|[[:alnum:]_]\)[[:space:]]\([[:alnum:]_]\).*/\2/' -e '/^@/d' \|
	sed -e '/^obstack_/d' -e '/^\([lf]\\|\)stat\(\\|64\)$/d' -e '/^mknod$/d' \|
	sed -e '/^signbit$/d' -e '/^sigsetjmp$/d' \|
	sed -e '/^pthread_cleanup/d' -e '/^IFTODT$/d' -e '/^DTTOIF$/d' \|
	sed -e '/^__fwriting$/d' -e '/^__fwritable$/d' -e '/^__fsetlocking$/d' \|
	sed -e '/^__freading$/d' -e '/^__freadable$/d' -e '/^__fpurge$/d' \|
	sed -e '/^__fpending$/d' -e '/^__flbf$/d' -e '/^__fbufsize$/d' \|
	sed -e '/^alloca$/d' \|
	sort -u > DOCUMENTED

	nm --extern --define $bindir/libc.so $bindir/math/libm.so $bindir/rt/librt.so $bindir/linuxthreads/libpthread.so $bindir/dlfcn/libdl.so $bindir/crypt/libcrypt.so $bindir/login/libutil.so \|
	egrep " [TW] ([[:alpha:]]\|_[[:alpha:]])" \|
	sed 's/\(@.*\)//' \|
	cut -b 12- \|
	sed -e '/^_IO/d' -e '/^_dl/d' -e '/^_pthread/d' -e '/^_obstack/d' \|
	sed -e '/^_argp/d' -e '/^_authenticate$/d' -e '/^_environ$/d' \|
	sed -e '/^_errno$/d' -e '/^_h_errno$/d' -e '/^_longjmp$/d' \|
	sed -e '/^_mcleanup$/d' -e '/^_rpc_dtablesize$/d' -e '/^_seterr_reply$/d' \|
	sed -e '/^_nss/d' -e '/^_setjmp$/d' \|
	sort -u > AVAILABLE

	cat <<EOF
	<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
	<html>
	<head>
	<title>Undocumented glibc functions</title>
	</head>

	<body>
	<center><h1>Undocumented <tt>glibc</tt> functions</h1></center>

	<p>The following table includes names of the function in glibc
	which are not yet documented in the manual. This list is
	automatically created and therefore might contain errors. Please
	check the latest manual (available from the CVS archive) before
	starting to work. It might also be good to let me know in
	advanace on which functions you intend to work to avoid
	duplication.</p>

	<p>A few comments:</p>

	<ul>
	<li>Some functions in the list are much less important than
	others. Please prioritize.</li>

	<li>Similarly for the LFS functions (those ending in 64).</li>
	</ul>

	<p>The function sombody already volunteered to document are marked
	with a reference to the person.</p>

	<center><table>
	EOF

	n=0
	diff -y --width=60 --suppress-common-lines DOCUMENTED AVAILABLE \|
	expand \| cut -b 33- \| sed '/^[[:space:]]*$/d' \|
	while read name; do
	line="$line
	<td><tt>$name</tt></td>"
	n=$(expr $n + 1)
	if [ $n -eq 4 ]; then
	echo "<tr>
	$line
	</tr>"
	line=""
	n=0
	fi
	done
	if [ $n -gt 0 ]; then
	if [ $n -eq 1 ]; then
	line="$line
	<td></td>"
	fi
	if [ $n -eq 2 ]; then
	line="$line
	<td></td>"
	fi
	if [ $n -eq 3 ]; then
	line="$line
	<td></td>"
	fi
	echo "<tr>
	$line
	</tr>"
	fi

	cat <<EOF
	</table></center>

	<hr>
	<address><a href="mailto:drepper@redhat.com">Ulrich Drepper</a></address>
	Generated on $(date) with documented.sh version $VERSION
	</body>
	</html>
	EOF