#573832 doxygen: C symbols manpages generated with extra leading underscore

Package:
doxygen
Source:
doxygen
Description:
Documentation system for C, C++, Java, Python and other languages
Submitter:
Lucas Nussbaum
Date:
2025-08-17 17:47:25 UTC
Severity:
normal
Tags:
#573832#5
Date:
2010-03-13 08:20:31 UTC
From:
To:
Hi,

During a rebuild of all packages in sid, your package failed to build on
amd64.

Relevant part:
http://people.debian.org/~lucas/logs/2010/03/12/libthai_0.1.14-1_lsid64.buildlog

A list of current common problems and possible solutions is available at
http://wiki.debian.org/qa.debian.org/FTBFS . You're welcome to contribute!

About the archive rebuild: The rebuild was done on about 50 AMD64 nodes
of the Grid'5000 platform, using a clean chroot.  Internet was not
accessible from the build systems.

#573832#10
Date:
2010-03-14 08:18:07 UTC
From:
To:
I'm using cowbuilder 0.61 with the latest sid-amd64 basepath which
I could build this package just fine.

But the error still occured if I build it using pbuilder with sid-amd64 img.

Cheers,
Neutron

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

Kernel: Linux 2.6.32-2-amd64 (SMP w/2 CPU cores)
Locale: LANG=th_TH.UTF-8, LC_CTYPE=th_TH.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash
iEYEARECAAYFAkucm7kACgkQ1k7Ar9TO/TeCDgCgg0fn7MR5/h5VLXPev+YaaV5n
gTkAoNO1Q1uT1xixiWkZ1tH6ESaqbVqz
=wCCw
-----END PGP SIGNATURE-----

#573832#15
Date:
2010-03-14 09:44:49 UTC
From:
To:
So, the last time that the build is OK due to
the pbuilder options that I set to "-B" the binary only
which does not build the -doc, therefore the errors does not
occured.

Finally, I build without the "-B" option, still have the problems.

Downgrade the doxygen solve this, may be the changes in new doxygen
cause of this problem.


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

Kernel: Linux 2.6.32-2-amd64 (SMP w/2 CPU cores)
Locale: LANG=th_TH.UTF-8, LC_CTYPE=th_TH.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash
iEYEARECAAYFAkucsA0ACgkQ1k7Ar9TO/TcrAACfYR0HbfBNr84CeRK07InAOQkq
6uwAmwe8W6ZqaWSt+4GtiVfSy/J/LokU
=VH1B
-----END PGP SIGNATURE-----

#573832#20
Date:
2010-03-14 10:07:16 UTC
From:
To:
Thanks for the test. Yes, the real fix should be done in doxygen instead.
But as the manpages are not used in Debian anyways, I'll fix it by
not building it at all. Only html is enough.

Regards,

#573832#25
Date:
2010-03-14 10:19:06 UTC
From:
To:
clone 573663 -1
reassign -1 doxygen
retitle -1 doxygen: C symbols manpages generated with extra leading underscore
severity -1 normal
thanks

Cloning the bug for doxygen before working around libthai.

Regards,

#573832#40
Date:
2010-12-01 00:47:54 UTC
From:
To:
As far as I can tell, man pages for C symbols are broken in Debian
with no work around.  Instead of symbols like krb5_init_context I get
_krb5_init_context.3.

#573832#49
Date:
2013-08-23 15:11:22 UTC
From:
To:
I have tried to reproduce this problem on wheezy in the following way:

0) create one temporary empty directory
mkdir /tmp/aaa; cd /tmp/aaa

1) download one of the files containing the functions whose man pages
would not be generated in libthai
wget http://sources.debian.net/src/libthai/0.1.19-2/src/thbrk/thbrk.c

2) generate a default Doxyfile
doxygen -g > /dev/null

3) patch the generated Doxyfile as per attached patch
patch Doxyfile patch

4) launch doxygen
doxygen

The man pages are then generated:
ls man/man3/ -l
-rw-r--r-- 1 paolog paolog   19 ago 23 17:06 MAX_ACRONYM_FRAG_LEN.3
-rw-r--r-- 1 paolog paolog   19 ago 23 17:06 th_brk.3
-rw-r--r-- 1 paolog paolog 2138 ago 23 17:08 thbrk.c.3
-rw-r--r-- 1 paolog paolog   19 ago 23 17:06 th_brk_line.3
-rw-r--r-- 1 paolog paolog   19 ago 23 17:06 thbrk_on_unload.3

cat man/man3/th_brk_line.3
.so man3/thbrk.c.3

cd man
man man3/th_brk_line.3

I guess either some old doxygen bug or some incorrect settings in the
Doxyfile found in libthai sources. I have checked the latest Doxyfile here:
http://sources.debian.net/src/libthai/0.1.19-2/doc/Doxyfile.in
It has the following relevant differences w.r.t. my Doxyfile:
EXTRACT_ALL is set to NO (I set it to YES)
GENERATE_MAN is set to NO (I set it to YES)

I suggest the submitters give it a new try.
Debian Release: 7.1
  500 stable-updates  mi.mirror.garr.it
  500 stable          security.debian.org
  500 stable          mi.mirror.garr.it
--- Package information. ---
Depends            (Version) | Installed
============================-+-==============
libc6          (>= 2.3.6-6~) | 2.13-38
libgcc1         (>= 1:4.1.1) | 1:4.7.2-5
libstdc++6        (>= 4.1.1) | 4.7.2-5


Recommends         (Version) | Installed
============================-+-===========
doxygen-latex                | 1.8.1.2-2


Suggests         (Version) | Installed
==========================-+-===========
doxygen-doc                | 1.8.1.2-2
doxygen-gui                | 1.8.1.2-2
graphviz                   | 2.26.3-14

#573832#60
Date:
2020-04-17 20:45:31 UTC
From:
To:
Hi,

I have cloned the libthai repo: https://salsa.debian.org/debian/libthai

and built it on sid. Then I did:

cd doc
vi Doxyfile # set GENERATE_MAN = YES
doxygen
ls -l man/man3/
...
-rw-r--r-- 1 root root  1941 Apr 17 22:35 thwcoll.h.3
-rw-r--r-- 1 root root    21 Apr 17 22:35 th_wcstrcoll.3
-rw-r--r-- 1 root root    21 Apr 17 22:35 th_wcstrxfrm.3
-rw-r--r-- 1 root root  2986 Apr 17 22:35 thwctype.h.3
-rw-r--r-- 1 root root    21 Apr 17 22:35 th_winthai2uni.3
-rw-r--r-- 1 root root    20 Apr 17 22:35 th_wnormalize.3
-rw-r--r-- 1 root root  1267 Apr 17 22:35 thwstr.h.3
-rw-r--r-- 1 root root   390 Apr 17 22:35 tis.h.3
-rw-r--r-- 1 root root    17 Apr 17 22:35 TONE.3
-rw-r--r-- 1 root root    20 Apr 17 22:35 top.3
-rw-r--r-- 1 root root    17 Apr 17 22:35 WTTClass.3
-rw-r--r-- 1 root root  6275 Apr 17 22:35 wtt.h.3
-rw-r--r-- 1 root root    17 Apr 17 22:35 WTTOp.3
-rw-r--r-- 1 root root    17 Apr 17 22:35 XC.3

The generated man pages look fine:
man -l ./man/man3/thbrk.h.3
see attachment.

I guess you can turn on again manpages generation in libthai.

If you agree, please close this bug.

Paolo