[Wigwam-devel] wigwam documentation stuff

[Heather L. S. <he...@id...>]

I feel like I'm channelling the past :-)

1) at wigwam.sourceforge.net there's a broken link  off documentation to
"documentation as one page" (it would be really, really nice if there were
PDF versions of the docs there).     

2) at http://sourceforge.net/docman/?group_id=16596 there's no
documentation at all.  Shouldn't there be?

3) Is the sourceforge CVS copy the master?  The README in wigwam-base-46
that I checked out says:

  This wigwam-base project was moved to sourceforge
  no more development should happen in this idealab! cvs repository.

  the tag right before all the files were removed is:

    daveb-move-to-sf

  Thank you.

This seems totally wrong -- I'll update it, I guess.

4) INSTALL says "please see user docs... for now".  Guess what,  I'm trying
to process these.  I'll update this to say "run autogen.sh, then run make,
(gmake under FreeBSD)"  It would be really nice if there were a list of the
stuff you should have installed first (automake, sgmltools-lite, dia,
anything else?).  Presumably I should include a "you probably don't really
want this, you probably want wigwam-bootstrap instead" comment.

5) The make file doesn't work at all with make under FreeBSD, and doesn't
quite work with gmake under FreeBSD.  

On erie they (respectively) report:

erie% make
Making all in build-scripts
Making all in misc-scripts
"Makefile", line 203: Need an operator
"Makefile", line 209: Need an operator
"Makefile", line 210: Need an operator
"Makefile", line 211: Need an operator
"Makefile", line 215: Need an operator
"Makefile", line 216: Need an operator
"Makefile", line 217: Need an operator
make: fatal errors encountered -- cannot continue
*** Error code 1

Stop in /mnt/godfather/idealab/home/heather/cvs/wigwam-base.
erie% gmake
Making all in build-scripts
gmake[1]: Entering directory
`/mnt/godfather/idealab/home/heather/cvs/wigwam-base/build-scripts'
gmake[1]: Nothing to be done for `all'.
gmake[1]: Leaving directory
`/mnt/godfather/idealab/home/heather/cvs/wigwam-base/build-scripts'
Making all in misc-scripts
gmake[1]: Entering directory
`/mnt/godfather/idealab/home/heather/cvs/wigwam-base/misc-scripts'
Makefile:203: *** missing separator.  Stop.
gmake[1]: Leaving directory
`/mnt/godfather/idealab/home/heather/cvs/wigwam-base/misc-scripts'
gmake: *** [all-recursive] Error 1

Am I just stupid?

6) gmake in just doc doesn't work -- even doing stuff which shouldn't
need any dia conversions results in:

erie% make process.ps
../misc-scripts/convert-sgml process.sgml ps:process.ps
../misc-scripts/convert-sgml: dia failed.
dia output: 
dia output: Gtk-WARNING **: cannot open display: 
cat: /tmp/diaxserver-45535: No such file or directory
usage: kill [-s signal_name] pid ...
       kill -l [exit_status]
       kill -signal_name pid ...
       kill -signal_number pid ...
rm: /tmp/diaxserver-45535: No such file or directory
*** Error code 1

Stop in /mnt/godfather/idealab/home/heather/cvs/wigwam-base/doc.
erie% make wigwam.ps
../misc-scripts/convert-sgml wigwam.sgml ps:wigwam.ps
../misc-scripts/convert-sgml: dia failed.
dia output: 
dia output: Gtk-WARNING **: cannot open display: 
cat: /tmp/diaxserver-45577: No such file or directory
usage: kill [-s signal_name] pid ...
       kill -l [exit_status]
       kill -signal_name pid ...
       kill -signal_number pid ...
rm: /tmp/diaxserver-45577: No such file or directory
*** Error code 1

Why is dia being invoked in such a way that it requires a functioning X
server from make?  Ah.  Because:

wigwam-base (3.0.15)

  * Publication showstoppers fixed by mrad.
  * convert-sgml no longer requires an X server, even if dia is run,
    unless Xvfb is not available.

And Xvfb appears not to be on erie.  For the nonce, I conclude: "Dia blows".

'tany rate, does anyone have a current wigwam.ps that I can print out for
myDave?   He's experimenting with wigwam for a project and I want to
incorporate the confusion he's having into the documentation.   Or rather,
some reduction of the confusion . . .

Thanks,
Heather

----- End forwarded message -----