On 07/17/2013 04:53:36 AM, Robert P. J. Day wrote:
On Sat, 13 Jul 2013, Rob Landley wrote:
> On 07/10/2013 06:44:30 AM, Robert P. J. Day wrote:
> >
> > i suspect others already know this but if you insist on running
> > xmlto with "xhtml" as an argument, all the HTML pages end up with
> > synopses where the string "fsfunc" is stuck to the beginning of
every
> > routine name. a simple fix is to back off and ask for simply HTML:
>
> Blah, I tested this and was going to forward it but my darn
nebook's been
> crashing ever since I let steam install the binary video drivers
FTL wanted.
>
> Acked-by: Rob Landley <rob@xxxxxxxxxxx>
>
> Rob
>
> > diff --git a/Documentation/DocBook/Makefile
> > b/Documentation/DocBook/Makefile
> > index bc3d9f8..5cf621b 100644
> > --- a/Documentation/DocBook/Makefile
> > +++ b/Documentation/DocBook/Makefile
> > @@ -145,7 +145,7 @@ build_main_index = rm -rf $(main_idx); \
> > cat $(HTML) >> $(main_idx)
> >
> > quiet_cmd_db2html = HTML $@
> > - cmd_db2html = xmlto xhtml $(XMLTOFLAGS) -o $(patsubst
%.html,%,$@) $<
> > && \
> > + cmd_db2html = xmlto html $(XMLTOFLAGS) -o $(patsubst
%.html,%,$@) $<
> > && \
> > echo '<a HREF="$(patsubst %.html,%,$(notdir
$@))/index.html">
> > \
> > $(patsubst %.html,%,$(notdir $@))</a><p>' > $@
oh, i just noticed that you'd actually CCed this to
trivial@xxxxxxxxxx, i never submitted the patch myself since i didn't
realize that was the appropriate fix. does anyone know if there is a
patch in the works to actually fix the docbook toolchain so that xhtml
generation works properly? for now, of course, there seems to be no
downside to just backing off to html.
I thought I'd cc'd trivial.
My 6 month contract at cray ended friday and I might have some time in
August to catch up on things like setting up my own git tree to feed
into linux-next. At the moment, still catching up on email between
bouts of niecephew wrangling.
I have actual make htmldocs regression test scripts that post the
results to kernel.org/doc but that last part went away when they went
all nutso locking the barn door after the horses escaped with the last
breakin, and now you have to do all access through a bespoke tool
(because nothing says "secure" like "we wrote it ourselves") that was
not designed with non-git use cases in mind. So getting that working
again is on the todo list.
Rob--
To unsubscribe from this list: send the line "unsubscribe linux-doc" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
