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 fr33domlo...@mailoo.org Hello, I'm writing software in C++, and I use Doxygen for API docs. I noticed that mm-common comes with a doxygen file for libstdc++, so all mm-common users (gtkmm, glibmm, etc.) can refer to it. But it seems to download 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 shipped 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 all. Hi, Not sure if I understood your question correctly, but the reason mm-common downloads libstdc++ doxytags file from gcc.gnu.org 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. http://cppreference.com is a good 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 cross-references. 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 ++-docs-4.8.2/html/api/libstdc++.tag 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. Thanks! fr33domlover ___ gtkmm-list mailing list gtkmm-list@gnome.org https://mail.gnome.org/mailman/listinfo/gtkmm-list ___ gtkmm-list mailing list gtkmm-list@gnome.org https://mail.gnome.org/mailman/listinfo/gtkmm-list
Re: Referring to libstdc++
Anyone has an advice for me? On ו', 2013-10-11 at 12:36 +0300, fr33domlover wrote: Hello, I'm writing software in C++, and I use Doxygen for API docs. I noticed that mm-common comes with a doxygen file for libstdc++, so all mm-common users (gtkmm, glibmm, etc.) can refer to it. But it seems to download 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 shipped 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 all. I always use web resources for C++, and I'd like to have at least the C ++ standard library in Devhelp. http://cppreference.com is a good 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 cross-references. 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? Thanks! fr33domlover ___ gtkmm-list mailing list gtkmm-list@gnome.org https://mail.gnome.org/mailman/listinfo/gtkmm-list ___ gtkmm-list mailing list gtkmm-list@gnome.org https://mail.gnome.org/mailman/listinfo/gtkmm-list
Re: Referring to libstdc++
On Tue, 2013-10-29 at 16:23 +0200, fr33domlover wrote: Is there a reason a doxygen doc package for libstdc++ is not shipped with GNU/Linux distros? Isn't this something that you would ask a distro packager about? -- Murray Cumming murr...@murrayc.com www.murrayc.com www.openismus.com ___ gtkmm-list mailing list gtkmm-list@gnome.org https://mail.gnome.org/mailman/listinfo/gtkmm-list
Re: Referring to libstdc++
2013/10/11 fr33domlover fr33domlo...@mailoo.org Hello, I'm writing software in C++, and I use Doxygen for API docs. I noticed that mm-common comes with a doxygen file for libstdc++, so all mm-common users (gtkmm, glibmm, etc.) can refer to it. But it seems to download 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 shipped 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 all. Hi, Not sure if I understood your question correctly, but the reason mm-common downloads libstdc++ doxytags file from gcc.gnu.org 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. http://cppreference.com is a good 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 cross-references. 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++-docs-4.8.2/html/api/libstdc++.tag 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. Thanks! fr33domlover ___ gtkmm-list mailing list gtkmm-list@gnome.org https://mail.gnome.org/mailman/listinfo/gtkmm-list ___ gtkmm-list mailing list gtkmm-list@gnome.org https://mail.gnome.org/mailman/listinfo/gtkmm-list
