OSDN Git Service

Update Makefile to use xmlto
authorjoshuadfranklin <joshuadfranklin>
Mon, 27 Dec 2004 19:03:56 +0000 (19:03 +0000)
committerjoshuadfranklin <joshuadfranklin>
Mon, 27 Dec 2004 19:03:56 +0000 (19:03 +0000)
winsup/cygwin/shared.sgml
winsup/cygwin/stackdump.sgml
winsup/doc/ChangeLog
winsup/doc/Makefile.in
winsup/doc/cygwin.dsl
winsup/doc/pathnames.sgml

index d55eb6e..b8d111a 100644 (file)
@@ -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
index e0ac0e0..1969e2e 100644 (file)
@@ -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.
index 0795510..b346f53 100644 (file)
@@ -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.
index 94a8eb8..87a72d1 100644 (file)
@@ -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 $@
 
index bf855c1..8c16471 100644 (file)
-<!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>
index ed98d27..fe91339 100644 (file)
@@ -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
-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>