Re: How to build new html help on mac?

[Mojca M. <moj...@gm...>]

2011/2/26 Hans-Bernhard Bröker <HBB...@t-...>:
> On 26.02.2011 22:45, Mojca Miklavec wrote:
>
>> Would it be
>> possible to get that html-like content somehow, that is the last step
>> before the final chm file is created?
>
> doc2html.c is similar enough to the existing doc2{something}.c programs we
> already have.  It should build on MacOS, too.

I have tried, but I don't manage to build it. The best I can do is the
following (inside docs/Makefile):

doc2html: doc2html.o termdoc.o xref.o
  $(LINK) doc2html.o termdoc.o $(LIBS)

doc2html.o: windows/doc2html.c $(BUILT_SOURCES)
  $(COMPILE) -DALL_TERM_DOC -c $(srcdir)/windows/doc2html.c

gnuplotx.html: doc2html $(srcdir)/gnuplot.doc
  ./windows/doc2html $(srcdir)/gnuplot.doc
$(srcdir)/windows/wgnuplot.html $(srcdir)/windows/wgnuplot.hhc

But it misses version data:

gcc -g -O2 -ObjC -L/opt/local/lib -L/opt/local/lib -L/opt/local/lib
-L/opt/local/lib -L/opt/local/lib -o doc2html doc2html.o termdoc.o
-laquaterm  -framework Foundation -L/opt/local/lib -lz
-lpangocairo-1.0 -lcairo -lpangoft2-1.0 -lpango-1.0 -lm -lfreetype
-lfontconfig -lgobject-2.0 -lgmodule-2.0 -lgthread-2.0 -lglib-2.0
-lintl
Undefined symbols:
  "_gnuplot_patchlevel", referenced from:
      _convert in doc2html.o
  "_parse", referenced from:
      _main in doc2html.o
  "_gnuplot_version", referenced from:
      _convert in doc2html.o
  "_list_free", referenced from:
      _convert in doc2html.o
  "_lookup", referenced from:
      _process_line in doc2html.o
ld: symbol(s) not found
collect2: ld returned 1 exit status
make: *** [doc2html] Error 1

>> Would it be possible to generalize the code to the extent that one
>> would also get one html page per help item when requested?
>
> Maybe you're trying too hard.
>
> Why not just use makeinfo on the texinfo rendition of gnuplot.doc? There's a
> ready-made target in docs/Makefile.in for that, already.  Just drop the
> --no-split and it'll generate one file per node just fine.

And what if I want figures as well (and don't want the "previous",
"up", "next", even though this second one is probably easier than
getting images)?

Unrelated question: why doesn't `image` (for example on rgbimage)
point anywhere?

Thanks,
    Mojca