Miscodings in the XML documents

[Michio Matsuyama]

Hi,

I am a new comer of this mailing list.
I really appreciate developing Samba.

I am afraid there are two miscodings on the XML
document sources.

#1
The css file named samba.css that the HTML outputs refer
should not located in '../samba.css', but in 'samba.css'.

Following patch could resolve it:

diff -Naur docs-xml/xslt/html-common.xsl{.orig,}
--- docs-xml/xslt/html-common.xsl.orig  2017-05-30 18:08:16.753307300 +0900
+++ docs-xml/xslt/html-common.xsl       2017-06-04 22:13:15.016735100 +0900
@@ -8,7 +8,7 @@
 <xsl:param name="bridgehead.in.toc" select="1"/>
 <xsl:param name="citerefentry.link" select="'1'"/>
 <xsl:param name="css.decoration" select="1"/>
-<xsl:param name="html.stylesheet" select="'../samba.css'"/>
+<xsl:param name="html.stylesheet" select="'samba.css'"/>
 <xsl:param name="html.stylesheet.type">text/css</xsl:param>
 <xsl:param name="use.extensions" select="'0'"/>
 <xsl:param name="use.id.as.filename" select="'1'"/>


#2
Texiinfo documents could not be built.  Executing the command
'make texiinfo' would report an error, '*.texi: No such file
or directory'.

This is because the basename of the output files created by
$(DB2TEXI), *.texi, and the basename of the input files used
by makeinfo are different, then makeinfo could not find the
input file.

I do not know precisely about Dockbook2x, but one way I
find that solve this problem is by modifying the executing
command as follows:

diff -Naur docs-xml/Makefile{.orig,}
--- docs-xml/Makefile.orig       2017-05-30 18:08:15.957705900 +0900
+++ docs-xml/Makefile    2017-06-04 22:33:46.753697400 +0900
@@ -207,7 +207,7 @@
 # Texinfo docs
 $(TEXINFODIR)/%.texi: $(DOCBOOKDIR)/%.xml
        @mkdir -p $(@D)
-       cd $(@D) && $(DB2TEXI) $(shell pwd)/$<
+       cd $(@D) && $(DB2TEXI) --to-stdout $(shell pwd)/$< >../../$@

 $(TEXINFODIR)/%.info: $(TEXINFODIR)/%.texi
        $(MAKEINFO) --no-validate --force -o $@ "$<"


regards,
matsuand