clean up SGML for latest version of jade/docbook

winsup/cygwin/misc-std.sgml

@@ -5,7 +5,7 @@
 standards:</para>
 
 
-<sect2><title>Networking</title><para>
+<sect2><title>Networking</title>
 
 <para>(Standardized by POSIX 1.g, which is probably still in draft?)</para>
 
@@ -38,6 +38,7 @@ strsignal, strtosigno, swab, syslog, timezone, truncate, ttyslot,
 unlockpt, unsetenv, usleep, utimes, vfork, vhangup, wait3, wait4,
 wcscmp, wcslen, wprintf, writev
 
+</para></sect2>
 <sect2><title>Implementation Notes</title>
 
 <para> <function>initgroups</function> does nothing</para>
@@ -59,7 +60,7 @@ An increment above REALTIME_PRIORITY_CLASS results in the process
 staying at that priority.  Likewise, a decrement to
 IDLE_PRIORITY_CLASS has it stay at that priority.  Note that in the
 Win32 API, there are 32 priorities.  So currently we only give access
-to four of these through <function>nice</function>.
+to four of these through <function>nice</function>.</para>
 
 <para> <function>seteuid</function> and <function>setegid</function>
 always return 0 and set errno to

winsup/cygwin/posix.sgml

@@ -10,27 +10,32 @@ _exit, kill, sigemptyset, sigfillset, sigaddset, sigdelset,
 sigismember, sigaction, pthread_sigmask, sigprocmask, sigpending,
 sigsuspend, alarm, pause, sleep, pthread_kill, pthread_sigmask
 
+</para></sect2>
 <sect2><title>Process Environment (Section 4) </title><para>
 
 getpid, getppid, getuid, geteuid, getgid, getegid, setuid, setgid,
 getgroups, getlogin, getpgrp, setsid, setpgid, uname, time, times,
 getenv, ctermid, ttyname, isatty, sysconf
 
+</para></sect2>
 <sect2><title>Files and Directories (Section 5) </title><para>
 
 opendir, readdir, rewinddir, closedir, chdir, getcwd, open, creat,
 umask, link, mkdir, unlink, rmdir, rename, stat, fstat, access, chmod,
 fchmod, chown, utime, ftruncate, pathconf, fpathconf
 
+</para></sect2>
 <sect2><title>Input and Output Primitives (Section 6) </title><para>
 
 pipe, dup, dup2, close, read, write, fcntl, lseek, fsync
 
+</para></sect2>
 <sect2><title>Device- and Class-Specific Functions (Section 7) </title><para>
 
 cfgetispeed, cfgetospeed, cfsetispeed, cfsetospeed, tcdrain, tcflow,
 tcflush, tcgetattr, tcgetpgrp, tcsendbreak, tcsetattr, tcsetpgrp
 
+</para></sect2>
 <sect2><title>Language-Specific Services for the C Programming Language (Section 8) </title><para>
 
 abort, exit, fclose, fdopen, fflush, fgetc, fgets, fileno, fopen,
@@ -39,32 +44,37 @@ getc, getchar, gets, perror, printf, putc, putchar, puts, remove,
 rewind, scanf, setlocale, siglongjmp, sigsetjmp, tmpfile, tmpnam,
 tzset
 
+</para></sect2>
 <sect2><title>System Databases (Section 9) </title><para>
 
 getgrgid, getgrnam, getpwnam, getpwuid
 
+</para></sect2>
 <sect2><title>Synchronization (Section 11) </title><para>
 
 sem_init, sem_destroy, sem_wait, sem_trywait, sem_post,
 pthread_mutex_init, pthread_mutex_destroy, pthread_mutex_lock,
 pthread_mutex_trylock, pthread_mutex_unlock
 
+</para></sect2>
 <sect2><title>Memory Management (Section 12) </title><para>
 
 mmap, mprotect, msync, munmap
 
+</para></sect2>
 <sect2><title>Thread Management (Section 16) </title><para>
 
 pthread_attr_init, pthread_attr_destroy, pthread_attr_setstacksize,
 pthread_attr_getstacksize, pthread_create, pthread_exit, pthread_self,
 pthread_equal
 
+</para></sect2>
 <sect2><title>Thread-Specific Data Functions (Section 17) </title><para>
 
 pthread_key_create, pthread_setspecific, pthread_getspecific,
 pthread_key_delete
 
-</sect2>
+</para></sect2>
 
 <sect2><title>Implementation Details</title>
 
@@ -85,4 +95,4 @@ files.</para>
 
 </sect2>
 
-</sect1>
+</sect1>

winsup/doc/Makefile.in

@@ -11,6 +11,8 @@ SHELL = @SHELL@
 srcdir = @srcdir@
 VPATH = @srcdir@
 
+SGMLDIRS =  -d $(srcdir) -d $(utils_source) -d $(cygwin_source)
+
 DOC=faq.txt faq.info readme.txt readme.info
 HTMLDOC=faq.html readme.html
 
@@ -46,25 +48,25 @@ cygwin-ug/cygwin-ug.html : cygwin-ug.sgml doctool
 	-db2html $<
 
 cygwin-ug.sgml : cygwin-ug.in.sgml ./doctool Makefile
-	-./doctool -m -d $(srcdir) -d $(utils_source) -s $(srcdir) -o $@ $<
+	-./doctool -m $(SGMLDIRS) -s $(srcdir) -o $@ $<
 
 cygwin-ug-net/cygwin-ug-net.html : cygwin-ug-net.sgml doctool
 	-db2html $<
 
 cygwin-ug-net.sgml : cygwin-ug-net.in.sgml ./doctool Makefile
-	-./doctool -m -d $(srcdir) -d $(utils_source) -s $(srcdir) -o $@ $<
+	-./doctool -m $(SGMLDIRS) -s $(srcdir) -o $@ $<
 
 cygwin-api/cygwin-api.html : cygwin-api.sgml
 	-db2html $<
 
 cygwin-api.sgml : cygwin-api.in.sgml ./doctool Makefile
-	-./doctool -m -d $(srcdir) -d $(utils_source) -s $(srcdir) -o $@ $<
+	-./doctool -m $(SGMLDIRS) -s $(srcdir) -o $@ $<
 
 cygwin-api-int/cygwin-api-int.html : cygwin-api-int.sgml
 	-db2html $<
 
 cygwin-api-int.sgml : cygwin-api.in.sgml ./doctool Makefile
-	-./doctool -i -m -d $(srcdir) -d $(utils_source) -s $(srcdir) -b cygwin-api-int -o $@ $<
+	-./doctool -i -m $(SGMLDIRS) -s $(srcdir) -b cygwin-api-int -o $@ $<
 
 ./doctool : doctool.c
 	gcc -g $< -o $@

winsup/doc/overview.sgml

@@ -1,6 +1,6 @@
 <chapter id="overview"><title>Cygwin Overview</title>
 
-<sect1><title>What is it?</title>
+<sect1 id="what-is-it"><title>What is it?</title>
 
 <para>The Cygwin tools are ports of the popular GNU development
 tools and utilities for Windows NT and 9x. They function through the
@@ -20,7 +20,7 @@ from the bash shell (provided) or from the command.com.</para>
 
 </sect1>
 
-<sect1><title>Are the Cygwin tools free software?</title>
+<sect1 id="are-free"><title>Are the Cygwin tools free software?</title>
 
 <para>Yes. Parts are GNU software (gcc, gas, ld, etc...), parts are
 covered by the standard X11 license, some of it is public domain,
@@ -38,7 +38,7 @@ sent to the project mailing list cygwin@sourceware.cygnus.com.</para>
 
 </sect1>
 
-<sect1><title>A brief history of the Cygwin project</title>
+<sect1 id="brief-history"><title>A brief history of the Cygwin project</title>
 
 <para>The first thing done was to enhance the development tools (gcc,
 gdb, gas, et al) so that they could generate/interpret Win32 native
@@ -72,7 +72,7 @@ the GNU configure mechanism. Self hosting was achieved as of the beta
 
 DOCTOOL-INSERT-ov-ex-unix
 DOCTOOL-INSERT-ov-ex-win
-<sect1><title>Highlights of Cygwin Functionality</title>
+<sect1 id="highlights"><title>Highlights of Cygwin Functionality</title>
 DOCTOOL-INSERT-ov-hi-intro
 DOCTOOL-INSERT-ov-hi-win9xnt
 DOCTOOL-INSERT-ov-hi-perm

winsup/doc/pathnames.sgml

@@ -109,7 +109,7 @@ largely on how closely you want to simulate a POSIX environment,
 whether you mix Windows and Cygwin programs, and how many drive
 letters you are using.  If you want to be very POSIX-like (assuming
 "CygwinRoot" is the top directory of your Cygwin distribution), you may
-want to do something like this:
+want to do something like this:</para>
 
 <example><title>POSIX-like mount setup</title>
 <screen>
@@ -186,6 +186,8 @@ default printer with the command <command>cat filename > PRN</command>
 (make sure to end with a Form Feed).
 </para>
 
+</sect2>
+
 <sect2> <Title>POSIX devices</title>
 <para>There is no need to create a POSIX <filename>/dev</filename> 
 directory as it is simulated within Cygwin automatically.
@@ -200,6 +202,8 @@ mounted by default, such as /dev/fd1. What do they really do?
 </comment>
 </para>
 
+</sect2>
+
 <sect2><title>The .exe extension</title>
 
 <para> Executable program filenames end with .exe but the .exe need
@@ -254,7 +258,7 @@ starting with "@" in a special way.  If a file
 file to delimit strings containing blank space. 
 Embedded double quotes must be repeated.
 In the following example compare the behaviors of the bash built-in
-<command>echo</command> and of the program <command>/bin/echo</command>.
+<command>echo</command> and of the program <command>/bin/echo</command>.</para>
 
 <example><title> Using @pathname</title>
 <screen>

winsup/doc/setup-net.sgml

@@ -16,7 +16,7 @@ grep, gzip, less, m4, sed, shellutils, tar, textutils, time</para>
 <para>Full source code is available for these tools.</para>
 
 </sect1>
-<sect1><title>Installing the binary release</title>
+<sect1 id="installing-binaries"><title>Installing the binary release</title>
 
 <para>Important!  Be sure to remove any older versions of the Cygwin
 tools from your <EnVar>PATH</EnVar> environment variable so you do
@@ -77,7 +77,7 @@ instructions in the next section, else go directly to
 <Xref LinkEnd="setup-dir"> to complete your system setup.</para>
 
 </sect1>
-<sect1><title>Installing the source code</title>
+<sect1 id="installing-source"><title>Installing the source code</title>
 
 <para>Before downloading the source code corresponding to the release,
 you should install the latest release of the tools (either the full

winsup/doc/setup.sgml

@@ -13,7 +13,9 @@ tcl, tix, tk</para>
 findutils, gawk, grep, gzip, m4, sed, shellutils, tar, textutils,
 time</para>
 
-<sect1><title>Installing the binary release</title>
+</sect1>
+
+<sect1 id="installing-binaries"><title>Installing the binary release</title>
 
 <para>Load the GNUPro CD-ROM and run the installer.  It will
 take you through the installation process, starting with asking for
@@ -35,6 +37,8 @@ drive letter is mounted as `/'.</para>
 <para>If you should ever want to uninstall the tools, you may do so
 via the "Add/Remove Programs" control panel.</para>
 
+</sect1>
+
 DOCTOOL-INSERT-setup-dir
 DOCTOOL-INSERT-setup-env
 DOCTOOL-INSERT-setup-reg

winsup/doc/setup2.sgml

@@ -269,7 +269,7 @@ set output-meta on
 # Ignore case while completing
 set completion-ignore-case on
 </screen>
-<para>The first three commands allow bash to display 8-bit characters,
+The first three commands allow bash to display 8-bit characters,
 useful for languages with accented characters.  The last line makes
 filename completion case insensitive, which can be convenient in a
 Windows environment.

winsup/utils/utils.sgml

@@ -424,7 +424,7 @@ path location.</para>
 text files in the same manner by default.  Binary mode mounts are
 marked as "binmode" in the Flags column of <command>mount</command>
 output.  By default, mounts are in text mode ("textmode" in the Flags
-column).
+column).</para>
 
 <para>The "-x" flag is used to instruct Cygwin that the mounted file
 is "executable".  If the "-x" flag is used with a directory then
@@ -433,7 +433,7 @@ extensions (.exe, .com, .bat, .cmd) are assumed to be executable
 by default.  Files whose first two characters begin with '#!' are
 also considered to be executable.  This option allows other files
 to be marked as executable and avoids the overhead of opening each
-file to check for a '#!'.
+file to check for a '#!'.</para>
 
 </sect3>
 
@@ -467,6 +467,8 @@ default, the cygdrive-prefix applies only to the current user.  In the
 same way, you can specify the "-b" flag such that all new automounted
 filesystems default to binary mode file accesses.</para>
 
+</sect3>
+
 <sect3><title>Limitations</title>
 
 <para>Limitations: there is a hard-coded limit of 30 mount