3 # Copyright (C) 2002, 2003 Free Software Foundation, Inc.
5 # This program is free software; you can redistribute it and/or modify
6 # it under the terms of the GNU General Public License as published by
7 # the Free Software Foundation; either version 2, or (at your option)
10 # This program is distributed in the hope that it will be useful,
11 # but WITHOUT ANY WARRANTY; without even the implied warranty of
12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 # GNU General Public License for more details.
15 # You should have received a copy of the GNU General Public License
16 # along with this program; if not, write to the Free Software
17 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
20 # Usage: MODULES.html.sh > MODULES.html
22 # Extend the PATH so that gnulib-tool is found.
23 PATH=`dirname "$0"`:$PATH; export PATH
25 POSIX2001_URL='http://www.opengroup.org/onlinepubs/007904975/'
28 POSIX2001_URL='file:/packages/www/www.opengroup.org/susv3/' ;;
33 sed_escape_dot='s,\.,\\.,g'
34 sed_escape_slash='s,/,\\/,g'
37 sed_alt2='s,^\\|,\\(,'
38 sed_alt3='s,\\|\\|$,\\),'
124 ' | sed -e "$sed_alt1" | tr -d "$trnl" | sed -e "$sed_alt2" -e "$sed_alt3"`
125 posix_functions=`echo '
723 posix_spawn_file_actions_addclose
724 posix_spawn_file_actions_adddup2
725 posix_spawn_file_actions_addopen
726 posix_spawn_file_actions_destroy
727 posix_spawn_file_actions_init
728 posix_spawnattr_destroy
729 posix_spawnattr_getflags
730 posix_spawnattr_getpgroup
731 posix_spawnattr_getschedparam
732 posix_spawnattr_getschedpolicy
733 posix_spawnattr_getsigdefault
734 posix_spawnattr_getsigmask
736 posix_spawnattr_setflags
737 posix_spawnattr_setpgroup
738 posix_spawnattr_setschedparam
739 posix_spawnattr_setschedpolicy
740 posix_spawnattr_setsigdefault
741 posix_spawnattr_setsigmask
743 posix_trace_attr_destroy
744 posix_trace_attr_getclockres
745 posix_trace_attr_getcreatetime
746 posix_trace_attr_getgenversion
747 posix_trace_attr_getinherited
748 posix_trace_attr_getlogfullpolicy
749 posix_trace_attr_getlogsize
750 posix_trace_attr_getmaxdatasize
751 posix_trace_attr_getmaxsystemeventsize
752 posix_trace_attr_getmaxusereventsize
753 posix_trace_attr_getname
754 posix_trace_attr_getstreamfullpolicy
755 posix_trace_attr_getstreamsize
756 posix_trace_attr_init
757 posix_trace_attr_setinherited
758 posix_trace_attr_setlogfullpolicy
759 posix_trace_attr_setlogsize
760 posix_trace_attr_setmaxdatasize
761 posix_trace_attr_setname
762 posix_trace_attr_setstreamfullpolicy
763 posix_trace_attr_setstreamsize
767 posix_trace_create_withlog
769 posix_trace_eventid_equal
770 posix_trace_eventid_get_name
771 posix_trace_eventid_open
772 posix_trace_eventset_add
773 posix_trace_eventset_del
774 posix_trace_eventset_empty
775 posix_trace_eventset_fill
776 posix_trace_eventset_ismember
777 posix_trace_eventtypelist_getnext_id
778 posix_trace_eventtypelist_rewind
781 posix_trace_get_filter
782 posix_trace_get_status
783 posix_trace_getnext_event
786 posix_trace_set_filter
790 posix_trace_timedgetnext_event
791 posix_trace_trid_eventid_open
792 posix_trace_trygetnext_event
793 posix_typed_mem_get_info
803 pthread_attr_getdetachstate
804 pthread_attr_getguardsize
805 pthread_attr_getinheritsched
806 pthread_attr_getschedparam
807 pthread_attr_getschedpolicy
808 pthread_attr_getscope
809 pthread_attr_getstack
810 pthread_attr_getstackaddr
811 pthread_attr_getstacksize
813 pthread_attr_setdetachstate
814 pthread_attr_setguardsize
815 pthread_attr_setinheritsched
816 pthread_attr_setschedparam
817 pthread_attr_setschedpolicy
818 pthread_attr_setscope
819 pthread_attr_setstack
820 pthread_attr_setstackaddr
821 pthread_attr_setstacksize
822 pthread_barrier_destroy
825 pthread_barrierattr_destroy
826 pthread_barrierattr_getpshared
827 pthread_barrierattr_init
828 pthread_barrierattr_setpshared
832 pthread_cond_broadcast
836 pthread_cond_timedwait
838 pthread_condattr_destroy
839 pthread_condattr_getclock
840 pthread_condattr_getpshared
841 pthread_condattr_init
842 pthread_condattr_setclock
843 pthread_condattr_setpshared
848 pthread_getconcurrency
849 pthread_getcpuclockid
850 pthread_getschedparam
856 pthread_mutex_destroy
857 pthread_mutex_getprioceiling
860 pthread_mutex_setprioceiling
861 pthread_mutex_timedlock
862 pthread_mutex_trylock
864 pthread_mutexattr_destroy
865 pthread_mutexattr_getprioceiling
866 pthread_mutexattr_getprotocol
867 pthread_mutexattr_getpshared
868 pthread_mutexattr_gettype
869 pthread_mutexattr_init
870 pthread_mutexattr_setprioceiling
871 pthread_mutexattr_setprotocol
872 pthread_mutexattr_setpshared
873 pthread_mutexattr_settype
875 pthread_rwlock_destroy
877 pthread_rwlock_rdlock
878 pthread_rwlock_timedrdlock
879 pthread_rwlock_timedwrlock
880 pthread_rwlock_tryrdlock
881 pthread_rwlock_trywrlock
882 pthread_rwlock_unlock
883 pthread_rwlock_wrlock
884 pthread_rwlockattr_destroy
885 pthread_rwlockattr_getpshared
886 pthread_rwlockattr_init
887 pthread_rwlockattr_setpshared
889 pthread_setcancelstate
890 pthread_setcanceltype
891 pthread_setconcurrency
892 pthread_setschedparam
961 sched_get_priority_max
964 sched_rr_get_interval
1243 ' | sed -e "$sed_alt1" | tr -d "$trnl" | sed -e "$sed_alt2" -e "$sed_alt3"`
1246 missed_modules=`gnulib-tool --list`
1247 missed_files=`ls -d lib/* m4/* | sed -e /CVS/d -e /README/d -e /ChangeLog/d -e /Makefile/d -e /TODO/d -e '/~$/d'`
1250 # outputs line with indentation.
1257 # increases the indentation.
1264 # decreases the indentation.
1267 indent=`echo "$indent" | sed -e 's/ $//'`
1270 # func_begin tag [attribute...]
1279 # closes a HTML tag.
1286 # func_wrap tag [attribute...]
1287 # encloses $element in a HTML tag, without line breaks.
1290 element="<$*>${element}</$1>"
1293 # func_section_wrap sectiontag
1294 # encloses $element in a HTML tag referring to the given tag.
1295 func_section_wrap ()
1297 if test -n "$in_toc"; then
1298 func_wrap A "HREF=\"#$1\""
1300 func_wrap A "NAME=\"$1\""
1308 if test -z "$in_toc"; then
1310 func_echo "<TH ALIGN=LEFT>modules/"
1311 func_echo "<TH ALIGN=LEFT>lib/"
1312 func_echo "<TH ALIGN=LEFT>lib/"
1313 func_echo "<TH ALIGN=LEFT>m4/"
1314 func_echo "<TH ALIGN=LEFT> "
1317 func_echo "<TH ALIGN=LEFT>Module"
1318 func_echo "<TH ALIGN=LEFT>Header"
1319 func_echo "<TH ALIGN=LEFT>Implementation"
1320 func_echo "<TH ALIGN=LEFT>Autoconf macro"
1321 func_echo "<TH ALIGN=LEFT>Depends on"
1326 # func_module module
1329 sed_remove_trailing_empty_line='${
1333 if test -n "$in_toc"; then
1335 func_begin TR "WIDTH=\"100%\""
1337 element='<A HREF="#module='$1'">'$1'</A>'
1338 func_echo "<TD ALIGN=LEFT VALIGN=TOP WIDTH=\"20%\">$element"
1340 element=`gnulib-tool --extract-description $1 | sed -e "$sed_lt" -e "$sed_gt" -e "$sed_remove_trailing_empty_line" | sed -e 's,^, ,' | sed -e 's,\([^a-zA-Z]\)'"${posix_functions}"'(),\1<A HREF="'"$POSIX2001_URL"'functions/\2.html">\2</A>(),g' | sed -e 's,^ ,,'`
1341 func_echo "<TD ALIGN=LEFT VALIGN=TOP WIDTH=\"80%\">$element"
1349 element='<A NAME="module='$1'"></A><A HREF="modules/'$1'">'$1'</A>'
1350 func_echo "<TD ALIGN=LEFT VALIGN=TOP>$element"
1352 element=`gnulib-tool --extract-include-directive $1 | sed -e "$sed_lt" -e "$sed_gt" -e "$sed_remove_trailing_empty_line" | sed -e 's,^#include "\(.*\)"$,#include "<A HREF="lib/\1">\1</A>",' -e 's,^#include <'"${posix_headers}"'\.h>$,#include \<<A HREF="'"$POSIX2001_URL"'basedefs/\1.h.html">\1.h</A>\>,' | sed -e 's/$/<BR>/' | tr -d "$trnl" | sed -e 's/<BR>$//'`
1353 test -n "$element" || element='---'
1354 func_echo "<TD ALIGN=LEFT VALIGN=TOP>$element"
1356 sed_choose_unconditional_nonstandard_include='s,^#include "\(.*\)"$,\1,p'
1357 includefile=`gnulib-tool --extract-include-directive $1 | sed -n -e "$sed_choose_unconditional_nonstandard_include" | sed -e "$sed_escape_dot" | tr -d "$trnl"`
1358 sed_choose_lib_files='s,^lib/\(.*\)$,\1,p'
1359 element=`gnulib-tool --extract-filelist $1 | sed -e '/^$/d' | sed -n -e "$sed_choose_lib_files" | sed -e '/^'"${includefile}"'$/d' | sed -e 's,^\(.*\)$,<A HREF="lib/\1">\1</A>,' | sed -e 's/$/<BR>/' | tr -d "$trnl" | sed -e 's/<BR>$//'`
1360 test -n "$element" || element='---'
1361 func_echo "<TD ALIGN=LEFT VALIGN=TOP>$element"
1363 sed_choose_m4_files='s,^m4/\(.*\)$,\1,p'
1364 element=`(gnulib-tool --extract-filelist $1 | sed -e "$sed_remove_trailing_empty_line" | sed -n -e "$sed_choose_m4_files" | sed -e '/^onceonly/d' | sed -e 's,^\(.*\)$,<A HREF="m4/\1">\1</A>,'; gnulib-tool --extract-autoconf-snippet $1 | sed -e "$sed_remove_trailing_empty_line") | sed -e 's/$/<BR>/' | tr -d "$trnl" | sed -e 's/<BR>$//'`
1365 test -n "$element" || element='---'
1366 func_echo "<TD ALIGN=LEFT VALIGN=TOP>$element"
1368 element=`gnulib-tool --extract-dependencies $1 | sed -e "$sed_remove_trailing_empty_line" | sed -e 's/$/<BR>/' | tr -d "$trnl" | sed -e 's/<BR>$//'`
1369 test -n "$element" || element='---'
1370 func_echo "<TD ALIGN=LEFT VALIGN=TOP>$element"
1374 missed_modules=`echo "$missed_modules" | sed -e '/^'"$1"'$/d'`
1376 files=`gnulib-tool --extract-filelist $1`
1377 sed_removal_prefix='s,^,/^,'
1378 sed_removal_suffix='s,$,\$/d,'
1379 sed_remove_files=`echo '{'; for file in $files; do echo $file | sed -e "$sed_escape_dot" -e "$sed_escape_slash" | sed -e "$sed_removal_prefix" -e "$sed_removal_suffix"; done; echo '}'`
1380 missed_files=`echo "$missed_files" | sed -e "$sed_remove_files"`
1394 element="Support for systems lacking ANSI C 89"
1395 func_section_wrap ansic_sup
1397 func_echo "$element"
1415 func_module strerror
1419 func_echo 'These modules are not listed among dependencies below, for simplicity.'
1421 element="Enhancements for ANSI C 89 functions"
1422 func_section_wrap ansic_enh
1424 func_echo "$element"
1426 element="Memory management functions <stdlib.h>"
1427 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1428 func_section_wrap ansic_enh_stdlib_memory
1430 func_echo "$element"
1437 element="Date and time <time.h>"
1438 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1439 func_section_wrap ansic_enh_time_datetime
1441 func_echo "$element"
1444 func_module strftime
1447 element="Extra functions based on ANSI C 89"
1448 func_section_wrap ansic_ext
1450 func_echo "$element"
1452 element="Memory management functions <stdlib.h>"
1453 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1454 func_section_wrap ansic_ext_stdlib_memory
1456 func_echo "$element"
1463 element="Integer arithmetic functions <stdlib.h>"
1464 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1465 func_section_wrap ansic_ext_stdlib_arith
1467 func_echo "$element"
1474 element="Environment variables <stdlib.h>"
1475 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1476 func_section_wrap ansic_ext_stdlib_env
1478 func_echo "$element"
1486 element="Character handling <ctype.h>"
1487 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1488 func_section_wrap ansic_ext_ctype
1490 func_echo "$element"
1496 element="String handling <string.h>"
1497 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1498 func_section_wrap ansic_ext_string
1500 func_echo "$element"
1509 func_module strchrnul
1513 #func_module fstrcmp
1516 element="Numeric conversion functions <stdlib.h>"
1517 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1518 func_section_wrap ansic_ext_stdlib_conv
1520 func_echo "$element"
1527 element="Date and time <time.h>"
1528 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1529 func_section_wrap ansic_ext_time_datetime
1531 func_echo "$element"
1537 element="Input/Output <stdio.h>"
1538 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1539 func_section_wrap ansic_ext_stdio
1541 func_echo "$element"
1544 func_module unlocked-io
1545 func_module vasnprintf
1546 func_module vasprintf
1549 element="Command-line arguments"
1550 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1551 func_section_wrap ansic_ext_argv
1553 func_echo "$element"
1556 func_module argmatch
1557 func_module version-etc
1558 func_module long-options
1561 element="Cryptographic computations"
1562 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1563 func_section_wrap ansic_ext_crypto
1565 func_echo "$element"
1573 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1574 func_section_wrap ansic_ext_misc
1576 func_echo "$element"
1581 func_module getnline
1582 func_module getndelim2
1583 func_module linebuffer
1585 func_module hash-pjw
1587 func_module readtokens
1588 func_module strverscmp
1591 element="Support for systems lacking ISO C 99"
1592 func_section_wrap isoc_sup
1594 func_echo "$element"
1597 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1598 func_section_wrap isoc_sup_keywords
1600 func_echo "$element"
1603 func_module restrict
1606 element="Boolean type and values <stdbool.h>"
1607 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1608 func_section_wrap isoc_sup_stdbool
1610 func_echo "$element"
1616 element="Numeric conversion functions <stdlib.h>"
1617 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1618 func_section_wrap isoc_sup_stdlib_conv
1620 func_echo "$element"
1624 func_module strtoull
1627 element="Functions for greatest-width integer types <inttypes.h>"
1628 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1629 func_section_wrap isoc_sup_inttypes
1631 func_echo "$element"
1634 func_module strtoimax
1635 func_module strtoumax
1638 element="Mathematics <math.h>"
1639 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1640 func_section_wrap isoc_sup_math
1642 func_echo "$element"
1648 element="Enhancements for ISO C 99 functions"
1649 func_section_wrap isoc_enh
1651 func_echo "$element"
1656 element="Extra functions based on ISO C 99"
1657 func_section_wrap isoc_ext
1659 func_echo "$element"
1661 element="Numeric conversion functions <stdlib.h>"
1662 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1663 func_section_wrap isoc_ext_stdlib_conv
1665 func_echo "$element"
1668 func_module xstrtoimax
1669 func_module xstrtoumax
1672 element="Support for systems lacking POSIX:2001"
1673 func_section_wrap posix_sup
1675 func_echo "$element"
1680 func_module ftruncate
1681 func_module getgroups
1682 func_module gettimeofday
1687 func_module readlink
1690 func_module timespec
1691 func_module nanosleep
1698 element="Enhancements for POSIX:2001 functions"
1699 func_section_wrap posix_enh
1701 func_echo "$element"
1706 func_module unistd-safer
1708 func_module fnmatch-posix
1709 func_module fnmatch-gnu
1713 element="Extra functions based on POSIX:2001"
1714 func_section_wrap posix_ext
1716 func_echo "$element"
1718 element="Numeric conversion functions"
1719 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1720 func_section_wrap posix_ext_conv
1722 func_echo "$element"
1728 element="File system functions"
1729 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1730 func_section_wrap posix_ext_filesys
1732 func_echo "$element"
1736 func_module backupfile
1737 func_module copy-file
1740 func_module euidaccess
1741 func_module file-type
1742 func_module fileblocks
1743 func_module filemode
1746 func_module makepath
1747 func_module modechange
1748 func_module mountlist
1749 func_module path-concat
1750 func_module pathname
1753 func_module save-cwd
1756 func_module xreadlink
1759 element="File descriptor based Input/Output"
1760 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1761 func_section_wrap posix_ext_filedesc
1763 func_echo "$element"
1766 func_module safe-read
1767 func_module safe-write
1768 func_module full-read
1769 func_module full-write
1770 func_module binary-io
1773 element="File stream based Input/Output"
1774 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1775 func_section_wrap posix_ext_filestream
1777 func_echo "$element"
1780 func_module fpending
1781 func_module closeout
1782 func_module stdio-safer
1784 func_module getpass-gnu
1787 element="Users and groups"
1788 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1789 func_section_wrap posix_ext_uidgid
1791 func_echo "$element"
1794 func_module getugroups
1795 func_module group-member
1797 func_module userspec
1800 element="Date and time"
1801 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1802 func_section_wrap posix_ext_datetime
1804 func_echo "$element"
1812 element="Networking functions"
1813 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1814 func_section_wrap posix_ext_net
1816 func_echo "$element"
1819 func_module gethostname
1820 func_module xgethostname
1821 func_module canon-host
1824 element="Internationalization functions"
1825 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1826 func_section_wrap posix_ext_i18n
1828 func_echo "$element"
1833 func_module localcharset
1834 func_module hard-locale
1835 func_module mbswidth
1836 func_module memcasecmp
1838 func_module xmemcoll
1839 func_module unicodeio
1842 func_module ucs4-utf8
1843 func_module ucs4-utf16
1844 func_module utf8-ucs4
1845 func_module utf16-ucs4
1846 func_module linebreak
1849 element="Executing programs"
1850 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1851 func_section_wrap posix_ext_exec
1853 func_echo "$element"
1856 func_module findprog
1857 #func_module wait-process
1858 #func_module execute
1860 #func_module sh-quote
1864 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1865 func_section_wrap posix_ext_java
1867 func_echo "$element"
1870 #func_module classpath
1871 #func_module javacomp
1872 #func_module javaexec
1877 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1878 func_section_wrap posix_ext_misc
1880 func_echo "$element"
1884 func_module exitfail
1887 func_module extensions
1889 func_module getloadavg
1890 func_module getpagesize
1891 func_module getusershell
1892 func_module gnu-source
1894 func_module posixver
1895 func_module quotearg
1897 func_module readutmp
1899 func_module sysexits
1904 echo '<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">'
1909 element="Gnulib Module List"
1911 func_echo "$element"
1913 modules=`gnulib-tool --list`
1914 modules=`for m in $modules; do printf "%s, " $m; done | sed -e 's/, $//'`
1915 func_echo '<META NAME="keywords" CONTENT="'"${modules}"'">'
1921 element="Gnulib Module List"
1923 func_echo "$element"
1925 func_echo 'This is a list of the modules which make up gnulib, with dependencies.'
1933 if test -n "$missed_modules"; then
1935 element="Unclassified modules - please update MODULES.html.sh"
1936 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1938 func_echo "$element"
1941 for module in $missed_modules; do
1948 if test -n "$missed_files"; then
1950 element="Lone files - please create new modules containing them"
1951 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1953 func_echo "$element"
1956 echo "$missed_files" | sed -e 's,^\(.*\)$,<A HREF="\1">\1</A>,'
1961 element="Future developments"
1962 element=`printf "%s" "$element" | sed -e "$sed_lt" -e "$sed_gt"`
1964 func_echo "$element"
1966 func_echo 'Ideally a module could consist of:'
1968 func_echo '<LI>A header file: lib/<VAR>module</VAR>.h'
1969 func_echo '<LI>One or more implementation files: lib/<VAR>module</VAR>.c et al.'
1970 func_echo '<LI>One or more autoconf macro files: m4/<VAR>module</VAR>.m4 et al.'
1971 func_echo '<LI>A configure.ac fragment, Makefile.am fragment, dependency list: modules/<VAR>module</VAR>'
1972 func_echo '<LI>Some documentation'
1973 func_echo '<LI>A POT file and some PO files'
1974 func_echo '<LI>A testsuite'
1978 func_echo 'Generated from <CODE>MODULES.html.sh</CODE> on '`LC_ALL=C date +"%e %B %Y"`.
projects / gnulib.git / blob