Package: doxygen
Version: 1.5.6-2
Severity: normal
No documentation (beyond the files summary) was being produced for my
php files. I found out by trial and error that this is caused by certain
content within a heredoc.
In the example below, it will fail. But if you remove the first
.api_demo css rule, it will work.
IMO doxygen should be completely ignoring all content in heredocs (and
php5.3 nowdocs).
<?php
/** @file
* This text is displayed on the file page, but nothing else.
*/
/** some useful class
*/
class some_useful_class
{
/** Crude api demo
*/
public function api_demo()/*{{{*/
{
$this->story['content_main'] .=
$this->api_demo_process()
. $this->api_demo_data();
$this->story['extra_headers'] = <<<HERE
<style type='text/css' >
.api_demo { border:solid 1px #ddd; padding: 8px; font-size: 12px;
background-color:#eee;margin:5px 0; }
.api_demo .api_demo { background-color:white; }
</style>
HERE;
}/*}}}*/
}
-- System Information:
Debian Release: 5.0.8
APT prefers oldstable
APT policy: (500, 'oldstable')
Architecture: i386 (i686)
Kernel: Linux 2.6.32.26-kvm-i386-20101122 (SMP w/2 CPU cores)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8) (ignored: LC_ALL
set to en_GB.UTF-8)
Shell: /bin/sh linked to /bin/bash
Versions of packages doxygen depends on:
ii libc6 2.7-18lenny7 GNU C Library: Shared libraries
ii libgcc1 1:4.3.2-1.1 GCC support library
ii libpng12-0 1.2.27-2+lenny4 PNG library - runtime
ii libstdc++6 4.3.2-1.1 The GNU Standard C++ Library v3
doxygen recommends no packages.
Versions of packages doxygen suggests:
pn doxygen-doc <none> (no description available)
pn doxygen-gui <none> (no description available)
pn graphviz <none> (no description available)
-- no debconf information
--
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]
