mirror of
git://sourceware.org/git/newlib-cygwin.git
synced 2025-01-19 21:09:22 +08:00
clean up SGML for latest version of jade/docbook
This commit is contained in:
DJ Delorie
parent
25ba8f306f
commit
05357ffef2
@ -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
|
||||
|
||||
@ -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>
|
||||
|
||||
@ -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 $@
|
||||
|
||||
@ -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
|
||||
|
||||
@ -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>
|
||||
|
||||
@ -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
|
||||
|
||||
@ -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
|
||||
|
||||
@ -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.
|
||||
|
||||
@ -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
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user