You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@httpd.apache.org by Rodent of Unusual Size <co...@decus.org> on 1997/11/03 01:15:40 UTC
Separate apache.org docs
The issue of which docs are visible from Apache.Org has come up a
few times recently, prompted by people reading the 1.3 docs and
complaining that the features aren't in 1.2.4.
I've been thinking (oh, no!) about this a little bit, and the big
question in my mind is whether the mirrors would go for replicating
an entire separate doc tree. If they will, then I think we should
do it. Further, I think the header.html and footer.html files
should be modified appropriately so they clearly state the version.
Something like the attached patch, perhaps.
So.. how about <http://www.apache.org/docs/1.2/> and
<http://www.apache.org/docs/1.3/> for new locations? Basically move
the current docs/* into docs/1.3, and checkout -rAPACHE_1_2_X into
docs/1.2?
#ken P-)}
Index: footer.html
===================================================================
RCS file: /export/home/cvs/apachen/htdocs/manual/footer.html,v
retrieving revision 1.2
diff -u -r1.2 footer.html
--- footer.html 1996/11/21 10:47:09 1.2
+++ footer.html 1997/11/03 00:26:39
@@ -1,3 +1,6 @@
<HR>
+ <H3 ALIGN="CENTER">
+ Apache HTTP Server Version 1.3
+ </H3>
<A HREF="./"><IMG SRC="images/index.gif" ALT="Index"></A>
Index: header.html
===================================================================
RCS file: /export/home/cvs/apachen/htdocs/manual/header.html,v
retrieving revision 1.2
diff -u -r1.2 header.html
--- header.html 1997/06/04 02:55:15 1.2
+++ header.html 1997/11/03 00:26:41
@@ -1,3 +1,6 @@
<DIV ALIGN="CENTER">
<IMG SRC="images/sub.gif" ALT="[APACHE DOCUMENTATION]">
+ <H3>
+ Apache HTTP Server Version 1.3
+ </H3>
</DIV>
Index: misc/footer.html
===================================================================
RCS file: /export/home/cvs/apachen/htdocs/manual/misc/footer.html,v
retrieving revision 1.2
diff -u -r1.2 footer.html
--- footer.html 1996/11/21 09:55:48 1.2
+++ footer.html 1997/11/03 00:26:44
@@ -1,4 +1,8 @@
<HR>
+<H3 ALIGN="CENTER">
+ Apache HTTP Server Version 1.3
+</H3>
+
<A HREF="./"><IMG SRC="../images/index.gif" ALT="Index"></A>
<A HREF="../"><IMG SRC="../images/home.gif" ALT="Home"></A>
Index: misc/header.html
===================================================================
RCS file: /export/home/cvs/apachen/htdocs/manual/misc/header.html,v
retrieving revision 1.2
diff -u -r1.2 header.html
--- header.html 1997/06/04 11:42:57 1.2
+++ header.html 1997/11/03 00:26:47
@@ -1,3 +1,6 @@
<DIV ALIGN="CENTER">
<IMG SRC="../images/sub.gif" ALT="[APACHE DOCUMENTATION]">
+ <H3>
+ Apache HTTP Server Version 1.3
+ </H3>
</DIV>
Index: mod/footer.html
===================================================================
RCS file: /export/home/cvs/apachen/htdocs/manual/mod/footer.html,v
retrieving revision 1.2
diff -u -r1.2 footer.html
--- footer.html 1996/11/21 10:30:35 1.2
+++ footer.html 1997/11/03 00:26:49
@@ -1,4 +1,8 @@
<HR>
+<H3 ALIGN="CENTER">
+ Apache HTTP Server Version 1.3
+</H3>
+
<A HREF="./"><IMG SRC="../images/index.gif" ALT="Index"></A>
<A HREF="../"><IMG SRC="../images/home.gif" ALT="Home"></A>
Index: mod/header.html
===================================================================
RCS file: /export/home/cvs/apachen/htdocs/manual/mod/header.html,v
retrieving revision 1.2
diff -u -r1.2 header.html
--- header.html 1997/06/04 16:14:14 1.2
+++ header.html 1997/11/03 00:26:51
@@ -1,3 +1,6 @@
<DIV ALIGN="CENTER">
<IMG SRC="../images/sub.gif" ALT="[APACHE DOCUMENTATION]">
+ <H3>
+ Apache HTTP Server Version 1.3
+ </H3>
</DIV>
Re: Separate apache.org docs
Posted by Dirk-Willem van Gulik <di...@elect6.jrc.it>.
On Sun, 2 Nov 1997, Rodent of Unusual Size wrote:
> The issue of which docs are visible from Apache.Org has come up a
> few times recently, prompted by people reading the 1.3 docs and
> complaining that the features aren't in 1.2.4.
Of course, the other option is a small marker near the new
features, that says something along
<code><blink colour="horrible-yellow">*NEW*</> from 1.2.4
and keep a single set of docs as they are. This could even be squeezed in
auto magically by using a clever perlscript and a cvs-export for each of
the checkpoints. Hell, you could heaven add 'depricated' flag. I
personally like scanning docs for that kind of thing.
Dw.
> I've been thinking (oh, no!) about this a little bit, and the big
> question in my mind is whether the mirrors would go for replicating
> an entire separate doc tree. If they will, then I think we should
> do it. Further, I think the header.html and footer.html files
> should be modified appropriately so they clearly state the version.
> Something like the attached patch, perhaps.
>
> So.. how about <http://www.apache.org/docs/1.2/> and
> <http://www.apache.org/docs/1.3/> for new locations? Basically move
> the current docs/* into docs/1.3, and checkout -rAPACHE_1_2_X into
> docs/1.2?
>
> #ken P-)}
>
> Index: footer.html
> ===================================================================
> RCS file: /export/home/cvs/apachen/htdocs/manual/footer.html,v
> retrieving revision 1.2
> diff -u -r1.2 footer.html
> --- footer.html 1996/11/21 10:47:09 1.2
> +++ footer.html 1997/11/03 00:26:39
> @@ -1,3 +1,6 @@
> <HR>
> + <H3 ALIGN="CENTER">
> + Apache HTTP Server Version 1.3
> + </H3>
>
> <A HREF="./"><IMG SRC="images/index.gif" ALT="Index"></A>
> Index: header.html
> ===================================================================
> RCS file: /export/home/cvs/apachen/htdocs/manual/header.html,v
> retrieving revision 1.2
> diff -u -r1.2 header.html
> --- header.html 1997/06/04 02:55:15 1.2
> +++ header.html 1997/11/03 00:26:41
> @@ -1,3 +1,6 @@
> <DIV ALIGN="CENTER">
> <IMG SRC="images/sub.gif" ALT="[APACHE DOCUMENTATION]">
> + <H3>
> + Apache HTTP Server Version 1.3
> + </H3>
> </DIV>
> Index: misc/footer.html
> ===================================================================
> RCS file: /export/home/cvs/apachen/htdocs/manual/misc/footer.html,v
> retrieving revision 1.2
> diff -u -r1.2 footer.html
> --- footer.html 1996/11/21 09:55:48 1.2
> +++ footer.html 1997/11/03 00:26:44
> @@ -1,4 +1,8 @@
> <HR>
>
> +<H3 ALIGN="CENTER">
> + Apache HTTP Server Version 1.3
> +</H3>
> +
> <A HREF="./"><IMG SRC="../images/index.gif" ALT="Index"></A>
> <A HREF="../"><IMG SRC="../images/home.gif" ALT="Home"></A>
> Index: misc/header.html
> ===================================================================
> RCS file: /export/home/cvs/apachen/htdocs/manual/misc/header.html,v
> retrieving revision 1.2
> diff -u -r1.2 header.html
> --- header.html 1997/06/04 11:42:57 1.2
> +++ header.html 1997/11/03 00:26:47
> @@ -1,3 +1,6 @@
> <DIV ALIGN="CENTER">
> <IMG SRC="../images/sub.gif" ALT="[APACHE DOCUMENTATION]">
> + <H3>
> + Apache HTTP Server Version 1.3
> + </H3>
> </DIV>
> Index: mod/footer.html
> ===================================================================
> RCS file: /export/home/cvs/apachen/htdocs/manual/mod/footer.html,v
> retrieving revision 1.2
> diff -u -r1.2 footer.html
> --- footer.html 1996/11/21 10:30:35 1.2
> +++ footer.html 1997/11/03 00:26:49
> @@ -1,4 +1,8 @@
> <HR>
>
> +<H3 ALIGN="CENTER">
> + Apache HTTP Server Version 1.3
> +</H3>
> +
> <A HREF="./"><IMG SRC="../images/index.gif" ALT="Index"></A>
> <A HREF="../"><IMG SRC="../images/home.gif" ALT="Home"></A>
> Index: mod/header.html
> ===================================================================
> RCS file: /export/home/cvs/apachen/htdocs/manual/mod/header.html,v
> retrieving revision 1.2
> diff -u -r1.2 header.html
> --- header.html 1997/06/04 16:14:14 1.2
> +++ header.html 1997/11/03 00:26:51
> @@ -1,3 +1,6 @@
> <DIV ALIGN="CENTER">
> <IMG SRC="../images/sub.gif" ALT="[APACHE DOCUMENTATION]">
> + <H3>
> + Apache HTTP Server Version 1.3
> + </H3>
> </DIV>
>
Re: Separate apache.org docs
Posted by Dean Gaudet <dg...@arctic.org>.
Did you see my flailing around on apache-cvs trying to update the 1.2
docs? We let them slip too far -- and someone, not mentioning names!,
decided to reformat our html. So I'm tending to agree with Marc now that
it's hopeless, and something we should just remember for the future.
+1 on your change to the headers and footers.
BTW I was trying to do it in prep for a 1.2.5 release... I wouldn't mind
attending to some of the protocol bugs that we've got patches for (like
the byte-ranges, and the mod_include ETag). I'll try posting a status
this week.
Dean
On Sun, 2 Nov 1997, Rodent of Unusual Size wrote:
> The issue of which docs are visible from Apache.Org has come up a
> few times recently, prompted by people reading the 1.3 docs and
> complaining that the features aren't in 1.2.4.
>
> I've been thinking (oh, no!) about this a little bit, and the big
> question in my mind is whether the mirrors would go for replicating
> an entire separate doc tree. If they will, then I think we should
> do it. Further, I think the header.html and footer.html files
> should be modified appropriately so they clearly state the version.
> Something like the attached patch, perhaps.
>
> So.. how about <http://www.apache.org/docs/1.2/> and
> <http://www.apache.org/docs/1.3/> for new locations? Basically move
> the current docs/* into docs/1.3, and checkout -rAPACHE_1_2_X into
> docs/1.2?
>
> #ken P-)}
>
> Index: footer.html
> ===================================================================
> RCS file: /export/home/cvs/apachen/htdocs/manual/footer.html,v
> retrieving revision 1.2
> diff -u -r1.2 footer.html
> --- footer.html 1996/11/21 10:47:09 1.2
> +++ footer.html 1997/11/03 00:26:39
> @@ -1,3 +1,6 @@
> <HR>
> + <H3 ALIGN="CENTER">
> + Apache HTTP Server Version 1.3
> + </H3>
>
> <A HREF="./"><IMG SRC="images/index.gif" ALT="Index"></A>
> Index: header.html
> ===================================================================
> RCS file: /export/home/cvs/apachen/htdocs/manual/header.html,v
> retrieving revision 1.2
> diff -u -r1.2 header.html
> --- header.html 1997/06/04 02:55:15 1.2
> +++ header.html 1997/11/03 00:26:41
> @@ -1,3 +1,6 @@
> <DIV ALIGN="CENTER">
> <IMG SRC="images/sub.gif" ALT="[APACHE DOCUMENTATION]">
> + <H3>
> + Apache HTTP Server Version 1.3
> + </H3>
> </DIV>
> Index: misc/footer.html
> ===================================================================
> RCS file: /export/home/cvs/apachen/htdocs/manual/misc/footer.html,v
> retrieving revision 1.2
> diff -u -r1.2 footer.html
> --- footer.html 1996/11/21 09:55:48 1.2
> +++ footer.html 1997/11/03 00:26:44
> @@ -1,4 +1,8 @@
> <HR>
>
> +<H3 ALIGN="CENTER">
> + Apache HTTP Server Version 1.3
> +</H3>
> +
> <A HREF="./"><IMG SRC="../images/index.gif" ALT="Index"></A>
> <A HREF="../"><IMG SRC="../images/home.gif" ALT="Home"></A>
> Index: misc/header.html
> ===================================================================
> RCS file: /export/home/cvs/apachen/htdocs/manual/misc/header.html,v
> retrieving revision 1.2
> diff -u -r1.2 header.html
> --- header.html 1997/06/04 11:42:57 1.2
> +++ header.html 1997/11/03 00:26:47
> @@ -1,3 +1,6 @@
> <DIV ALIGN="CENTER">
> <IMG SRC="../images/sub.gif" ALT="[APACHE DOCUMENTATION]">
> + <H3>
> + Apache HTTP Server Version 1.3
> + </H3>
> </DIV>
> Index: mod/footer.html
> ===================================================================
> RCS file: /export/home/cvs/apachen/htdocs/manual/mod/footer.html,v
> retrieving revision 1.2
> diff -u -r1.2 footer.html
> --- footer.html 1996/11/21 10:30:35 1.2
> +++ footer.html 1997/11/03 00:26:49
> @@ -1,4 +1,8 @@
> <HR>
>
> +<H3 ALIGN="CENTER">
> + Apache HTTP Server Version 1.3
> +</H3>
> +
> <A HREF="./"><IMG SRC="../images/index.gif" ALT="Index"></A>
> <A HREF="../"><IMG SRC="../images/home.gif" ALT="Home"></A>
> Index: mod/header.html
> ===================================================================
> RCS file: /export/home/cvs/apachen/htdocs/manual/mod/header.html,v
> retrieving revision 1.2
> diff -u -r1.2 header.html
> --- header.html 1997/06/04 16:14:14 1.2
> +++ header.html 1997/11/03 00:26:51
> @@ -1,3 +1,6 @@
> <DIV ALIGN="CENTER">
> <IMG SRC="../images/sub.gif" ALT="[APACHE DOCUMENTATION]">
> + <H3>
> + Apache HTTP Server Version 1.3
> + </H3>
> </DIV>
>