Bug#682934: freefoam: The -doc and -srcDoc options fail to find the Doxygen docs

[Michael Wild]

Package: freefoam
Version: 0.1.0-1
Severity: normal
Tags: upstream patch

Dear Maintainer,

When using the -doc or -srcDoc options, the Doxygen docs are not found. There
are three problems:

1. The file /usr/share/freefoam/DoxyDocIndex is in the libfreefoam-dev package,
   while it should be in freefoam-dev-doc.

2. The file /usr/share/freefoam/DoxyDocIndex assumes that the documentation is
   in /usr/share/doc/freefoam/API, while it actually is in
   /usr/share/doc/freefoam-dev-doc/API. This can be solved by either symlinking
   that directory or by patching DoxyDocIndex.

3. The DoxyDocIndex uses an old name-mangling assumption of Doxygen. When looking
   for the source documentation (-srcDoc option) it assumes that the documentation
   file ends in *-source.html, while Doxygen versions newer than 1.5.7 use
   *_source.html. This problem is fixed in upstream:
   http://repo.or.cz/w/freefoam.git?a=commit;h71a4abe02b972e10e8e232e85836b2e2252ee064

-- System Information:
Debian Release: wheezy/sid
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: amd64 (x86_64)

Kernel: Linux 3.2.0-27-generic (SMP w/4 CPU cores)
Locale: LANG=C, LC_CTYPE=en_US.UTF-8 (charmap=ANSI_X3.4-1968) (ignored: LC_ALL set to C)
Shell: /bin/sh linked to /bin/dash

Versions of packages freefoam depends on:
ii  libc6            2.13-34
ii  libfreefoam      0.1.0-1
ii  libgcc1          1:4.7.1-5
ii  libreadline6     6.2-8
ii  libstdc++6       4.7.1-5
ii  mpi-default-bin  1.0.1
ii  python           2.7.3-1
ii  tcsh [c-shell]   6.18.01-2
ii  zlib1g           1:1.2.7.dfsg-13

freefoam recommends no packages.

freefoam suggests no packages.

-- no debconf information
-------------- next part --------------
A non-text attachment was scrubbed...
Name: doxygen-generated-file-names-breakage.diff
Type: text/x-diff
Size: 2671 bytes
Desc: not available
URL: <http://lists.alioth.debian.org/pipermail/debian-science-maintainers/attachments/20120727/c3ca1b28/attachment.diff>