Mailing-List: contact docs-help@httpd.apache.org; run by ezmlm
Precedence: bulk
Reply-To: docs@httpd.apache.org
MIME-Version: 1.0
In-Reply-To: <8B9B4190-24CE-425E-B48F-1BDBD86030FB@rcbowen.com>
References: <4B92C085.2020601@rowe-clan.net>
 <B277BE4C-2FFC-4528-86C9-6305D69E7725@rcbowen.com>
	<1404e5911003120329g7baa5cc5p8b0f91007f32c776@mail.gmail.com>
	<931022DF-463C-4A49-8A07-9CD1F585B609@rcbowen.com>
 <987950801003130841t2465af48g397458a2e05b5f36@mail.gmail.com>
	<4B9C48A4.8020809@rowe-clan.net>
 <1404e5911003160555i4e43331bxe713b94dee08d547@mail.gmail.com>
	<8B9B4190-24CE-425E-B48F-1BDBD86030FB@rcbowen.com>
From: Noirin Shirley <noirin@apache.org>
Date: Tue, 16 Mar 2010 14:13:34 +0100
Message-ID: <987950801003160613i6cdd7dc5t8a3202dd1edda6f0@mail.gmail.com>
Subject: Re: Suexec doc (Was Re: Fixing confusion of Apache vs httpd)
To: docs@httpd.apache.org
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

On Tue, Mar 16, 2010 at 2:00 PM, Rich Bowen <rbowen@rcbowen.com> wrote:
>
> On Mar 16, 2010, at 8:55 AM, Eric Covener wrote:
>
>> On Sat, Mar 13, 2010 at 10:23 PM, William A. Rowe Jr.
>> <wrowe@rowe-clan.net> wrote:
>>>
>>> On 3/13/2010 10:41 AM, Noirin Shirley wrote:
>>>>
>>>> If we're going to do a massive sed, my preference would be for Apache
>>>> HTTPD and HTTPD, because the capitalisation avoids the confusion
>>>> between httpd-the-server and httpd-the-command, and it's fewer words
>>>> :-)
>>>
>>> Please note, Apache httpd [always lower case] is the httpd (short name)
>>> application program from the Apache Software Foundation. =A0Apache HTTP
>>> Server
>>> is the title of the program. =A0The letters HTTPD in upper case are
>>> nonsense,
>>> because HTTP is capitalized as a specification and acronym, while httpd
>>> is lower case following the convention that the program is installed
>>> with.
>>>
>>> Introducing "Apache HTTPD" [omiting Server], or "HTTPD" or "Apache
>>> Server"
>>> all serve to further confuse this landscape. =A0And this is certainly n=
ot
>>> the work of the Apache HTTPD Server Project ;-)
>>
>> +1, strong preference for "Apache HTTP Server" in the vast majority of
>> non-heres-the-name-of-an-executable references.
>
>
> Oh, sure, you say that just as soon as I change the last occurrence of
> "Apache HTTP Server (httpd)" to "Apache HTTPD". ;-)
>
> I honestly can't say that I feel strongly about this one way or another, =
but
> I would like to know what the consensus is so that we can be consistent. =
It
> doesn't flow well to call it "Apache HTTP Server" every time we mention i=
t
> in the main body of the docs. So we need to agree on a full name variatio=
n,
> and an abbreviated variation:
>
> Full:
> [ =A0] =A0- Apache HTTP Server
> [ =A0] =A0- Apache HTTPD
>
> Abbreviated:
> [ =A0] =A0- httpd
> [ =A0] =A0- HTTPD
> [ =A0] =A0- Apache httpd

My main concern is that it be Really Very Obvious that the abbreviated
version is just that. "Shortening something by omitting parts of it"
makes an abbreviation - not "picking something that is shorter". My
secondary concern is that it be obvious that the name of the project
and the name of the command are different.

So if "Apache HTTP Server" is the full name, I'd be happy with any of
the following abbreviations: "Apache", "HTTP Server", "Apache Server",
"Apache HTTP", "AHS", "Apache HS", etc, etc. (Obviously, some of them
I like better than others - that's ok, looking good wasn't listed in
my concerns above)

My preference would be to come to a consensus here, and then bring it
to the PMC for approval. I'm open to arguments on that one though.

Noirin

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org