bug-texinfo
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: .devhelp generator for --html mode in makeinfo


From: Dimitri John Ledkov
Subject: Re: .devhelp generator for --html mode in makeinfo
Date: Mon, 16 Mar 2015 22:09:18 +0000

Hello,

On 16 March 2015 at 10:53, Gavin Smith <address@hidden> wrote:
>
> On 15 March 2015 at 22:33, Dimitri John Ledkov <address@hidden> wrote:
> > Hello,
> >
> > It would be tremendously useful to have makeinfo --html to generate .devhelp
> > file. That way GNU developer documentation (e.g. gcc/automake/autoconf)
> > could be searched and viewed using GNOME Devhelp and thus have one more way
> > to be viewed.
> >
> > In the past texi2html output was scanned and processed to generate a
> > .devhelp file.
> >
> > All that .devhelp file has is essentially indexes and metadata:
> > * document info
> > * Table of Context
> > * Reference Index of Symbols
> >
>
> Can you point to documentation of the .devhelp format? From what you
> have listed I don't think it would be difficult to output a file with
> this information. HTML+Devhelp could be supported as an additional
> output format.
>

I've assembled things from devhelp git tree & debian python docs
packaging into one place here with comments:

https://people.debian.org/~xnox/devhelp/

It has the twenty line dtd description of the xml .devhelp format,
sample output for python3.4 docs in python3.4.devhelp, script which
processes python's html docs to generate .devhelp, and the broken
texi2html based script to process html into .devhelp.

This should be all that's needed to understand the format - it really
is a flat TOC & flat Index with links to html pages / anchors.

> > I quickly looked at tp/Texinfo/Convert but I am struggling to learn it as to
> > how to make HTML.pm generate one more file with xml index in the devhelp
> > format.
>
> What I would think is to have a flag variable saying whether to output
> a Devhelp file, which would be set depending on the options given to
> makeinfo. Elements for index entry commands are processed a few
> places: _convert_index_command, _convert_def_line_type, and
> _convert_item_command. However it might be possible to output the
> index information somewhere else. URL's to the referents of the index
> entries could be generated by looking at the collected index
> information available from "$self->{'parser'}->indices_information()".
> See the _prepare_index_entries for an example. The file could be
> output by the "output" function in HTML.pm, or possibly by a different
> function called directly from texi2any.pl.

yeah, ideally makeinfo html options would grow --generate-devhelp
flag, which for $foo.html would generate $foo.devhelp next to it.

Thanks for pointing out converter entry points. I'll look into that
when I have time.

-- 
Regards,

Dimitri.



reply via email to

[Prev in Thread] Current Thread [Next in Thread]