The sourceforge list server delayed sending this message to me until today.
Re the suggested changes to documents: - Let's leave the demo files alone. These not documentation. They there to demonstrate embedding HSQLDB as a servlet, nothing more. Adding style-sheets etc will just complexify things. - Adding style sheets is fine in general. But regarding link to the web docs from ./index.html, we should be thinking: do we want to add all the web site to the zip package? The web site could have some pages covering development of future versions, or announcements are are not related to the package being released. I think such pages should not really go into the .zip package. Perhaps we should change the document organisation a bit so that stuff that goes into the .zip (and website) is in ./doc but the stuff that is only for the website goes into ./website and is not distributed in the .zip. Fred ----- Original Message ----- From: "Thomas Mueller" <[EMAIL PROTECTED]> To: <[EMAIL PROTECTED]> Sent: 26 October 2004 20:27 Subject: [Hsqldb-developers] Docs Hi, Currently, there is some information available on the web site than is not in the download (FAQ for example). There is a handy doc index (hsqlDocIndex.html) in the web site but not in the downloaded docs. I think it would be nice if the downloaded version (offline docs) would contain the same information as available on the web site. I suggest to just include the web site html in the project itself. Like that we also have no problem with versioning of the web site. Docbook: - Can I compile without internet connection? (Currently I can't) - Are the docbook build errors below ok? - There's a dead links in the docs: http://hsqldb.sourceforge.net/guide/guide.pdf I guess this file should be uploaded About uploading the web site: For other sourceforge projects, I used pscp to upload the web site changes. There is a free graphical tool as well: Secure iXplorer (I didn't use it so far). See also: http://sourceforge.net/docman/display_doc.php?docid=10249&group_id=1 Here is what I have done so far: demo/*.html: link the stylesheet doc/*.html: link the stylesheet doc/src/hsqldbstylesheet: general update (use sans-serif font) doc/website: added a snapshot of the website docsrc/guide.css: general update (use sans-serif font) ./index.html: link the stylesheet; added link to website snapshot I didn't commit my changed to the CVS yet. If it is ok with you, I will do that shortly. If you see a problem with my changes, please tell me ASAP. Thanks, Thomas --------- docbook build problems ------------------------------------------------ D:\data\hsqldb\build>ant clean-docwork Buildfile: build.xml clean-docwork: [delete] Deleting directory D:\data\hsqldb\docwork [delete] Deleting 16 files from D:\data\hsqldb\doc BUILD SUCCESSFUL Total time: 2 seconds D:\data\hsqldb\build>ant clean-doc Buildfile: build.xml clean-docwork: clean-doc: [delete] Deleting 24 files from D:\data\hsqldb\doc [delete] Deleted 2 directories from D:\data\hsqldb\doc BUILD SUCCESSFUL Total time: 1 second D:\data\hsqldb\build>ant docbook Buildfile: build.xml -initContrib: docbooks-html: -ddIterate: -condlGenbook: -setXsltFilesets: html: -preDocbook: [mkdir] Created dir: D:\data\hsqldb\docwork\guide\cdata -sandwich: -sandwich: -sandwich: -sandwich: -sandwich: -sandwich: -sandwich: -sandwich: -sandwich: -sandwich: -sandwich: -sandwich: [touch] Creating D:\data\hsqldb\docwork\guide\cdata\.status -checkXslt: -htmlXslt: [style] Transforming into D:\data\hsqldb\doc\guide [style] Processing D:\data\hsqldb\docsrc\guide\guide.xml to D:\data\hsqldb\doc\guide\guide.html [style] Loading stylesheet C:\programs\docbook-xsl-1.66.1\html\docbook.xsl -postDocbook: [copy] Copying 21 files to D:\data\hsqldb\doc docbooks-chunk: -ddIterate: -condlGenbook: -setXsltFilesets: chunk: -preDocbook: -checkXslt: -htmlXslt: [style] Transforming into D:\data\hsqldb\doc\guide [style] Processing D:\data\hsqldb\docsrc\guide\guide.xml to D:\data\hsqldb\doc\guide\guide.bs [style] Loading stylesheet C:\programs\docbook-xsl-1.66.1\html\chunk.xsl [style] file:/C:/programs/docbook-xsl-1.66.1/html/chunker.xsl:94:18: Warning! Writing pr01.html for preface [style] file:/C:/programs/docbook-xsl-1.66.1/html/chunker.xsl:94:18: Warning! Writing ch01.html for chapter [style] file:/C:/programs/docbook-xsl-1.66.1/html/chunker.xsl:94:18: Warning! Writing ch02.html for chapter(sql_issues-chapter) [style] file:/C:/programs/docbook-xsl-1.66.1/html/chunker.xsl:94:18: Warning! Writing ch03.html for chapter(unix-chapter) [style] file:/C:/programs/docbook-xsl-1.66.1/html/chunker.xsl:94:18: Warning! Writing ch04.html for chapter(advanced-chapter) [style] file:/C:/programs/docbook-xsl-1.66.1/html/chunker.xsl:94:18: Warning! Writing ch05.html for chapter(texttables-chapter) [style] file:/C:/programs/docbook-xsl-1.66.1/html/chunker.xsl:94:18: Warning! Writing ch06.html for chapter(tls-chapter) [style] file:/C:/programs/docbook-xsl-1.66.1/html/chunker.xsl:94:18: Warning! Writing ch07.html for chapter(sqltool-chapter) [style] file:/C:/programs/docbook-xsl-1.66.1/html/chunker.xsl:94:18: Warning! Writing ch08.html for chapter(sqlsyntax-chapter) [style] file:/C:/programs/docbook-xsl-1.66.1/html/chunker.xsl:94:18: Warning! Writing apa.html for appendix(building-appendix) [style] file:/C:/programs/docbook-xsl-1.66.1/html/chunker.xsl:94:18: Warning! Writing apb.html for appendix(firstclient-appendix) [style] file:/C:/programs/docbook-xsl-1.66.1/html/chunker.xsl:94:18: Warning! Writing apc.html for appendix [style] file:/C:/programs/docbook-xsl-1.66.1/html/chunker.xsl:94:18: Warning! Writing apd.html for appendix [style] file:/C:/programs/docbook-xsl-1.66.1/html/chunker.xsl:94:18: Warning! Writing ape.html for appendix [style] file:/C:/programs/docbook-xsl-1.66.1/html/chunker.xsl:94:18: Warning! Writing apf.html for appendix [style] file:/C:/programs/docbook-xsl-1.66.1/html/chunker.xsl:94:18: Warning! Writing apg.html for appendix [style] file:/C:/programs/docbook-xsl-1.66.1/html/chunker.xsl:94:18: Warning! Writing index.html for book -postDocbook: [delete] Deleting: D:\data\hsqldb\doc\guide\guide.bs docbooks-pdf: -ddIterate: -condlGenbook: -initContrib: -setXsltFilesets: fo: -preDocbook: -checkXslt: -foXslt: [style] Transforming into D:\data\hsqldb\docwork\guide [style] Processing D:\data\hsqldb\docsrc\guide\guide.xml to D:\data\hsqldb\docwork\guide\guide.fo [style] Loading stylesheet C:\programs\docbook-xsl-1.66.1\fo\docbook.xsl [style] C:/programs/docbook-xsl-1.66.1/fo/docbook.xsl:241:16: Warning! Making portrait pages on USletter paper (8.5i nx11in) -postDocbook: pdf: -checkXslt: -initFop: -fop: [fop] D:\data\hsqldb\docwork\guide\guide.fo -> D:\data\hsqldb\doc\guide\guide.pdf [fop] [ERROR] property - "background-position-horizontal" is not implemented yet. [fop] [ERROR] property - "background-position-vertical" is not implemented yet. [fop] [ERROR] property - "background-position-horizontal" is not implemented yet. [fop] [ERROR] property - "background-position-vertical" is not implemented yet. [fop] [ERROR] property - "background-position-horizontal" is not implemented yet. [fop] [ERROR] property - "background-position-vertical" is not implemented yet. [fop] [ERROR] property - "background-position-horizontal" is not implemented yet. [fop] [ERROR] property - "background-position-vertical" is not implemented yet. [fop] [ERROR] property - "background-position-horizontal" is not implemented yet. [fop] [ERROR] property - "background-position-vertical" is not implemented yet. [fop] [ERROR] property - "background-position-horizontal" is not implemented yet. [fop] [ERROR] property - "background-position-vertical" is not implemented yet. [fop] [ERROR] property - "background-position-horizontal" is not implemented yet. [fop] [ERROR] property - "background-position-vertical" is not implemented yet. [fop] [ERROR] property - "background-position-horizontal" is not implemented yet. [fop] [ERROR] property - "background-position-vertical" is not implemented yet. [fop] [ERROR] property - "background-position-horizontal" is not implemented yet. [fop] [ERROR] property - "background-position-vertical" is not implemented yet. [fop] [ERROR] property - "background-position-horizontal" is not implemented yet. [fop] [ERROR] property - "background-position-vertical" is not implemented yet. [fop] [ERROR] property - "background-position-horizontal" is not implemented yet. [fop] [ERROR] property - "background-position-vertical" is not implemented yet. [fop] [ERROR] property - "background-position-horizontal" is not implemented yet. [fop] [ERROR] property - "background-position-vertical" is not implemented yet. [fop] [ERROR] property - "background-position-horizontal" is not implemented yet. [fop] [ERROR] property - "background-position-vertical" is not implemented yet. [fop] [ERROR] property - "background-position-horizontal" is not implemented yet. [fop] [ERROR] property - "background-position-vertical" is not implemented yet. [fop] [ERROR] property - "background-position-horizontal" is not implemented yet. [fop] [ERROR] property - "background-position-vertical" is not implemented yet. [fop] [ERROR] property - "background-position-horizontal" is not implemented yet. [fop] [ERROR] property - "background-position-vertical" is not implemented yet. [fop] [ERROR] property - "background-position-horizontal" is not implemented yet. [fop] [ERROR] property - "background-position-vertical" is not implemented yet. [fop] [ERROR] property - "background-position-horizontal" is not implemented yet. [fop] [ERROR] property - "background-position-vertical" is not implemented yet. [fop] [ERROR] property - "background-position-horizontal" is not implemented yet. [fop] [ERROR] property - "background-position-vertical" is not implemented yet. [fop] [ERROR] At least one of minimum, optimum, or maximum IPD must be specified on table. [fop] [ERROR] At least one of minimum, optimum, or maximum IPD must be specified on table. [fop] [ERROR] At least one of minimum, optimum, or maximum IPD must be specified on table. [fop] [ERROR] At least one of minimum, optimum, or maximum IPD must be specified on table. [fop] [ERROR] At least one of minimum, optimum, or maximum IPD must be specified on table. [fop] [ERROR] At least one of minimum, optimum, or maximum IPD must be specified on table. [fop] [ERROR] At least one of minimum, optimum, or maximum IPD must be specified on table. [fop] [ERROR] At least one of minimum, optimum, or maximum IPD must be specified on table. [fop] [ERROR] At least one of minimum, optimum, or maximum IPD must be specified on table. [fop] [ERROR] At least one of minimum, optimum, or maximum IPD must be specified on table. docbook: BUILD SUCCESSFUL Total time: 1 minute 40 seconds --------- docbook build problems ------------------------------------------------ -- +++ GMX DSL Premiumtarife 3 Monate gratis* + WLAN-Router 0,- EUR* +++ Clevere DSL-Nutzer wechseln jetzt zu GMX: http://www.gmx.net/de/go/dsl ------------------------------------------------------- This SF.Net email is sponsored by: Sybase ASE Linux Express Edition - download now for FREE LinuxWorld Reader's Choice Award Winner for best database on Linux. http://ads.osdn.com/?ad_id=5588&alloc_id=12065&op=click _______________________________________________ hsqldb-developers mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/hsqldb-developers ------------------------------------------------------- This SF.Net email is sponsored by: Sybase ASE Linux Express Edition - download now for FREE LinuxWorld Reader's Choice Award Winner for best database on Linux. http://ads.osdn.com/?ad_id=5588&alloc_id=12065&op=click _______________________________________________ hsqldb-developers mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/hsqldb-developers
