AW: automake help

[Bastian M. <bma...@we...>]

wxWidgets can use a help format (htb), which is actually similar to what is
used for chm files on Windows.
The idea was to use that as online help on non-Windows platforms eventually.
In fact, Dan Sebald worked on that:
https://sourceforge.net/p/gnuplot/patches/707/
(but as is this patch breaks the original use on Windows)

So in short, doc2html works as intended on Windows (all sections), but as of
now the doc2wxhtml variant is not in use.

The Makefile code changed, but the original commit was (Changelog.3):

2011-03-07  Bastian Maerkisch  <bma...@we...>

	* docs/Makefile.in: add new target 'htb' to create help file
	compatible with wxWidgets help viewer


> -----Ursprüngliche Nachricht-----
> Von: sfeam [mailto:sf...@us...]
> Gesendet: Dienstag, 23. Mai 2017 06:23
> An: gnu...@li...
> Cc: Allin Cottrell <cot...@wf...>
> Betreff: Re: automake help
> 
> On Monday, 22 May 2017 08:06:18 PM Allin Cottrell wrote:
> > On Mon, 22 May 2017, Ethan A Merritt wrote:
> >
> > > Current cvs for 5.1 and 5.2 has an odd automake glitch that I do not
> > > understand.
> > >
> > > "make" run on linux creates a file
> > >    docs/windows/doc2wxhtml-doc2html.o
> > > that surely isn't needed.
> > >
> > > "make dist" includes that file in the generated tarball.
> > > Other *.o files are discarded when packing up the files for
> > > distribution.  Why not this one?
> > > Why does it even exist in the first place?
> >
> > In docs/Makefile.am, the EXTRA_DIST variable includes "windows". Not
> > sure, but I guess that would drag in anything that gets created in the
> > windows directory?
> 
> Correct.
> 
> > (Unless one builds out of tree, which is generally a good idea
> > anyway.)
> 
> The same thing happens for an out of tree build.
> 
> > In docs/Makefile.in we have references to this thing
> > windows/doc2wxhtml-doc2html.o. That's the only object file to be
> > written into the docs/windows directory, all the others just go into
> > docs. That itself seems like an anomaly.
> 
> I agree.
> 
> > "Not needed": well, it's "needed" to build the program doc2wxhtml,
> > which is apparently not being marked as platform-specific. Is that
> > wanted in connection with the wxt terminal at all?
> 
> Not that I can see.  The program source windows/doc2html.c contains the
> comment
> /*
>  * doc2html.c  -- program to convert Gnuplot .DOC format to MS Windows
>  * HTML help (.html) format.
> 
> So I think it is only needed for windows. By the way, when I run the
program it
> only processes Part I of the documentation.  Parts 2-5 are ignored.
> So the program may have bugs separate from this build problem.
> 
> 	Ethan
> 
> 
> > Allin Cottrell
>