Re: Referring to libstdc++

Thanks, that's the answer I was looking for.

In my view, libstdc++ is not different from any other library - just
like you view API refs of GNOME libraries in Devhelp, you can view the
standard C++ library's docs - for exactly the same reason and with the
same convenience.

I'm creating a template for C++ projects using autotools (mm-common is
for C++ *bindings*, which is different) to use in my projects, and soon
I'll reach the part where I need to take care of generation of
documentation. Then I will try to do what you suggest, and install
libstdc++ docs in a separate globally-accessible manner.

Then, maybe I'll contact distro packagers and see if they can run the
script to generate a data package for libstdc++ (or add it to the
libstdc++ docs package) and distribute it.

On ג', 2013-10-29 at 17:07 +0100, Krzesimir Nowak wrote:
2013/10/11 fr33domlover <fr33domlover mailoo org>
        I'm writing software in C++, and I use Doxygen for API docs. I
        that mm-common comes with a doxygen file for libstdc++, so all
        users (gtkmm, glibmm, etc.) can refer to it. But it seems to
        its own specific copy instead of having full shared docs for
        all C++
        APIS to refer to, and allow the user access to full std
        namespace docs.
        Is there a reason a doxygen doc package for libstdc++ is not
        with GNU/Linux distros? IIRC I saw HTML docs in Fedora, but
        they weren't
        available from Devhelp. And in Debian I don't see such docs at


Not sure if I understood your question correctly, but the reason
mm-common downloads libstdc++ doxytags file from is that
there is no standard way of getting a path to a distro-specific copy
of it. And adding distro-specific hacks for it is full of yuck.

        I always use web resources for C++, and I'd like to have at
        least the C
        ++ standard library in Devhelp. is a
        example, I use it a lot. Having it as a package on the desktop
        would be
        amazing, although having it alone doesn't allow immediately
        I use GNOME 3.4.2 so maybe things changed since then. What is
        the recent
        approach for referencing the std namespace in Doxygen and
        having the
        whole libstdc++ doxygen docs visible in Devhelp?

As you may deduce from what I said - there's possibly no standard way
of referencing std namespace in Doxygen (which boils down to pointing
doxygen to libstdc++.tag).

As of libstdc++ and doxygen - devhelp is mostly for viewing docs
generated by gtk-doc, not devhelp. But in mm-common there's a
stylesheet tagfile-to-devhelp2.xsl, so in theory you could do
something like this on Fedora 19:

xsltproc --stringparam book_title "libstdc++" --stringparam book_name
"C++ standard library" --stringparam book_base "" -o libstdc
++.devhelp2 tagfile-to-devhelp2.xsl /usr/share/doc/libstdc

The resulting libstdc++.devhelp2 file should be put
to /usr/share/devhelp/books/libstdc++ directory.

I haven't tried that though - never felt the need of it.

        gtkmm-list mailing list
        gtkmm-list gnome org

[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]