Package: doxygen Followup-For: Bug #375434 With the intention of testing the latest schroot source against a doxygen in stable, I tried to reproduce this problem on wheezy with the latest version of schroot packaged in jessie (that's version 1.6.5; I could not get configure to complete with the 1.7.0 due to missing C++11 compiler support).
These are the steps: 1) get the orig package from here: http://ftp.de.debian.org/debian/pool/main/s/schroot/schroot_1.6.5.orig.tar.xz 2) tar xJf schroot_1.6.5.orig.tar.xz; cd schroot_1.6.5; ./configure 3) cd doc; doxygen schroot.dox I attach the schroot.log I get in doc as schroot0.log. There were no errors neither in the originally supplied schroot.log file nor in the new one. There were 20 warnings in the originally supplied schroot.log file, there are 19 in the new one. I am not sure if the warnings are the same. Anyway I have looked at the first warning: /home/paolog/Scaricati/schroot-1.6.5/bin/schroot/schroot-main-base.cc:74: warning: documented function `sbuild::error< main_base::error_code >::map_type sbuild::error::error_strings' was not declared or defined. Here doxygen is complaining because it does not find the declaration for the error_strings function in any of the headers it parses. The error_strings function is declared in the sbuild/sbuild-error.h file. If I look at the INPUT tag schroot.dox file, I do not find this header included. I am not sure how sbuild and schroot are related and what is the purpose of the bin directory, so I tried this hack to give doxygen access to the header file: add the ../sbuild directory to the directories specifed in the INPUT tag. This is the schroot.log Now I get the attached schroot1.log AFAICS there are new warnings related to sbuild::string_list_to_string and sbuild::string_list_to_strv, caused by doxygen not recognizing the string_list typedef, but the warning about the error_strings function is gone. I suggest the original submitter and maintainer of the schroot package patches the schroot.dox file appropriately before we evaluate any remaining warning. -- System Information: Debian Release: 7.1 APT prefers stable-updates APT policy: (500, 'stable-updates'), (500, 'stable') Architecture: i386 (i686) Kernel: Linux 3.2.0-4-686-pae (SMP w/2 CPU cores) Locale: LANG=it_IT.UTF-8, LC_CTYPE=it_IT.UTF-8 (charmap=UTF-8) Shell: /bin/sh linked to /bin/dash Versions of packages doxygen depends on: ii libc6 2.13-38 ii libgcc1 1:4.7.2-5 ii libstdc++6 4.7.2-5 Versions of packages doxygen recommends: ii doxygen-latex 1.8.1.2-2 Versions of packages doxygen suggests: ii doxygen-doc 1.8.1.2-2 pn doxygen-gui <none> ii graphviz 2.26.3-14 -- no debconf information
Notice: Output directory `schroot' does not exist. I have created it for you. error: Tag file `sbuild/sbuild.tag' does not exist or is not a file. Skipping it... /home/paolog/Scaricati/schroot-1.6.5/bin/schroot/schroot-main-base.cc:74: warning: documented function `sbuild::error< main_base::error_code >::map_type sbuild::error::error_strings' was not declared or defined. /home/paolog/Scaricati/schroot-1.6.5/bin/schroot-listmounts/schroot-listmounts-main.cc:66: warning: documented function `sbuild::error< main::error_code >::map_type sbuild::error::error_strings' was not declared or defined. /home/paolog/Scaricati/schroot-1.6.5/bin/schroot-releaselock/schroot-releaselock-main.cc:67: warning: documented function `sbuild::error< main::error_code >::map_type sbuild::error::error_strings' was not declared or defined. /home/paolog/Scaricati/schroot-1.6.5/bin/schroot/schroot-main-base.h:51: warning: Member chroot_map (typedef) of class schroot::main_base is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/schroot/schroot-main-base.h:51: warning: Member chroot_map (typedef) of class schroot::main_base is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/dchroot/dchroot-session-base.h:54: warning: Member run_impl() (function) of class dchroot::session_base is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/dchroot/dchroot-session-base.h:58: warning: Member get_command_directories(sbuild::chroot::ptr &session_chroot, sbuild::environment const &env) const (function) of class dchroot::session_base is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/dchroot/dchroot-session.h:54: warning: Member get_login_directories(sbuild::chroot::ptr &session_chroot, sbuild::environment const &env) const (function) of class dchroot::session is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/dchroot/dchroot-session.h:60: warning: Member get_user_command(sbuild::chroot::ptr &session_chroot, std::string &file, sbuild::string_list &command, sbuild::environment const &env) const (function) of class dchroot::session is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/dchroot/dchroot-session-base.h:54: warning: Member run_impl() (function) of class dchroot::session_base is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/dchroot/dchroot-session-base.h:58: warning: Member get_command_directories(sbuild::chroot::ptr &session_chroot, sbuild::environment const &env) const (function) of class dchroot::session_base is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/schroot/schroot-main-base.h:51: warning: Member chroot_map (typedef) of class schroot::main_base is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/dchroot-dsa/dchroot-dsa-session.h:54: warning: Member get_login_directories(sbuild::chroot::ptr &session_chroot, sbuild::environment const &env) const (function) of class dchroot_dsa::session is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/dchroot-dsa/dchroot-dsa-session.h:60: warning: Member get_user_command(sbuild::chroot::ptr &session_chroot, std::string &file, sbuild::string_list &command, sbuild::environment const &env) const (function) of class dchroot_dsa::session is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/dchroot/dchroot-session-base.h:54: warning: Member run_impl() (function) of class dchroot::session_base is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/dchroot/dchroot-session-base.h:58: warning: Member get_command_directories(sbuild::chroot::ptr &session_chroot, sbuild::environment const &env) const (function) of class dchroot::session_base is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/schroot/schroot-main-base.h:51: warning: Member chroot_map (typedef) of class schroot::main_base is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/schroot/schroot-main-base.h:51: warning: Member chroot_map (typedef) of class schroot::main_base is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/schroot-base/schroot-base-options.h:64: warning: Member error(std::string const &error) (function) of class schroot_base::options::error is not documented.
/home/paolog/Scaricati/schroot-1.6.5/sbuild/sbuild-i18n.h:20: warning: the name `sbuild-i18n.h' supplied as the second argument in the \file statement matches the following input files: /home/paolog/Scaricati/schroot-1.6.5/sbuild/sbuild-i18n.h sbuild.tag:/home/paolog/Scaricati/schroot-1.6.5/sbuild/sbuild-i18n.h Please use a more specific name by including a (larger) part of the path! /home/paolog/Scaricati/schroot-1.6.5/sbuild/sbuild-tr1types.h:20: warning: the name `sbuild-tr1types.h' supplied as the second argument in the \file statement matches the following input files: /home/paolog/Scaricati/schroot-1.6.5/sbuild/sbuild-tr1types.h sbuild.tag:/home/paolog/Scaricati/schroot-1.6.5/sbuild/sbuild-tr1types.h Please use a more specific name by including a (larger) part of the path! /home/paolog/Scaricati/schroot-1.6.5/sbuild/sbuild-util.cc:258: warning: no matching file member found for std::string sbuild::string_list_to_string(const std::vector< std::string > &list, std::string const &separator) Possible candidates: 'std::string string_list_to_string(string_list const &list, std::string const &separator)' at line 1 of file /home/paolog/Scaricati/schroot-1.6.5/sbuild/sbuild-util.cc:465: warning: no matching file member found for char ** sbuild::string_list_to_strv(const std::vector< std::string > &str) Possible candidates: 'char ** string_list_to_strv(string_list const &str)' at line 1 of file /home/paolog/Scaricati/schroot-1.6.5/sbuild/sbuild-util.cc:493: warning: no matching file member found for int sbuild::exec(const std::string &file, const std::vector< std::string > &command, environment const &env) Possible candidates: 'int exec(std::string const &file, string_list const &command, environment const &env)' at line 1 of file /home/paolog/Scaricati/schroot-1.6.5/bin/schroot/schroot-main-base.h:51: warning: Member chroot_map (typedef) of class schroot::main_base is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/schroot/schroot-main-base.h:51: warning: Member chroot_map (typedef) of class schroot::main_base is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/dchroot/dchroot-session-base.h:54: warning: Member run_impl() (function) of class dchroot::session_base is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/dchroot/dchroot-session-base.h:58: warning: Member get_command_directories(sbuild::chroot::ptr &session_chroot, sbuild::environment const &env) const (function) of class dchroot::session_base is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/dchroot/dchroot-session.h:54: warning: Member get_login_directories(sbuild::chroot::ptr &session_chroot, sbuild::environment const &env) const (function) of class dchroot::session is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/dchroot/dchroot-session.h:60: warning: Member get_user_command(sbuild::chroot::ptr &session_chroot, std::string &file, sbuild::string_list &command, sbuild::environment const &env) const (function) of class dchroot::session is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/dchroot/dchroot-session-base.h:54: warning: Member run_impl() (function) of class dchroot::session_base is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/dchroot/dchroot-session-base.h:58: warning: Member get_command_directories(sbuild::chroot::ptr &session_chroot, sbuild::environment const &env) const (function) of class dchroot::session_base is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/schroot/schroot-main-base.h:51: warning: Member chroot_map (typedef) of class schroot::main_base is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/dchroot-dsa/dchroot-dsa-session.h:54: warning: Member get_login_directories(sbuild::chroot::ptr &session_chroot, sbuild::environment const &env) const (function) of class dchroot_dsa::session is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/dchroot-dsa/dchroot-dsa-session.h:60: warning: Member get_user_command(sbuild::chroot::ptr &session_chroot, std::string &file, sbuild::string_list &command, sbuild::environment const &env) const (function) of class dchroot_dsa::session is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/dchroot/dchroot-session-base.h:54: warning: Member run_impl() (function) of class dchroot::session_base is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/dchroot/dchroot-session-base.h:58: warning: Member get_command_directories(sbuild::chroot::ptr &session_chroot, sbuild::environment const &env) const (function) of class dchroot::session_base is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/schroot/schroot-main-base.h:51: warning: Member chroot_map (typedef) of class schroot::main_base is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/schroot/schroot-main-base.h:51: warning: Member chroot_map (typedef) of class schroot::main_base is not documented. /home/paolog/Scaricati/schroot-1.6.5/bin/schroot-base/schroot-base-options.h:64: warning: Member error(std::string const &error) (function) of class schroot_base::options::error is not documented.
