wigwam-devel

[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 -----

[Wigwam-devel] Re: wigwam documentation stuff

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

On Wed, Oct 31, 2001 at 06:47:26PM -0800 or thereabouts, Heather L. Sherman wrote:
> I feel like I'm channelling the past :-)

Hmmm, and like the past, much of the problems I encountered exploded from
one or two original mistakes I made, namely:

- mistakenly checking wigwam-base out from cvs.idealab.com and not
  completely removing it

- initially running autogen.sh on a Redhat box and trusting make clean (and
  make distclean) to clean things up rather than just checking out again.

So, README and INSTALL need .. something.  I'll do it.  And I still have
the problem that make does fail when it reaches docs with:

    raise IOError, "Couldn't resolve pubid [%s]" % id
IOError: Couldn't resolve pubid ["-//SGMLtools//DOCUMENT Docbook Style
Sheet for Lynx Text//EN"]
../misc-scripts/convert-sgml: error converting to text.
*** Error code 1                                                   

While just "cd docs; make wigwam.ps" is unhappy about the no X server thing

So, with luck, that last message I sent will just disappear into oblivion
and I can report only real problems and no one will realize that I am an
idiot.  Although I still consider it a valuable skill that I can emulate "the
stupidest user" so very well.

Heather