Drupax

as drupaldocs' "about" says:

This site is powered by the api module written by Jonathan Chaffer.

the api.module, in turn

is an implementation of a subset of the Doxygen documentation generator specification, tuned to produce output that best benefits the Drupal code base.

more specifically,

it is designed to assume the code it documents follows Drupal coding conventions,
and [only] supports the following Doxygen constructs: @mainpage, @file, @defgroup, @ingroup, @addtogroup (as a synonym of @ ingroup), @param, @return, @link, @{, @}

the bug tracking, feature requests, etc seen at http://drupal.org/project/issues are provided by drupal (itself, indeed) in combination with drupals project.module.

for this site's drupal doxygen doc is here.

note that to be able to generate doxygen doc for drupal, you have to patch doxygen to recognise .module and .theme files as PHP-files (doxygen by default only recognises files with the extensions .php, .php4, .inc or .phtml as PHP sources). to do so, search the doxygen source for ".php" and add ".module" and ".theme" to the respective places (like here). if you should have trouble with this, i can send you a patch.

I was trying to understand a modified version of the invite module which I will call newinvite and so I downloaded this Doxygen.txt file into the module directory and did:

ln -s newinvite.module newinvite.module.php
doxygen Doxygen.txt newinvite.module.php

In a few seconds I had a great directory (drupal-phpdoc) full of html documentation for that module including crosslinked source/docs -- Awsome

No hacking the source code to Doxygen just a standard install.

A few more minutes to get the graphviz did not seem to make it better, even though Doxygen stopped saying it could not find DOT. Perhaps because my Fedora 5 has doxygen-1.4.6-3. and I was ignoring these errors.

Warning: ignoring unsupported tag `REFERENCES_LINK_SOURCE =' at line 589, file Doxyfile.txt
Warning: ignoring unsupported tag `CALLER_GRAPH =' at line 1160, file Doxyfile.txt

But with a simple install I was able to get great documentation. I am very happy.

Hi ax, can you show me the files under your ~/share/doxygen/ such as ~/share/doxygen/header.html, ~/share/doxygen/doxygen.css ?

Thank you!
Hiweed

here they are. a happy new year!

Thaaaaaaaaaaaaaaank yoooooooooooooou sooooooooooooooooo muuuuuuuuuuuch!
:-)

Hiweed

Thank you so much, ax!
Under your help, I have modified the doxygen's source code and I am making the source code now.

Thanks again!

Hiweed

i had to temporarily disable the updates because the latest cvs which the doc is made from is also what this site is running on - and the theme changes break my theme quite bad. it has to do with the problems goba mentions on the mailing list - $theme class variables being (re)used in various theme functions.

well - i setup another drupal tree (core + contrib) and let the doc generate from this until my theme works with the latest changes. should be available from the homepage in a minute.

Yeah, we knew these changes would cause many themes to break. That is why we tried to get the changes into CVS as soon as possible. Now everyone has plenty of time to work on this before 4.4.

Maybe you could post your problems on the Dev list? It would help everyone see if there really is a big problem.

BTW I did not really want to mention this, because I do not want people to do it. But there is still a global theme class there. It is used to store the theme name, and theme path. If you really want to do a hack in your theme you could use this data structure just like the old theme system, just included it in your theme functions using global.

But in the long run you will no want to be using this, because you should only use the API, and not rely on data structures that could change again.

(i'll run out of disk space sooner or later) - i think this should be done at drupal.org. i proposed this while ago; kjartan said he'll check out MHonArc again and see if it is worth changing to it - unfortunately, this never happened (or he found it not worth changing).

if some collective reminders may help? ;)

New Drupal archives using mharc. Might still tweak things for a while, but things are working well so far.

(the font size?) ah - the power of css ;)