diff options
Diffstat (limited to 'winsup/doc')
| -rw-r--r-- | winsup/doc/Makefile.in | 10 | ||||
| -rw-r--r-- | winsup/doc/overview.sgml | 8 | ||||
| -rw-r--r-- | winsup/doc/pathnames.sgml | 8 | ||||
| -rw-r--r-- | winsup/doc/setup-net.sgml | 4 | ||||
| -rw-r--r-- | winsup/doc/setup.sgml | 6 | ||||
| -rw-r--r-- | winsup/doc/setup2.sgml | 2 |
6 files changed, 24 insertions, 14 deletions
diff --git a/winsup/doc/Makefile.in b/winsup/doc/Makefile.in index 74c0be821..988f388a6 100644 --- a/winsup/doc/Makefile.in +++ b/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 $@ diff --git a/winsup/doc/overview.sgml b/winsup/doc/overview.sgml index ea476dd49..4b48094aa 100644 --- a/winsup/doc/overview.sgml +++ b/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 diff --git a/winsup/doc/pathnames.sgml b/winsup/doc/pathnames.sgml index 2338b18ff..a302e7c96 100644 --- a/winsup/doc/pathnames.sgml +++ b/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> diff --git a/winsup/doc/setup-net.sgml b/winsup/doc/setup-net.sgml index 184233026..b947129d6 100644 --- a/winsup/doc/setup-net.sgml +++ b/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 diff --git a/winsup/doc/setup.sgml b/winsup/doc/setup.sgml index 2e6ce2857..f25b5c594 100644 --- a/winsup/doc/setup.sgml +++ b/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 diff --git a/winsup/doc/setup2.sgml b/winsup/doc/setup2.sgml index 7a24e5fa1..237c6eacb 100644 --- a/winsup/doc/setup2.sgml +++ b/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. |