Update Makefile to use xmlto

winsup/cygwin/shared.sgml

@@ -5,7 +5,7 @@
 <funcsynopsis><funcprototype>
 <funcdef>shared_info *
 <function>cygwin_getshared</function></funcdef>
-<void>
+<void />
 </funcprototype></funcsynopsis>
 
 <para>Returns a pointer to an internal Cygwin memory structure

winsup/cygwin/stackdump.sgml

@@ -4,7 +4,7 @@
 <funcsynopsis><funcprototype>
 <funcdef>extern "C" void
 <function>cygwin_stackdump</function></funcdef>
-<void>
+<void />
 </funcprototype></funcsynopsis>
 
 <para> Outputs a stackdump to stderr from the called location.

winsup/doc/ChangeLog

@@ -1,3 +1,9 @@
+2004-12-27  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
+
+	* Makefile.in: Update to use xmlto. 
+	* cygwin.dsl: Change into DocBook XSL stylesheet for xmlto.
+	* pathnames.sgml: Correct documentation of mount behavior.
+
 2004-12-24  Joshua Daniel Franklin  <joshuadfranklin@yahoo.com>
 
 	* cygserver.sgml: Cleanup markup for XML validity.

winsup/doc/Makefile.in

@@ -40,7 +40,6 @@ all : \
 	cygwin-ug-net/cygwin-ug-net.html \
 	cygwin-ug-net.html \
 	cygwin-api/cygwin-api.html \
-	$(DOC) \
 	$(HTMLDOC)
 
 clean:
@@ -48,34 +47,25 @@ 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 $@
 

winsup/doc/cygwin.dsl

@@ -1,149 +1,13 @@
-<!DOCTYPE style-sheet PUBLIC
+<?xml version='1.0'?>
-          "-//James Clark//DTD DSSSL Style Sheet//EN" [
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-<!ENTITY % html "IGNORE">
+                xmlns:fo="http://www.w3.org/1999/XSL/Format"
-<![%html;[
+                version='1.0'>
-<!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>
-]]>
-]>
 
-<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       -->
+<!-- TODO: make URLs and paths wrap with PDF output -->
-<style-specification id="print" use="docbook">
-<style-specification-body> 
 
-;; The following are 
+</xsl:stylesheet>
-;; <!-- Cygnus customizations by Mark Galassi -->
-;; ====================
-;; customize the print 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>

winsup/doc/pathnames.sgml

@@ -49,11 +49,15 @@ the Cygwin library (this version is not the same as the release
 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
+<para>Since Windows uses drive letters instead of a single filesystem
-system partition but it can be relocated to any directory in the
+root, the POSIX root <filename>/</filename> must be set to a directory
-Windows file system using the <command>mount</command> command.
+in the Windows file system using the <command>mount</command> command.
-Whenever Cygwin generates a POSIX path from a Win32 one, it uses the
+Without a <filename>/</filename> mount, Cygwin processes cannot
-longest matching prefix in the mount table.  Thus, if
+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>