[Dune] [Dune-Commit] dune-common r5021 - in trunk/doc: . devel doxygen

[Markus Blatt]

On Wed, Dec 05, 2007 at 06:47:26PM +0100, Andreas Dedner wrote:
> Why does the distribution have to include the documentation?

Because it is meant for distribution to "customers" and they usually
want to have the documentation as it eases programming a lot in
contrast to reading the source.

> The problem occurs in the following real world application:
> compile dune on a parallel machine like in Karlsruhe.
> The easiest way is to run a make dist in your local dune-???
> on your local computer, transfer the tar balls to the parallel
> machine, and run dune-control.

But this was totally possible, wasn't it? Ok you needed wml on the
machine you build the tarballs. But that is not really hard to install
is it.  Ok, the tarballs are bigger, but we live in post-modem times,
don't we.

Now there a quite some problems (especially for people building the
tarballs for real distribution). One will not notice if the machine
does not have the necessary software for building full tarballs and
therefore might accidentally ship tarballs without documentation.

> In this case one does not need or want to have any documentation
> included!

You do not need it, but do you really care if you have it? I guess
not. By the way: For installing the tarballs one needs neither wml nor
doxygen. 

> The fewer dependencies on not really essential packages
> there are the better IMHO.

And there is another argument: 

Building the tarballs is simply broken now:

I did a make clean, uninstalled wml, did a configure run without any
arguments, and tried a make dist. This is what I get:

mkdir -p --
/home/mblatt/dune-trunk/dune-common/dune-common-0.0/am/../am
make[1]: Leaving directory `/home/mblatt/dune-trunk/dune-common/am'
find dune-common-0.0 -type d ! -perm -777 -exec chmod a+rwx {} \; -o \
          ! -type d ! -perm -444 -links 1 -exec chmod a+r {} \; -o \
          ! -type d ! -perm -400 -exec chmod a+r {} \; -o \
          ! -type d ! -perm -444 -exec /bin/sh
	  /home/mblatt/dune-trunk/dune-common/install-sh -c -m a+r {}
	  {} \; \
        || chmod -R a+r dune-common-0.0
tardir=dune-common-0.0 && /bin/sh
/home/mblatt/dune-trunk/dune-common/missing --run tar chof - "$tardir"
| GZIP=--best gzip -c >dune-common-0.0.tar.gz
tar:
dune-common-0.0/doc/doxygen/html-dist/structDune_1_1tuple__element_3_010_00_01Pair_3_01T1_00_01T2_01_4_01_4.html:
Dateiname ist zu lang (max. 99); nicht gesichert.
tar:
dune-common-0.0/doc/doxygen/html-dist/structDune_1_1TupleToPairs_3_01T1_00_01Nil_00_01Nil_00_01Nil_00_01Nil_00_01Nil_00_01Nil_00_01Nil_00_01Nil_01_4.html:
Dateiname ist zu lang (max. 99); nicht gesichert.
tar:
dune-common-0.0/doc/doxygen/html-dist/classDune_1_1FieldMatrix_3_01K_00_011_00_011_01_4-members.html:
Dateiname ist zu lang (max. 99); nicht gesichert.
tar:
dune-common-0.0/doc/doxygen/html-dist/structDune_1_1tuple__element_3_010_00_01Pair_3_01T1_00_01T2_01_4_01_4-members.html:
Dateiname ist zu lang (max. 99); nicht gesichert.
tar:
dune-common-0.0/doc/doxygen/html-dist/structDune_1_1GridObjectStreamOrDefaultHelper_3_01false_00_01GridImp_00_01DefaultImp_01_4.html:
Dateiname ist zu lang (max. 99); nicht gesichert.
tar:
dune-common-0.0/doc/doxygen/html-dist/classDune_1_1CollectiveCommunication_3_01MPI__Comm_01_4-members.html:
Dateiname ist zu lang (max. 99); nicht gesichert.
tar:
dune-common-0.0/doc/doxygen/html-dist/structDune_1_1TupleToPairs_3_01T1_00_01Nil_00_01Nil_00_01Nil_00_01Nil_00_01Nil_00_01Nil_00_01Nil_00_01Nil_01_4-members.html:
Dateiname ist zu lang (max. 99); nicht gesichert.
tar:
dune-common-0.0/doc/doxygen/html-dist/structDune_1_1GridObjectStreamOrDefaultHelper_3_01false_00_01GridImp_00_01DefaultImp_01_4-members.html:
Dateiname ist zu lang (max. 99); nicht gesichert.
tar: Fehler beim Beenden, verursacht durch vorhergehende Fehler.
{ test ! -d dune-common-0.0 || { find dune-common-0.0 -type d ! -perm
-200 -exec chmod u+w {} ';' && rm -fr dune-common-0.0; }; }


Christian and myself spend weeks for this process to work and it took
quite some care and even crude hacks to get the state we had before
the changes. 

Now Robert ruined it just because somebody might not have
a few spare minutes to install wml or call their system
administrator. If that really is to much of an effort, one should
stick with the release tarballs!

Honestly I am fed up and angry. Maybe we should stop spending time
working at the infrastructure if it is not appreciated by our fellow
developers. (Even for us there are loads of other things to do...)

Markus

P.S.: I am still waiting for for someone writing about known issues in
dune-grid. But apparently that is issue is a lot less important to you.