This is the mail archive of the
ecos-patches@sources.redhat.com
mailing list for the eCos project.
Re: CVS docs PDF patch
- From: Iztok Zupet <iztok dot zupet at vsr dot si>
- To: Jonathan Larmour <jifl at eCosCentric dot com>,Bart Veer <bartv at eCosCentric dot com>
- Cc: ecos-patches at sources dot redhat dot com
- Date: Thu, 7 Nov 2002 12:38:19 +0100
- Subject: Re: CVS docs PDF patch
- Organization: VSR d.o.o.
- References: <200210282253.03191.iztok.zupet@vsr.si> <3DC7E0D6.8010908@eCosCentric.com> <200211062015.47297.iztok.zupet@vsr.si>
- Reply-to: iztok dot zupet at vsr dot si
On Wednesday 06 November 2002 20:15, Iztok Zupet wrote:
> Done and uploaded. The patch follows tomorrow if the output seems
As promised, the patch is attached.
Iztok
diff -C3 -N -P -r -x '.*' /ecoscvs/orig/ecos/doc/ChangeLog ./doc/ChangeLog
*** /ecoscvs/orig/ecos/doc/ChangeLog 2002-11-07 11:23:31.000000000 +0100
--- ./doc/ChangeLog 2002-11-07 11:44:17.000000000 +0100
***************
*** 1,3 ****
--- 1,7 ----
+ 2002-11-06 Iztok Zupet <iz@vsr.si>
+
+ * sgml/README-PDF: two targets (letter and a4)
+
2002-10-28 Andrew Lunn <andrew.lunn@ascom.ch>
* sgml/makemakefile: Removed the second OTHER_SGML which clobbers
diff -C3 -N -P -r -x '.*' /ecoscvs/orig/ecos/doc/sgml/README-PDF ./doc/sgml/README-PDF
*** /ecoscvs/orig/ecos/doc/sgml/README-PDF 2002-10-18 03:45:34.000000000 +0200
--- ./doc/sgml/README-PDF 2002-11-07 11:35:28.000000000 +0100
***************
*** 1,5 ****
To build the PDF version of docs (on Linux), simply use:
! make pdf
If Your pdfjadetex complains with
> ! TeX capacity exceeded, sorry [save size=5000].
--- 1,6 ----
To build the PDF version of docs (on Linux), simply use:
! make pdfa4 for A4 size or
! make pdfletter for US letter size
If Your pdfjadetex complains with
> ! TeX capacity exceeded, sorry [save size=5000].
***************
*** 15,21 ****
\hypersetup{pdfpagemode=None, pdfauthor=eCos (pdfjadetex) , colorlinks=true,
linkcolor=blue, pdfstartview=FitH}
! Regaqrds
Iztok
<iz@vsr.si>
--- 16,22 ----
\hypersetup{pdfpagemode=None, pdfauthor=eCos (pdfjadetex) , colorlinks=true,
linkcolor=blue, pdfstartview=FitH}
! Regards
Iztok
<iz@vsr.si>
diff -C3 -N -P -r -x '.*' /ecoscvs/orig/ecos/packages/ChangeLog ./packages/ChangeLog
*** /ecoscvs/orig/ecos/packages/ChangeLog 2002-10-24 05:16:54.000000000 +0200
--- ./packages/ChangeLog 2002-11-07 11:52:27.000000000 +0100
***************
*** 1,3 ****
--- 1,13 ----
+ 2002-11-06 Iztok Zupet <iz@vsr.si>
+
+ * pkgconf/rules.doc: modified for two PDF outputs,
+ US letter and A4
+
+ * pkgconf/: added ssa4.dsl and ssletter.dsl, stylesheets defining
+ the A4 and US letter printable stylesheet
+
+ * pkgconf/stylesheet.dsl: removed print stylesheet.
+
2002-10-24 Jonathan Larmour <jifl@eCosCentric.com>
* ecosadmin.tcl (ecosadmin::process_add_package): Use gzip -d, not
diff -C3 -N -P -r -x '.*' /ecoscvs/orig/ecos/packages/pkgconf/rules.doc ./packages/pkgconf/rules.doc
*** /ecoscvs/orig/ecos/packages/pkgconf/rules.doc 2002-10-18 03:46:15.000000000 +0200
--- ./packages/pkgconf/rules.doc 2002-11-07 11:33:20.000000000 +0100
***************
*** 77,83 ****
endif
endif
endif
! ECOS_STYLESHEET := $(TOPLEVEL)/pkgconf/stylesheet.dsl
FIXHTML := $(TOPLEVEL)/pkgconf/fixhtml.tcl
# The files that will be generated:
--- 77,86 ----
endif
endif
endif
!
! A4_STYLESHEET := $(TOPLEVEL)/pkgconf/ssa4.dsl
! LETTER_STYLESHEET := $(TOPLEVEL)/pkgconf/ssletter.dsl
! HTML_STYLESHEET := $(TOPLEVEL)/pkgconf/stylesheet.dsl
FIXHTML := $(TOPLEVEL)/pkgconf/fixhtml.tcl
# The files that will be generated:
***************
*** 88,93 ****
--- 91,99 ----
MAIN_PDF := $(subst .sgml,.pdf,$(MAIN_SGML))
endif
+ MAIN_PDFA4 := $(subst .pdf,-a4.pdf,$(MAIN_PDF))
+ MAIN_PDFLETTER := $(subst .pdf,-letter.pdf,$(MAIN_PDF))
+
# Rules for generating pictures
GIFS := $(foreach x,$(PICTURES),$(x).gif)
EPS := $(foreach x,$(PICTURES),$(x).eps)
***************
*** 110,127 ****
# can be ignored.
html: $(MAIN_HTML)
! $(MAIN_HTML): $(MAIN_SGML) $(OTHER_SGML) $(GIFS) $(ECOS_STYLESHEET) $(FIXHTML)
! jade -t sgml -i html -c $(DSSSL_CATALOG) -d $(ECOS_STYLESHEET)#html $<
tclsh $(FIXHTML)
# PDF files can be generated in a similar fashion.
! pdf: $(MAIN_PDF)
! $(MAIN_PDF): $(MAIN_SGML) $(OTHER_SGML) $(PNGS) $(ECOS_STYLESHEET)
! jade -o $(subst .pdf,.tex,$(MAIN_PDF)) -t tex -V tex-backend -c $(DSSSL_CATALOG) -d $(ECOS_STYLESHEET)#print $<
! pdfjadetex $(subst .pdf,.tex,$(MAIN_PDF))
! pdfjadetex $(subst .pdf,.tex,$(MAIN_PDF))
! pdfjadetex $(subst .pdf,.tex,$(MAIN_PDF))
#$(MAIN_PDF): $(MAIN_SGML) $(OTHER_SGML) $(EPS) $(ECOS_STYLESHEET)
# jade -o $(subst .sgml,.tex,$(MAIN_SGML)) -t tex -V tex-backend -d $(ECOS_STYLESHEET)#print $<
--- 116,141 ----
# can be ignored.
html: $(MAIN_HTML)
! $(MAIN_HTML): $(MAIN_SGML) $(OTHER_SGML) $(GIFS) $(HTML_STYLESHEET) $(FIXHTML)
! jade -t sgml -i html -c $(DSSSL_CATALOG) -d $(HTML_STYLESHEET)#html $<
tclsh $(FIXHTML)
# PDF files can be generated in a similar fashion.
! pdfa4: $(MAIN_PDFA4)
! $(MAIN_PDFA4): $(MAIN_SGML) $(OTHER_SGML) $(PNGS) $(A4_STYLESHEET)
! jade -o $(subst .pdf,.tex,$(MAIN_PDFA4)) -t tex -V tex-backend -c $(DSSSL_CATALOG) -d $(A4_STYLESHEET)#print $<
! pdfjadetex $(subst .pdf,.tex,$(MAIN_PDFA4))
! pdfjadetex $(subst .pdf,.tex,$(MAIN_PDFA4))
! pdfjadetex $(subst .pdf,.tex,$(MAIN_PDFA4))
!
! pdfletter: $(MAIN_PDFLETTER)
!
! $(MAIN_PDFLETTER): $(MAIN_SGML) $(OTHER_SGML) $(PNGS) $(LETTER_STYLESHEET)
! jade -o $(subst .pdf,.tex,$(MAIN_PDFLETTER)) -t tex -V tex-backend -c $(DSSSL_CATALOG) -d $(LETTER_STYLESHEET)#print $<
! pdfjadetex $(subst .pdf,.tex,$(MAIN_PDFLETTER))
! pdfjadetex $(subst .pdf,.tex,$(MAIN_PDFLETTER))
! pdfjadetex $(subst .pdf,.tex,$(MAIN_PDFLETTER))
#$(MAIN_PDF): $(MAIN_SGML) $(OTHER_SGML) $(EPS) $(ECOS_STYLESHEET)
# jade -o $(subst .sgml,.tex,$(MAIN_SGML)) -t tex -V tex-backend -d $(ECOS_STYLESHEET)#print $<
diff -C3 -N -P -r -x '.*' /ecoscvs/orig/ecos/packages/pkgconf/ssa4.dsl ./packages/pkgconf/ssa4.dsl
*** /ecoscvs/orig/ecos/packages/pkgconf/ssa4.dsl 1970-01-01 01:00:00.000000000 +0100
--- ./packages/pkgconf/ssa4.dsl 2002-11-07 07:58:11.000000000 +0100
***************
*** 0 ****
--- 1,110 ----
+ <!-- {{{ Banner -->
+
+ <!-- =============================================================== -->
+ <!-- -->
+ <!-- stylesheet.sgml -->
+ <!-- -->
+ <!-- Customize the nwalsh modular stylesheets. -->
+ <!-- -->
+ <!-- =============================================================== -->
+ <!-- ####ECOSGPLCOPYRIGHTBEGIN#### -->
+ <!-- This file is part of eCos, the Embedded Configurable Operating System. -->
+ <!-- Copyright (C) 1998, 1999, 2000, 2001, 2002 Red Hat, Inc. -->
+ <!-- -->
+ <!-- eCos is free software; you can redistribute it and/or modify it under -->
+ <!-- the terms of the GNU General Public License as published by the Free -->
+ <!-- Software Foundation; either version 2 or (at your option) any later -->
+ <!-- version. -->
+ <!-- -->
+ <!-- eCos is distributed in the hope that it will be useful, but WITHOUT ANY-->
+ <!-- WARRANTY; without even the implied warranty of MERCHANTABILITY or -->
+ <!-- FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License -->
+ <!-- for more details. -->
+ <!-- -->
+ <!-- You should have received a copy of the GNU General Public License along-->
+ <!-- with eCos; if not, write to the Free Software Foundation, Inc., -->
+ <!-- 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. -->
+ <!-- -->
+ <!-- As a special exception, if other files instantiate templates or use -->
+ <!-- macros or inline functions from this file, or you compile this file and-->
+ <!-- link it with other works to produce a work based on this file, this -->
+ <!-- file does not by itself cause the resulting work to be covered by the -->
+ <!-- GNU General Public License. However the source code for this file must -->
+ <!-- still be made available in accordance with section (3) of the GNU -->
+ <!-- General Public License. -->
+ <!-- -->
+ <!-- This exception does not invalidate any other reasons why a work based -->
+ <!-- on this file might be covered by the GNU General Public License. -->
+ <!-- -->
+ <!-- Alternative licenses for eCos may be arranged by contacting -->
+ <!-- Red Hat, Inc. at http://sources.redhat.com/ecos/ecos-license/ -->
+ <!-- ####ECOSGPLCOPYRIGHTEND#### -->
+ <!-- =============================================================== -->
+ <!-- #####DESCRIPTIONBEGIN#### -->
+ <!-- -->
+ <!-- Author(s): bartv -->
+ <!-- Based on cygnus-both.dsl by Mark Galassi -->
+ <!-- Contact(s): bartv -->
+ <!-- Date: 2000/03/15 -->
+ <!-- Version: 0.01 -->
+ <!-- -->
+ <!-- ####DESCRIPTIONEND#### -->
+ <!-- =============================================================== -->
+
+ <!-- }}} -->
+
+ <!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>
+ ]]>
+ ]>
+
+ <style-sheet>
+ <style-specification id="print" use="docbook">
+ <style-specification-body>
+
+ ;; ====================
+ ;; customize the print (PDF) A4 stylesheet
+ ;; ====================
+
+ ;; Set the paper parameters as per other eCos documentation
+ (define %page-width% 210mm)
+ (define %page-height% 297mm)
+ (define %left-margin% 0.75in)
+ (define %right-margin% 0.75in)
+
+ ;; Assume that we are only producing books, a reasonable assumption
+ ;; given the primary author :-)
+ (define %two-side% #t)
+
+ ;; Use 12pt
+ ;;(define %visual-acuity% "presbyopic")
+
+ ;; Do not use graphics in admonitions, our documentation is supposed
+ ;; to look boring :-(
+ (define %admon-graphics% #f)
+
+ ;; Justified text please.
+ (define %default-quadding% 'justify)
+
+ ;; A separate page for each man page please.
+ (define %refentry-new-page% #t)
+
+ ;; The component writer's guide man pages do not describe functions
+ (define %refentry-functions% #f)
+
+ ;; Program listings should use smaller font to fit on page width
+ (define %verbatim-size-factor% 0.84)
+
+
+ </style-specification-body>
+ </style-specification>
+ <external-specification id="docbook" document="docbook.dsl">
+ </style-sheet>
+
diff -C3 -N -P -r -x '.*' /ecoscvs/orig/ecos/packages/pkgconf/ssletter.dsl ./packages/pkgconf/ssletter.dsl
*** /ecoscvs/orig/ecos/packages/pkgconf/ssletter.dsl 1970-01-01 01:00:00.000000000 +0100
--- ./packages/pkgconf/ssletter.dsl 2002-11-07 07:58:11.000000000 +0100
***************
*** 0 ****
--- 1,110 ----
+ <!-- {{{ Banner -->
+
+ <!-- =============================================================== -->
+ <!-- -->
+ <!-- stylesheet.sgml -->
+ <!-- -->
+ <!-- Customize the nwalsh modular stylesheets. -->
+ <!-- -->
+ <!-- =============================================================== -->
+ <!-- ####ECOSGPLCOPYRIGHTBEGIN#### -->
+ <!-- This file is part of eCos, the Embedded Configurable Operating System. -->
+ <!-- Copyright (C) 1998, 1999, 2000, 2001, 2002 Red Hat, Inc. -->
+ <!-- -->
+ <!-- eCos is free software; you can redistribute it and/or modify it under -->
+ <!-- the terms of the GNU General Public License as published by the Free -->
+ <!-- Software Foundation; either version 2 or (at your option) any later -->
+ <!-- version. -->
+ <!-- -->
+ <!-- eCos is distributed in the hope that it will be useful, but WITHOUT ANY-->
+ <!-- WARRANTY; without even the implied warranty of MERCHANTABILITY or -->
+ <!-- FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License -->
+ <!-- for more details. -->
+ <!-- -->
+ <!-- You should have received a copy of the GNU General Public License along-->
+ <!-- with eCos; if not, write to the Free Software Foundation, Inc., -->
+ <!-- 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA. -->
+ <!-- -->
+ <!-- As a special exception, if other files instantiate templates or use -->
+ <!-- macros or inline functions from this file, or you compile this file and-->
+ <!-- link it with other works to produce a work based on this file, this -->
+ <!-- file does not by itself cause the resulting work to be covered by the -->
+ <!-- GNU General Public License. However the source code for this file must -->
+ <!-- still be made available in accordance with section (3) of the GNU -->
+ <!-- General Public License. -->
+ <!-- -->
+ <!-- This exception does not invalidate any other reasons why a work based -->
+ <!-- on this file might be covered by the GNU General Public License. -->
+ <!-- -->
+ <!-- Alternative licenses for eCos may be arranged by contacting -->
+ <!-- Red Hat, Inc. at http://sources.redhat.com/ecos/ecos-license/ -->
+ <!-- ####ECOSGPLCOPYRIGHTEND#### -->
+ <!-- =============================================================== -->
+ <!-- #####DESCRIPTIONBEGIN#### -->
+ <!-- -->
+ <!-- Author(s): bartv -->
+ <!-- Based on cygnus-both.dsl by Mark Galassi -->
+ <!-- Contact(s): bartv -->
+ <!-- Date: 2000/03/15 -->
+ <!-- Version: 0.01 -->
+ <!-- -->
+ <!-- ####DESCRIPTIONEND#### -->
+ <!-- =============================================================== -->
+
+ <!-- }}} -->
+
+ <!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>
+ ]]>
+ ]>
+
+ <style-sheet>
+ <style-specification id="print" use="docbook">
+ <style-specification-body>
+
+ ;; ====================
+ ;; customize the print (PDF) US letter stylesheet
+ ;; ====================
+
+ ;; Set the paper parameters as per other eCos documentation
+ (define %page-width% 8.5in)
+ (define %page-height% 11in)
+ (define %left-margin% 0.75in)
+ (define %right-margin% 0.75in)
+
+ ;; Assume that we are only producing books, a reasonable assumption
+ ;; given the primary author :-)
+ (define %two-side% #t)
+
+ ;; Use 12pt
+ ;;(define %visual-acuity% "presbyopic")
+
+ ;; Do not use graphics in admonitions, our documentation is supposed
+ ;; to look boring :-(
+ (define %admon-graphics% #f)
+
+ ;; Justified text please.
+ (define %default-quadding% 'justify)
+
+ ;; A separate page for each man page please.
+ (define %refentry-new-page% #t)
+
+ ;; The component writer's guide man pages do not describe functions
+ (define %refentry-functions% #f)
+
+ ;; Program listings should use smaller font to fit on page width
+ (define %verbatim-size-factor% 0.87)
+
+
+ </style-specification-body>
+ </style-specification>
+ <external-specification id="docbook" document="docbook.dsl">
+ </style-sheet>
+
diff -C3 -N -P -r -x '.*' /ecoscvs/orig/ecos/packages/pkgconf/stylesheet.dsl ./packages/pkgconf/stylesheet.dsl
*** /ecoscvs/orig/ecos/packages/pkgconf/stylesheet.dsl 2002-05-24 01:08:24.000000000 +0200
--- ./packages/pkgconf/stylesheet.dsl 2002-11-07 11:33:20.000000000 +0100
***************
*** 67,108 ****
<style-sheet>
- <style-specification id="print" use="docbook">
- <style-specification-body>
-
- ;; ====================
- ;; customize the print stylesheet
- ;; ====================
-
- ;; Set the paper parameters as per other eCos documentation
- (define %page-width% 7.5in)
- (define %page-height% 10.2in)
- (define %left-margin% 0.75in)
- (define %right-margin% 0.75in)
-
- ;; Assume that we are only producing books, a reasonable assumption
- ;; given the primary author :-)
- (define %two-side% #t)
-
- ;; Use 12pt
- ;;(define %visual-acuity% "presbyopic")
-
- ;; Do not use graphics in admonitions, our documentation is supposed
- ;; to look boring :-(
- (define %admon-graphics% #f)
-
- ;; Justified text please.
- (define %default-quadding% 'justify)
-
- ;; A separate page for each man page please.
- (define %refentry-new-page% #t)
-
- ;; The component writer's guide man pages do not describe functions
- (define %refentry-functions% #f)
-
- </style-specification-body>
- </style-specification>
-
<!--
;; ====================
;; customize the html stylesheet
--- 67,72 ----