Eric Covener | 11 Aug 20:27 2010
Picon

Re: svn commit: r984428 - in /httpd/httpd/branches/2.2.x/docs/manual: programs/httpd.html.en programs/httpd.xml.ko programs/httpd.xml.meta programs/httpd.xml.tr vhosts/mass.html.en vhosts/mass.xml

> --- httpd/httpd/branches/2.2.x/docs/manual/programs/httpd.html.en (original)
> +++ httpd/httpd/branches/2.2.x/docs/manual/programs/httpd.html.en Wed Aug 11 14:54:08 2010
>  <at>  <at>  -142,6 +142,10  <at>  <at>  places where the directive is valid.</dd
>  <dd>Show the settings as parsed from the config file (currently only
>  shows the virtualhost settings).</dd>
>
> +<dt><code>-T</code></dt>
> +
> +<dd>Skip document root check at startup/restart.</dd>
> +
>  <dt><code>-t</code></dt>

worth a note about compatability?

--

-- 
Eric Covener
covener <at> gmail.com
Rich Bowen | 11 Aug 20:40 2010

Re: svn commit: r984428 - in /httpd/httpd/branches/2.2.x/docs/manual: programs/httpd.html.en programs/httpd.xml.ko programs/httpd.xml.meta programs/httpd.xml.tr vhosts/mass.html.en vhosts/mass.xml


On Aug 11, 2010, at 2:27 PM, Eric Covener wrote:

>> --- httpd/httpd/branches/2.2.x/docs/manual/programs/httpd.html.en  
>> (original)
>> +++ httpd/httpd/branches/2.2.x/docs/manual/programs/httpd.html.en  
>> Wed Aug 11 14:54:08 2010
>>  <at>  <at>  -142,6 +142,10  <at>  <at>  places where the directive is valid.</dd
>>  <dd>Show the settings as parsed from the config file (currently only
>>  shows the virtualhost settings).</dd>
>>
>> +<dt><code>-T</code></dt>
>> +
>> +<dd>Skip document root check at startup/restart.</dd>
>> +
>>  <dt><code>-t</code></dt>
>
> worth a note about compatability?

Yes please.

--
Rich Bowen
rbowen <at> rcbowen.com
Tony Stevenson | 25 Aug 02:18 2010

[bugzilla <at> apache.org: DO NOT REPLY [Bug 49818] Documentation URL scheme "Current version in particular language" like /docs/current/en/ FAILS with 404 (Not found)]

----- Forwarded message from bugzilla <at> apache.org -----

Date: Tue, 24 Aug 2010 11:20:41 -0400 (EDT)
From: bugzilla <at> apache.org
To: bugs <at> httpd.apache.org
Subject: DO NOT REPLY [Bug 49818] Documentation URL scheme "Current version
	in particular language" like /docs/current/en/ FAILS with 404 (Not found)

https://issues.apache.org/bugzilla/show_bug.cgi?id=49818

--- Comment #1 from Rainer Jung <rainer.jung <at> kippdata.de> 2010-08-24 11:20:38 EDT ---
Note: this only happens for the "/current/ docs. Version "/2.2" and "/trunk"
work fine, so I guess the config httpd.apache.org is incomplete with respect to
the various manual versions served.

-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: bugs-unsubscribe <at> httpd.apache.org
For additional commands, e-mail: bugs-help <at> httpd.apache.org

----- End forwarded message -----

--

-- 
Cheers,
Tony

(Continue reading)

Tony Stevenson | 25 Aug 12:39 2010

Re: Broken language links in "/current/" httpd docs

On Wed, Aug 25, 2010 at 12:33:46PM +0200, Rainer Jung wrote:
> Hi Infra,
> 
> there's a BZ 49818 about broken language links on
> 
> http://httpd.apache.org/docs/current/
> 
> It seems the feature "current" docs was introduced in the live
> config by Tony end of July in revisions 775995 and 775996 of the
> infra repos.
> 
> I don't know by which means the language links are handled at the
> moment in the web server config, but it only works for "/trunk/" and
> the normal versions "/2.0/" and "/2.2/".

I'l take a look. Thanks. 

> 
> Regards,
> 
> Rainer
> 

--

-- 
Cheers,
Tony

--------------------------------------------                                                                                                                                                                                                                                          
Tony Stevenson                                                                                                                                                                                                                                                                        

(Continue reading)

Rich Bowen | 25 Aug 14:59 2010

Re: Broken language links in "/current/" httpd docs


On Aug 25, 2010, at 6:39 AM, Tony Stevenson wrote:

there's a BZ 49818 about broken language links on

http://httpd.apache.org/docs/current/

It seems the feature "current" docs was introduced in the live
config by Tony end of July in revisions 775995 and 775996 of the
infra repos.

I don't know by which means the language links are handled at the
moment in the web server config, but it only works for "/trunk/" and
the normal versions "/2.0/" and "/2.2/".

Oops. We forgot that bit. I don't remember how the language links are handled, either. But I'm pretty sure that we didn't consider that in the rewrite rules.

--
Rich Bowen



Rich Bowen | 25 Aug 16:37 2010

Re: [users <at> httpd] Re: how to needed for apache

James,

It would be very instructive if you could provide us with a list of what you consider the "basic things" that are missing.

Thanks.

On Aug 24, 2010, at 2:31 PM, James Godrej wrote:

Thanks for the update Williams.But I wont be buying any books.
I will write some document let my work finish here.
There are a lot of basic things missing.




--
Rich Bowen



Rich Bowen | 25 Aug 16:59 2010

Re: how to needed for apache


On Aug 25, 2010, at 10:44 AM, James Godrej wrote:



See when some one uses Apache for the first time they are not aware of a  lot of things.
The term definition of virtual host itself is quite confusing for newbies.
What is a VirtualHost and why is that used.

How's this for a definition:

------------
The term Virtual Host refers to the practice of running more than one web site (such as www.company1.com and www.company2.com) on a single machine. Virtual hosts can be "IP-based", meaning that you have a different IP address for every web site, or "name-based", meaning that you have multiple names running on each IP address. The fact that they are running on the same physical server is not apparent to the end user.
-------------

That is the definition copied and pasted directly from the documentation. Please feel free to enhance it, or clarify it, in any way that seems best to you, and let us know what you come up with. That was the best I could do.


This is the examples doc, and references the main VirtualHosts document, which defines what a virtualhost is. We can't repeat the definition on every page, but we can certainly link to the definition when the term is used. I've added this link this morning.

Some one reading the above doc for the first time surely may not be clear.
Having said that if some people are able to understand that does not mean that the doc is really Great.
You do give an example 
but among the list of other directives 
what is the meaning of word directive with reference to Apache.

Why is a directive being used at all.
Sure there are other pages which do mention what you just said but then again this is as if 
I write a  module for /proc file system and ask some one to read
fs/proc/version.c
and ask the guy to find  what seq_files are doing and how are they being used.

Some people may understand some may not.

I'm at a bit of a loss to know how to respond to this.

On the one hand, yes, we need to define our terms.

On the other hand, it's not at all clear to me that it is the responsibility of the Apache httpd documentation to introduce to the reader the concept of a server and the concept of a configuration file. We've rather intentionally stayed away from being a tutorial on system management, editing files, or managing your DNS server, and we'll probably continue to hold that line.

Having said that, no, I don't think I can find anywhere in the documentation where we define the term "Directive" except for here: http://httpd.apache.org/docs/2.2/glossary.html#directive




The documentation that you people have does have some technical references.
But I see a lot of blogs forums and links here and there and questions which newbies do suffer
that included me.
Did I answer your question?

Well, a little. You gave two specific examples, one of which I fixed while writing this email, and the other of which I'm really quite uncertain is an actual problem, but I'm willing to see what solutions you propose for it.

We are, always, very welcoming of actual patches to the documentation. General "you suck" kinds of criticisms tend to be received much less gracefully. I'm sure you can understand this, given that I have spent considerable portions of the last ten years writing the documentation, and, so, feel somewhat personally indicted when you say that it is missing "a lot of basic things."

However, I *think* that the direction you're going is that every time we use a basic term we need to define it, and I don't have any objection to that position. That's what we were trying to do with the glossary, and we could probably do a better job of linking to the relevant term in the glossary when a new term is used in a document. I don't object to that at all.


--

Ruediger Pluem | 25 Aug 21:50 2010
Picon

Re: Broken language links in "/current/" httpd docs


On 08/25/2010 12:39 PM, Tony Stevenson wrote:
> On Wed, Aug 25, 2010 at 12:33:46PM +0200, Rainer Jung wrote:
>> Hi Infra,
>>
>> there's a BZ 49818 about broken language links on
>>
>> http://httpd.apache.org/docs/current/
>>
>> It seems the feature "current" docs was introduced in the live
>> config by Tony end of July in revisions 775995 and 775996 of the
>> infra repos.
>>
>> I don't know by which means the language links are handled at the
>> moment in the web server config, but it only works for "/trunk/" and
>> the normal versions "/2.0/" and "/2.2/".
> 
> 
> I'l take a look. Thanks. 

I guess the following patch will fix this:

Index: httpd.apache.org.conf
===================================================================
--- httpd.apache.org.conf       (Revision 776334)
+++ httpd.apache.org.conf       (Arbeitskopie)
 <at>  <at>  -14,10 +14,10  <at>  <at> 
    </Directory>

   # virtualize the language sub"directories"
-  AliasMatch ^(/docs/(?:2\.[0-3]|trunk))(?:/(?:de|en|es|fr|ja|ko|pt-br|ru|tr))?(/.*)?$ \
+  AliasMatch
^(/docs/(?:2\.[0-3]|trunk|current))(?:/(?:de|en|es|fr|ja|ko|pt-br|ru|tr))?(/.*)?$ \
       /x1/www/httpd.apache.org$1$2

-  <DirectoryMatch "/x1/www/httpd.apache.org/docs/(2\..|trunk)">
+  <DirectoryMatch "/x1/www/httpd.apache.org/docs/(2\.[0-3]|trunk)">
     Options -Multiviews
     <Files *.html>
         SetHandler type-map
 <at>  <at>  -28,11 +28,11  <at>  <at> 
     </Files>

     # Tell mod_negotiation which language to prefer
-    SetEnvIf Request_URI   ^/docs/(?:2\..|trunk)/(de|en|es|fr|ja|ko|pt-br|ru|tr)/ \
+    SetEnvIf Request_URI   ^/docs/(?:2\.[0-3]|trunk|current)/(de|en|es|fr|ja|ko|pt-br|ru|tr)/ \
         prefer-language=$1

     # Deal with language switching (/docs/2.0/de/en/... -> /docs/2.0/en/...)
-    RedirectMatch 301 ^(/docs/(?:2\..|trunk))(?:/(de|en|es|fr|ja|ko|pt-br|ru|tr)){2,}(/.*)?$ \
+    RedirectMatch 301
^(/docs/(?:2\.[0-3]|trunk|current))(?:/(de|en|es|fr|ja|ko|pt-br|ru|tr)){2,}(/.*)?$ \
         $1/$2$3
   </DirectoryMatch>

Regards

Rüdiger
Rich Bowen | 25 Aug 21:57 2010

Re: Broken language links in "/current/" httpd docs

Looks right to me.

On Aug 25, 2010, at 3:50 PM, Ruediger Pluem wrote:

>
>
> On 08/25/2010 12:39 PM, Tony Stevenson wrote:
>> On Wed, Aug 25, 2010 at 12:33:46PM +0200, Rainer Jung wrote:
>>> Hi Infra,
>>>
>>> there's a BZ 49818 about broken language links on
>>>
>>> http://httpd.apache.org/docs/current/
>>>
>>> It seems the feature "current" docs was introduced in the live
>>> config by Tony end of July in revisions 775995 and 775996 of the
>>> infra repos.
>>>
>>> I don't know by which means the language links are handled at the
>>> moment in the web server config, but it only works for "/trunk/" and
>>> the normal versions "/2.0/" and "/2.2/".
>>
>>
>> I'l take a look. Thanks.
>
> I guess the following patch will fix this:
>
>
> Index: httpd.apache.org.conf
> ===================================================================
> --- httpd.apache.org.conf       (Revision 776334)
> +++ httpd.apache.org.conf       (Arbeitskopie)
>  <at>  <at>  -14,10 +14,10  <at>  <at> 
>    </Directory>
>
>   # virtualize the language sub"directories"
> -  AliasMatch ^(/docs/(?:2\.[0-3]|trunk))(?:/(?:de|en|es|fr|ja|ko|pt- 
> br|ru|tr))?(/.*)?$ \
> +  AliasMatch ^(/docs/(?:2\.[0-3]|trunk|current))(?:/(?:de|en|es|fr| 
> ja|ko|pt-br|ru|tr))?(/.*)?$ \
>       /x1/www/httpd.apache.org$1$2
>
> -  <DirectoryMatch "/x1/www/httpd.apache.org/docs/(2\..|trunk)">
> +  <DirectoryMatch "/x1/www/httpd.apache.org/docs/(2\.[0-3]|trunk)">
>     Options -Multiviews
>     <Files *.html>
>         SetHandler type-map
>  <at>  <at>  -28,11 +28,11  <at>  <at> 
>     </Files>
>
>     # Tell mod_negotiation which language to prefer
> -    SetEnvIf Request_URI   ^/docs/(?:2\..|trunk)/(de|en|es|fr|ja|ko| 
> pt-br|ru|tr)/ \
> +    SetEnvIf Request_URI   ^/docs/(?:2\.[0-3]|trunk|current)/(de|en| 
> es|fr|ja|ko|pt-br|ru|tr)/ \
>         prefer-language=$1
>
>     # Deal with language switching (/docs/2.0/de/en/... -> /docs/2.0/ 
> en/...)
> -    RedirectMatch 301 ^(/docs/(?:2\..|trunk))(?:/(de|en|es|fr|ja|ko| 
> pt-br|ru|tr)){2,}(/.*)?$ \
> +    RedirectMatch 301 ^(/docs/(?:2\.[0-3]|trunk|current))(?:/(de|en| 
> es|fr|ja|ko|pt-br|ru|tr)){2,}(/.*)?$ \
>         $1/$2$3
>   </DirectoryMatch>
>
>
> Regards
>
> Rüdiger
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docs-unsubscribe <at> httpd.apache.org
> For additional commands, e-mail: docs-help <at> httpd.apache.org
>

--
Rich Bowen
rbowen <at> rcbowen.com

Gmane