mirror of
git://sourceware.org/git/newlib-cygwin.git
synced 2025-02-01 03:50:28 +08:00
Update Makefile to use xmlto
This commit is contained in:
Joshua Daniel Franklin
parent
6e3c97b14e
commit
b75ec93a63
@ -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
|
||||
|
||||
@ -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.
|
||||
|
||||
@ -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.
|
||||
|
||||
@ -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 $@
|
||||
|
||||
|
||||
@ -1,149 +1,13 @@
|
||||
<!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>
|
||||
|
||||
@ -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>
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user