> 1. mpmt_pthread is a really crappy name for a module. Agreed. It is even worse because it doesn't rely on pthreads anymore. Please, if anybody can come up with a better name, we need it.
> 2. Is this format appropriate? It is modeled as closely as possible on > the new format for other modules. Looks good to me on a first pass. > 3. This is a real pain to do, because it is necessary to sift through the > source code to find what the directives are, what their default values > are, and what they actually do. (The third part is the hardest, and I > haven't really done that yet.) This module is particularly hard to > document because it has two entirely different modes: threaded and > non-threaded. They have different behaviour, and different default values > for some of the directives. I can't help how much of a pain it is, but I feel your pain. I wouldn't worry about the two modes of mpmt_pthread. It is a real PITA for the developers that this module has two modes as well. I can help with the third part of this if you want. If you create a list of directives, I can really quickly tell you what each directive does for the Unix platforms. I may try to help document the other MPMs if I have time this weekend. > 4. I believe that there are going to be many different MPMs using the > same directive names. Unless we can guarantee that all the MPMs will use > the directive in EXACTLY the same way, we will still need to document them > separately and make separate entires in directives.html. Well, we have tried to make sure that whenever a directive is used by different MPMs, that it is always implemented the same way on each platform. There are things that we can do to make sure of this, but it will probably have to wait a few weeks. Basically, we just have to make the code that implements the directives common code. If the directives aren't used the same, they shouldn't be named the same thing. I'll try to look into this after the first beta unless somebody beats me to it. > 5. I am prepared to drop mod/index-bytype.html from 2.0 since I think we > are making progress on task-oriented docs that make it irrelevant. My own opinion is to go for it. The entire server has basically been re-written in 2.0, the docs should be re-written too. :-) Ryan _______________________________________________________________________________ Ryan Bloom [EMAIL PROTECTED] 406 29th St. San Francisco, CA 94131 -------------------------------------------------------------------------------
