Re: HTML help on Windows

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

Thanks for the offer. I will send you the files in a private mail.

I have tried your proposed directory layout:
Help files (index stub, project file) in docs/win/,
output of files (including intermediates) to config/win/

It turns out that the HTML help compiler "hhc" does not like it very 
much if files are not located in directories below the location of the 
project file (.hhp). In the case of the gnuplot help it spits out a few 
hundred errors, but the result works just fine. Guess we just ignore 
them by piping to > NUL. Otherwise we would have to copy some files
to config/win first.

Am 03.02.2011 21:20, schrieb Hans-Bernhard Bröker:
> On 03.02.2011 20:41, Bastian Märkisch wrote:
>
>> Right now I use Visual C++ to build. Could somebody using MinGW or
>> Cygwin to build on Windows please help me to integrate the new files
>> in these build systems?
>
> I can probably help. I would also like to see OpenWatcom supported
> along with the others.
>
>> Also am uncertain about the directory layout: Where should the
>> project file (wgnuplot.hhp) and the stub index file (wgnuplot.hhk)
>> go? The obvious options being docs/, config/ or src/win/ (as is the
>> case for the current help project file wgnuplot.hpj).
>
> Since it's Windows-specific, it should go into a Windows-specific
> directory. Right now we have only one of those: src/win. But a new
> docs/win directory might make sense, too.
>
> While at it, I think it would help to move the MinGW, Cygwin-MinGW,
> DJGPP and MSVC builds into a directory structure that doesn't clutter
> the main source tree (src, src/win, docs) with build-specific files.
> I've been using that kind of plan on my home box for quite a while now,
> and checked it in for OpenWatcom recently. This layout allows to keep
> current builds by all compilers alive, without having to constantly
> "make realclean" to avoid them getting into each other's way.
>
> The basic idea is to hold the primary makefile in a subdirectory of
> config, and build it such that it finds all the files in src, term,
> src/win and other places from there. In a nutshell, you just move
> Makefile.foo and the accompanying config.foo (if any) from config into a
> new directory config/foo, as Makefile and config.h. After fixing all the
> breakage from that move, you can build right in there, without any need
> for copying makefiles around.
>
>> I modified a copy of docs/plotstyles.gnu to produce png images
>> instead of pdf files. Does anybody have a nice solution how to
>> recombine those two?
>
> Hard to tell without seeing what you modified. If it's just filenames
> and terminal options, that could be encapsulated into macros or
> subroutine scripts.