Re: HTML help on Windows

[Hans-Bernhard B. <HBB...@t-...>]

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.