cygwin-ug-net/cygwin-ug-net.html \
cygwin-ug-net.html \
cygwin-api/cygwin-api.html \
- $(DOC) \
$(HTMLDOC)
clean:
install: all
-# jw -d $(srcdir)/cygwin.dsl#html cygwin-ug-net.sgml
-cygwin-ug/cygwin-ug.html : cygwin-ug.sgml doctool
- -db2html -d $(srcdir)/cygwin.dsl#html $<
-
-cygwin-ug.sgml : cygwin-ug.in.sgml ./doctool Makefile
- -./doctool -m $(SGMLDIRS) -s $(srcdir) -o $@ $<
-
cygwin-ug-net.html : cygwin-ug-net.sgml doctool
- -jw -d $(srcdir)/cygwin.dsl#html -u $<
+ -xmlto html-nochunks -m $(srcdir)/cygwin.dsl $<
+ -cp cygwin-ug-net.html cygwin-ug-net/cygwin-ug-net-nochunks.html
+ -gzip cygwin-ug-net/cygwin-ug-net-nochunks.html
cygwin-ug-net/cygwin-ug-net.html : cygwin-ug-net.sgml doctool
- -db2html -d $(srcdir)/cygwin.dsl#html $<
+ -xmlto html -o cygwin-ug-net/ -m $(srcdir)/cygwin.dsl $<
+ -mv cygwin-ug-net/index.html cygwin-ug-net/cygwin-ug-net.html
cygwin-ug-net.sgml : cygwin-ug-net.in.sgml ./doctool Makefile
-./doctool -m $(SGMLDIRS) -s $(srcdir) -o $@ $<
cygwin-api/cygwin-api.html : cygwin-api.sgml
- -db2html -d $(srcdir)/cygwin.dsl#html $<
+ -xmlto html -o cygwin-api/ -m $(srcdir)/cygwin.dsl $<
+ -mv cygwin-api/index.html cygwin-api/cygwin-api.html
cygwin-api.sgml : cygwin-api.in.sgml ./doctool Makefile
-./doctool -m $(SGMLDIRS) -s $(srcdir) -o $@ $<
-cygwin-api-int/cygwin-api-int.html : cygwin-api-int.sgml
- -db2html -d $(srcdir)/cygwin.dsl#html $<
-
-cygwin-api-int.sgml : cygwin-api.in.sgml ./doctool Makefile
- -./doctool -i -m $(SGMLDIRS) -s $(srcdir) -b cygwin-api-int -o $@ $<
-
./doctool : doctool.c
gcc -g $< -o $@
-<!DOCTYPE style-sheet PUBLIC
- "-//James Clark//DTD DSSSL Style Sheet//EN" [
-<!ENTITY % html "IGNORE">
-<![%html;[
-<!ENTITY % print "IGNORE">
-<!ENTITY docbook.dsl PUBLIC
- "-//Norman Walsh//DOCUMENT DocBook HTML Stylesheet//EN"
- CDATA dsssl>
-]]>
-<!ENTITY % print "INCLUDE">
-<![%print;[
-<!ENTITY docbook.dsl PUBLIC
- "-//Norman Walsh//DOCUMENT DocBook Print Stylesheet//EN"
- CDATA dsssl>
-]]>
-]>
+<?xml version='1.0'?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+ xmlns:fo="http://www.w3.org/1999/XSL/Format"
+ version='1.0'>
-<style-sheet>
+<!-- See /usr/share/docbook-xsl/params/ -->
+<xsl:param name="html.stylesheet" select="'docbook.css'"/>
+<xsl:param name="use.id.as.filename" select="1" />
-<!-- PRINT -->
-<style-specification id="print" use="docbook">
-<style-specification-body>
+<!-- TODO: make URLs and paths wrap with PDF output -->
-;; The following are
-;; <!-- Cygnus customizations by Mark Galassi -->
-;; ====================
-;; customize the print stylesheet
-;; ====================
+</xsl:stylesheet>
-;; make funcsynopsis look pretty
-(define %funcsynopsis-decoration%
- ;; Decorate elements of a FuncSynopsis?
- #t)
-
-;; use graphics in admonitions, and have their path be "."
-;; NO: we are not yet ready to use gifs in TeX and so forth
-(define %admon-graphics-path%
- "./")
-(define %admon-graphics%
- #f)
-
-;; this is necessary because right now jadetex does not understand
-;; symbolic entities, whereas things work well with numeric entities.
-(declare-characteristic preserve-sdata?
- "UNREGISTERED::James Clark//Characteristic::preserve-sdata?"
- #f)
-(define %two-side% #t)
-
-(define %section-autolabel%
- ;; Are sections enumerated?
- #t)
-;; (define %title-font-family%
-;; ;; The font family used in titles
-;; "Ariel")
-(define %visual-acuity%
- ;; General measure of document text size
- ;; "presbyopic"
- ;; "large-type"
- "presbyopic")
-
-(define %generate-part-toc% #t)
-
-
-;;; The following customizations are from Tim Waugh's selfdocbook
-;;; http://cyberelk.net/tim/docbook/
-;;;
-;;; TeX backend can go to PS (where EPS is needed)
-;;; or to PDF (where PNG is needed). So, just
-;;; omit the file extension altogether and let
-;;; tex/pdfjadetex sort it out on its own.
-(define (graphic-file filename)
- (let ((ext (file-extension filename)))
- (if (or (equal? 'backend 'tex) ;; Leave off the extension for TeX
- (not filename)
- (not %graphic-default-extension%)
- (member ext %graphic-extensions%))
- filename
- (string-append filename "." %graphic-default-extension%))))
-
-;;; Full justification.
-(define %default-quadding%
- 'justify)
-
-;;; To make URLs line wrap we use the TeX 'url' package.
-;;; See also: jadetex.cfg
-;; First we need to declare the 'formatting-instruction' flow class.
-(declare-flow-object-class formatting-instruction
-"UNREGISTERED::James Clark//Flow Object Class::formatting-instruction")
-;; Then redefine ulink to use it.
-(element ulink
- (make sequence
- (if (node-list-empty? (children (current-node)))
- ; ulink url="...", /ulink
- (make formatting-instruction
- data: (string-append "\\url{"
- (attribute-string (normalize "url"))
- "}"))
- (if (equal? (attribute-string (normalize "url"))
- (data-of (current-node)))
- ; ulink url="http://...", http://..., /ulink
- (make formatting-instruction data:
- (string-append "\\url{"
- (attribute-string (normalize "url"))
- "}"))
- ; ulink url="http://...", some text, /ulink
- (make sequence
- ($charseq$)
- (literal " (")
- (make formatting-instruction data:
- (string-append "\\url{"
- (attribute-string (normalize "url"))
- "}"))
- (literal ")"))))))
-;;; And redefine filename to use it too.
-(element filename
- (make formatting-instruction
- data: (string-append "\\path{" (data-of (current-node)) "}")))
-
-</style-specification-body>
-</style-specification>
-
-<!-- HTML -->
-<style-specification id="html" use="docbook">
-<style-specification-body>
-
-;; If true (non-zero), elements of the FuncSynopsis will be decorated
-;; (e.g. bold or italic).
-(define %funcsynopsis-decoration% #t)
-
-;; If true, a Table of Contents will be generated for each 'Article'.
-(define %generate-article-toc% #t)
-
-;; If true, a Table of Contents will be generated for each Part.
-(define %generate-part-toc% #t)
-
-;; The name of the stylesheet to place in the HTML LINK TAG,
-;; or #f to suppress the stylesheet LINK.
-(define %stylesheet% "docbook.css")
-
-(define %use-id-as-filename% #t)
-
-(define %html-ext% ".html")
-
-</style-specification-body>
-</style-specification>
-
-<external-specification id="docbook" document="docbook.dsl">
-
-</style-sheet>
number). The system-wide table is located under the same subkeys
under HKEY_LOCAL_SYSTEM.</para>
-<para>By default, the POSIX root <filename>/</filename> points to the
-system partition but it can be relocated to any directory in the
-Windows file system using the <command>mount</command> command.
-Whenever Cygwin generates a POSIX path from a Win32 one, it uses the
-longest matching prefix in the mount table. Thus, if
+<para>Since Windows uses drive letters instead of a single filesystem
+root, the POSIX root <filename>/</filename> must be set to a directory
+in the Windows file system using the <command>mount</command> command.
+Without a <filename>/</filename> mount, Cygwin processes cannot
+distinguish between the Windows CurrentDrive and SystemDrive.
+</para>
+
+<para>Whenever Cygwin generates a POSIX path from a Win32 one, it uses
+the longest matching prefix in the mount table. Thus, if
<filename>C:</filename> is mounted as <filename>/c</filename> and also
as <filename>/</filename>, then Cygwin would translate
<filename>C:/foo/bar</filename> to <filename>/c/foo/bar</filename>.</para>