httpd-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Jim Jagielski <...@jaguNET.com>
Subject Re: cvs commit: apache-1.3/src/modules/standard mod_expires.c mod_include.c mod_log_config.c mod_rewrite.c mod_usertrack.c
Date Mon, 30 Mar 1998 14:32:41 GMT
Paul Sutton wrote:
> 
> We should document API functions fully in the source
> code. It hasn't been done in the past, and that is why getting any sort of
> external documentation has been so difficult -- people have to figure out
> how things are supposed to work from the source. Look at module authors --
> they have to read the source anyway to figure things out. If there were
> comments all over, it would be unbelievably easier to write modules. 

Also, if API functions had a specific prefix, it would be even easier...
Combining API and non-API functions with the same prefix sure
avoids name-space collisions, but doesn't help the self-documenting
aspects of the code we want.
-- 
===========================================================================
   Jim Jagielski   |||   jim@jaguNET.com   |||   http://www.jaguNET.com/
            "That's no ordinary rabbit... that's the most foul,
            cruel and bad-tempered rodent you ever laid eyes on"

Mime
View raw message