httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From André Malo ...@perlig.de>
Subject Re: [VOTE] Update our documentation building tool chain
Date Tue, 02 Oct 2018 06:57:41 GMT
On Montag, 1. Oktober 2018 23:14:58 CEST Luis Gil de Bernabé wrote:
> I have updated long ago the files from es, but i wasn't sure to commit
> them as the FR file Lucien is saying.
> So now i'm sure it could be done, i will add them to trunk (es
> modification only)

Side note here. All UTF-8 target files have .utf8 as an extension right now 
(tr for example). We might need to move all the affected files - or possibly 
revisit the httpd manual config. I guess, the former is easier (in terms of 
unexpected side effects) and more explicit.

Opinions? If nobody objects I can take care of the file moving part.

Cheers,

> 
> @Christophe JAILLET <christophe.jaillet@wanadoo.fr>  im not helpfull here,
> but i vote +1 to update our build tool :)
> rgd
> 
> On Mon, 1 Oct 2018 at 22:20, Christophe JAILLET <
> 
> christophe.jaillet@wanadoo.fr> wrote:
> > Le 29/09/2018 à 15:27, Eric Covener a écrit :
> > >> As per Xalan documentation, the JDK or JRE 1.3.x (2000), 1.4.x
> > >> (2002),
> > >> or 5.x (2004) is required.
> > >> As per our doc build documentation, we need at least Java 1.2 (1998)
> > >> to
> > >> build the doc.
> > >> Java 8 (2014) is LTS and is supported until 2025
> > >> Java 9 (2017)
> > >> Java 10 (2018)
> > >> Java 11 (2018) is apparently LTS
> > > 
> > > They don't mean minimums?
> > > 
> > > Later major JDK's (oracle, IBM) seem to all  forks of xalan as the
> > > default transformer, which might explain why there are few
> > > contemporary releases.
> > > 
> > > Do we need to bring our own at all?  Sticking with JDK interfaces has
> > > some benefits.
> > 
> > I've investigate this.
> > 
> > 1.6.5 Ant docs state that we need Xalan or another XSLT engine only if
> > we are using a version of Java older than 1.4.
> > 
> > I guess we can safely assume it is the case nowadays.
> > 
> > However, just removing the Xalan stuff from the lib directory does not
> > work.
> > There are some warnings and errors when building.
> > According to google, the warnings are more or less expected and can be
> > silently ignored, but the errors break the build process.
> > 
> > First error to trigger is (sory for the mix of English and French):
> >       [xslt] : Fatal Error! Erreur lors de la vérification du type de
> > 
> > l'expression 'filter-expr(funcall(current, []),
> > [pred(=(step("attribute", 39), literal-expr(section)))])'. Cause: Erreur
> > lors de la vérification du type de l'expression
> > 'filter-expr(funcall(current, []), [pred(=(step("attribute", 39),
> > literal-expr(section)))])'.
> > 
> > This is apparently related to synopsys.sxl.
> > 
> > If I comment:
> >     <xsl:include href="synopsis.xsl" />
> > 
> > in common.xsl, I then get another error:
> >      docs/manual/build/build.xml:383: Fatal error during transformation
> > 
> > using /home/tititou36/svn_httpd_trunk/docs/manual/style/manual.en.xsl:
> > Erreur lors de la vérification du type de l'expression
> > 'com.sun.org.apache.xalan.internal.xsltc.compiler.ForEach@329dbdbf'.
> > 
> > This one looks related to:
> >      <xsl:for-each select="httpd:override-classes($directives)">
> > 
> > in overrideindex.xsl
> > 
> > 
> > The lack of useful (at least to me) diagnostic, makes it hard to find
> > the root cause of this issues.
> > 
> > Adding -v to the Ant command line doesn't help much either.
> > 
> > 
> > So, if any one more used to the Xalan implementation provided in the JDK
> > could have a look or at least give some pointers, it would be great.
> > 
> > Based on my own tests, and searches, I won't be in any help with this
> > approach.
> > The drop-in replacement with Saxon gives much less troubles. :)
> > 
> > CJ
> > 
> > 
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
> > For additional commands, e-mail: docs-help@httpd.apache.org


"Das Verhalten von Gates hatte mir bewiesen, dass ich auf ihn und seine
beiden Gefährten nicht zu zählen brauchte" -- Karl May, "Winnetou III"

Im Westen was neues: <http://pub.perlig.de/books.html#apache2>



---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Mime
View raw message