You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by sl...@locus.apache.org on 2000/09/29 00:55:31 UTC
cvs commit: httpd-docs-1.3/htdocs/manual/mod index.html index-bytype.html mod_example.html
slive 00/09/28 15:55:31
Modified: htdocs/manual/mod index.html index-bytype.html
mod_example.html
Log:
Now that we have compatibility info consistently in the module docs,
I don't see any reason to have it in the index, where it was
inconsistent, and made things harder to read.
Revision Changes Path
1.35 +10 -10 httpd-docs-1.3/htdocs/manual/mod/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/mod/index.html,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -r1.34 -r1.35
--- index.html 2000/09/25 23:55:47 1.34
+++ index.html 2000/09/28 22:55:30 1.35
@@ -69,11 +69,11 @@
<DD>Replaced in 1.3b6 by mod_so
<DT><A HREF="mod_env.html">mod_env</A>
<DD>Passing of environments to CGI scripts
-<DT><A HREF="mod_example.html">mod_example</A> Apache 1.2 and up
+<DT><A HREF="mod_example.html">mod_example</A>
<DD>Demonstrates Apache API
-<DT><A HREF="mod_expires.html">mod_expires</A> Apache 1.2 and up
+<DT><A HREF="mod_expires.html">mod_expires</A>
<DD>Apply Expires: headers to resources
-<DT><A HREF="mod_headers.html">mod_headers</A> Apache 1.2 and up
+<DT><A HREF="mod_headers.html">mod_headers</A>
<DD>Add arbitrary HTTP headers to resources
<DT><A HREF="mod_imap.html">mod_imap</A>
<DD>The imagemap file handler.
@@ -102,23 +102,23 @@
<DD>Content negotiation.
<DT><A HREF="mod_proxy.html">mod_proxy</A>
<DD>Caching proxy abilities
-<DT><A HREF="mod_rewrite.html">mod_rewrite</A> Apache 1.2 and up
+<DT><A HREF="mod_rewrite.html">mod_rewrite</A>
<DD>Powerful URI-to-filename mapping using regular expressions
-<DT><A HREF="mod_setenvif.html">mod_setenvif</A> Apache 1.3 and up
+<DT><A HREF="mod_setenvif.html">mod_setenvif</A>
<DD>Set environment variables based on client information
-<DT><A HREF="mod_so.html">mod_so</A> Apache 1.3 and up
+<DT><A HREF="mod_so.html">mod_so</A>
<DD>Experimental support for loading modules (DLLs on Windows) at runtime
-<DT><A HREF="mod_speling.html">mod_speling</A> Apache 1.3 and up
+<DT><A HREF="mod_speling.html">mod_speling</A>
<DD>Automatically correct minor typos in URLs
<DT><A HREF="mod_status.html">mod_status</A>
<DD>Server status display
<DT><A HREF="mod_userdir.html">mod_userdir</A>
<DD>User home directories.
-<DT><A HREF="mod_unique_id.html">mod_unique_id</A> Apache 1.3 and up
+<DT><A HREF="mod_unique_id.html">mod_unique_id</A>
<DD>Generate unique request identifier for every request
-<DT><A HREF="mod_usertrack.html">mod_usertrack</A> Apache 1.2 and up
+<DT><A HREF="mod_usertrack.html">mod_usertrack</A>
<DD>User tracking using Cookies (replacement for mod_cookies.c)
-<DT><A HREF="mod_vhost_alias.html">mod_vhost_alias</A> Apache 1.3.7 and up
+<DT><A HREF="mod_vhost_alias.html">mod_vhost_alias</A>
<DD>Support for dynamically configured mass virtual hosting
</DL>
1.7 +10 -10 httpd-docs-1.3/htdocs/manual/mod/index-bytype.html
Index: index-bytype.html
===================================================================
RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/mod/index-bytype.html,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- index-bytype.html 2000/09/25 23:55:47 1.6
+++ index-bytype.html 2000/09/28 22:55:30 1.7
@@ -37,9 +37,9 @@
<DL>
<DT><A HREF="mod_env.html">mod_env</A>
<DD>Passing of environments to CGI scripts
-<DT><A HREF="mod_setenvif.html">mod_setenvif</A> Apache 1.3 and up
+<DT><A HREF="mod_setenvif.html">mod_setenvif</A>
<DD>Set environment variables based on client information
-<DT><A HREF="mod_unique_id.html">mod_unique_id</A> Apache 1.3 and up
+<DT><A HREF="mod_unique_id.html">mod_unique_id</A>
<DD>Generate unique request identifier for every request
</DL>
@@ -60,13 +60,13 @@
<DT><A HREF="mod_alias.html">mod_alias</A>
<DD>Mapping different parts of the host filesystem in the document tree,
and URL redirection.
-<DT><A HREF="mod_rewrite.html">mod_rewrite</A> Apache 1.2 and up
+<DT><A HREF="mod_rewrite.html">mod_rewrite</A>
<DD>Powerful URI-to-filename mapping using regular expressions
<DT><A HREF="mod_userdir.html">mod_userdir</A>
<DD>User home directories.
-<DT><A HREF="mod_speling.html">mod_speling</A> Apache 1.3 and up
+<DT><A HREF="mod_speling.html">mod_speling</A>
<DD>Automatically correct minor typos in URLs
-<DT><A HREF="mod_vhost_alias.html">mod_vhost_alias</A> Apache 1.3.7 and up
+<DT><A HREF="mod_vhost_alias.html">mod_vhost_alias</A>
<DD>Support for dynamically configured mass virtual hosting
</DL>
@@ -102,11 +102,11 @@
<H2>HTTP Response</H2>
<DL>
-<DT><A HREF="mod_headers.html">mod_headers</A> Apache 1.2 and up
+<DT><A HREF="mod_headers.html">mod_headers</A>
<DD>Add arbitrary HTTP headers to resources
<DT><A HREF="mod_cern_meta.html">mod_cern_meta</A>
<DD>Support for HTTP header metafiles.
-<DT><A HREF="mod_expires.html">mod_expires</A> Apache 1.2 and up
+<DT><A HREF="mod_expires.html">mod_expires</A>
<DD>Apply Expires: headers to resources
<DT><A HREF="mod_asis.html">mod_asis</A>
<DD>Sending files which contain their own HTTP headers.
@@ -143,7 +143,7 @@
<DD>Logging of User Agents.
<DT><A HREF="mod_log_referer.html">mod_log_referer</A>
<DD>Logging of document references.
-<DT><A HREF="mod_usertrack.html">mod_usertrack</A> Apache 1.2 and up
+<DT><A HREF="mod_usertrack.html">mod_usertrack</A>
<DD>User tracking using Cookies (replacement for mod_cookies.c)
</DL>
@@ -154,7 +154,7 @@
<DD>The imagemap file handler.
<DT><A HREF="mod_proxy.html">mod_proxy</A>
<DD>Caching proxy abilities
-<DT><A HREF="mod_so.html">mod_so</A> Apache 1.3 and up
+<DT><A HREF="mod_so.html">mod_so</A>
<DD>Experimental support for loading modules (DLLs on Windows) at runtime
<DT><A HREF="mod_mmap_static.html">mod_mmap_static</A>
<DD>Mapping files into memory for faster serving.
@@ -164,7 +164,7 @@
<H2>Development</H2>
<DL>
-<DT><A HREF="mod_example.html">mod_example</A> Apache 1.2 and up
+<DT><A HREF="mod_example.html">mod_example</A>
<DD>Demonstrates Apache API
</DL>
1.10 +5 -0 httpd-docs-1.3/htdocs/manual/mod/mod_example.html
Index: mod_example.html
===================================================================
RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/mod/mod_example.html,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- mod_example.html 2000/09/28 22:42:13 1.9
+++ mod_example.html 2000/09/28 22:55:30 1.10
@@ -38,6 +38,11 @@
HREF="module-dict.html#ModuleIdentifier"
REL="Help"
><STRONG>Module Identifier:</STRONG></A> example_module
+<BR>
+<A
+HREF="module-dict.html#Compatibility"
+REL="Help"
+><STRONG>Compatibility:</STRONG></A> Available in Apache 1.2 and later.
</P>
Re: cvs commit: httpd-docs-1.3/htdocs/manual/mod index.html index-bytype.html mod_example.html
Posted by Tony Finch <do...@dotat.at>.
Joshua Slive <sl...@finance.commerce.ubc.ca> wrote:
>
>However, I disagree with your logic. You are essentially assuming that
>people with Apache 1.2 are going to be coming to the website and trying to
>use the 1.3 docs, and that we should be trying to make life very easy for
>them.
They should in fact be using http://www.apache.org/docs-1.2/
Tony.
--
en oeccget g mtcaa f.a.n.finch
v spdlkishrhtewe y dot@dotat.at
eatp o v eiti i d. fanf@covalent.net
Re: cvs commit: httpd-docs-1.3/htdocs/manual/mod index.html
index-bytype.html mod_example.html
Posted by Joshua Slive <sl...@finance.commerce.ubc.ca>.
On Sat, 30 Sep 2000, Tony Finch wrote:
> Damn, too late now. Most of the compatibility stuff you ditched
> deserved to be removed, but for the 1.3 newcomers mod_vhost_alias and
> mod_auth_digest I think it should stay.
>
I agree. I think that is a good compromise. If a couple other people
agree, I will do that. Otherwise, I'll leave it as is.
(It's no big deal going back and forth on this. I doubt I've spent
more than 20 minutes on this topic.)
Joshua.
Re: cvs commit: httpd-docs-1.3/htdocs/manual/mod index.html index-bytype.html mod_example.html
Posted by Tony Finch <do...@dotat.at>.
Joshua Slive <sl...@finance.commerce.ubc.ca> wrote:
>
>Check the results of what I did. (Sorry, the comment on the commit was
>probably not detailed enough.) I left in the compatibility info for all
>the obsolete modules. I only removed it for modules that are still in the
>distribution, but were introduced after 1.0.
Damn, too late now. Most of the compatibility stuff you ditched
deserved to be removed, but for the 1.3 newcomers mod_vhost_alias and
mod_auth_digest I think it should stay.
Tony.
--
en oeccget g mtcaa f.a.n.finch
v spdlkishrhtewe y dot@dotat.at
eatp o v eiti i d. fanf@covalent.net
Re: cvs commit: httpd-docs-1.3/htdocs/manual/mod index.html
index-bytype.html mod_example.html
Posted by Joshua Slive <sl...@finance.commerce.ubc.ca>.
On Fri, 29 Sep 2000, Raymond S Brand wrote:
> What about obsolete directives? Ken's comment applies to them also.
>
I assume you mean "modules" not "directives". The directives index has
never had compatibility info.
Check the results of what I did. (Sorry, the comment on the commit was
probably not detailed enough.) I left in the compatibility info for all
the obsolete modules. I only removed it for modules that are still in the
distribution, but were introduced after 1.0.
Joshua.
Re: cvs commit: httpd-docs-1.3/htdocs/manual/mod index.html
index-bytype.html mod_example.html
Posted by Raymond S Brand <rs...@gate.net>.
What about obsolete directives? Ken's comment applies to them also.
Raymond S Brand
Joshua Slive wrote:
>
> On Fri, 29 Sep 2000, Rodent of Unusual Size wrote:
>
> > Raymond S Brand wrote:
> > >
> > > This change bothers me, but I don't have a strong objection to it.
> >
> > Yes, it's not particularly friendly to require someone to have
> > to drill down just to find out he can't use something. Please
> > reconsider this, Joshua.
>
> Given that people feel that way, I'll reverse it.
>
> However, I disagree with your logic. You are essentially assuming that
> people with Apache 1.2 are going to be coming to the website and trying to
> use the 1.3 docs, and that we should be trying to make life very easy for
> them. (There was one module that was added during 1.3.whatever, but that
> is clearly the exception.) I have left in the information that tells
> people which modules are obsolete, so they won't have to go looking
> through mod_cookies or mod_log_common.
>
> In my opinion, the information people are much more likely interested in
> having "at a glance" is whether they can actually use a module "right
> now". This would be the "status" rather than the "compatibility".
> The presence of compatibility in this index seems to be a historic
> artifact, rather than a planned decision.
>
> I addition, the presence of that extra bit of information made the index
> considerably busier visually, and therefore harder to skim.
>
> Anyway, unless you change your mind, I will reverse it.
>
> Joshua.
Re: cvs commit: httpd-docs-1.3/htdocs/manual/mod index.html
index-bytype.html mod_example.html
Posted by Joshua Slive <sl...@finance.commerce.ubc.ca>.
On Fri, 29 Sep 2000, Rodent of Unusual Size wrote:
> Raymond S Brand wrote:
> >
> > This change bothers me, but I don't have a strong objection to it.
>
> Yes, it's not particularly friendly to require someone to have
> to drill down just to find out he can't use something. Please
> reconsider this, Joshua.
Given that people feel that way, I'll reverse it.
However, I disagree with your logic. You are essentially assuming that
people with Apache 1.2 are going to be coming to the website and trying to
use the 1.3 docs, and that we should be trying to make life very easy for
them. (There was one module that was added during 1.3.whatever, but that
is clearly the exception.) I have left in the information that tells
people which modules are obsolete, so they won't have to go looking
through mod_cookies or mod_log_common.
In my opinion, the information people are much more likely interested in
having "at a glance" is whether they can actually use a module "right
now". This would be the "status" rather than the "compatibility".
The presence of compatibility in this index seems to be a historic
artifact, rather than a planned decision.
I addition, the presence of that extra bit of information made the index
considerably busier visually, and therefore harder to skim.
Anyway, unless you change your mind, I will reverse it.
Joshua.
Re: cvs commit: httpd-docs-1.3/htdocs/manual/mod index.html
index-bytype.html mod_example.html
Posted by Rodent of Unusual Size <Ke...@Golux.Com>.
Raymond S Brand wrote:
>
> This change bothers me, but I don't have a strong objection to it.
Yes, it's not particularly friendly to require someone to have
to drill down just to find out he can't use something. Please
reconsider this, Joshua.
--
#ken P-)}
Ken Coar <http://Golux.Com/coar/>
Apache Software Foundation <http://www.apache.org/>
"Apache Server for Dummies" <http://Apache-Server.Com/>
"Apache Server Unleashed" <http://ApacheUnleashed.Com/>
Re: cvs commit: httpd-docs-1.3/htdocs/manual/mod index.html
index-bytype.html mod_example.html
Posted by Raymond S Brand <rs...@gate.net>.
This change bothers me, but I don't have a strong objection to it.
Raymond S Brand
slive@locus.apache.org wrote:
>
> slive 00/09/28 15:55:31
>
> Modified: htdocs/manual/mod index.html index-bytype.html
> mod_example.html
> Log:
> Now that we have compatibility info consistently in the module docs,
> I don't see any reason to have it in the index, where it was
> inconsistent, and made things harder to read.
>
> Revision Changes Path
> 1.35 +10 -10 httpd-docs-1.3/htdocs/manual/mod/index.html
>