httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Iikka Meriläinen <Iikka.Merilai...@pato.vaala.fi>
Subject Re: [PATCH][RESEND] windows.xml rewrite
Date Sat, 14 Dec 2002 21:40:54 GMT
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On Sat, 14 Dec 2002, Astrid Kessler wrote:

> It's very easy to read. Nice work.

Thanks! The obscurity of the original documents was one reason for this
rewrite effort. My first Apache installations on Windows were a lot less
than successful, and then there were these docs to find help from. Whoa...
not an experience I'd like to live again.

> Section "Customizing Apache for Windows":
>
> 1)
>    ... See the Apache documentation for all the available directives.
> -> ... See the directive index for all the available directives.
>
> and link directly to this file.

Fixed. Hope the link is correct.

> Section "Running Apache as a service":
>
> 2)
>    <p>By default, all Apache services are registered to run as user
>    <code>System</code> (the LocalSystem account). The <code>System
>    </code> account has no privileges to your network via any
>    Windows-secured mechanism, including the file system, named pipes,
>    DCOM, or secure RPC. It has, however, wide privileges locally.</p>
>
> Do note mark "system" as code, because the account name is not "System" but
> "LocalSystem". Ok, this is only a little markup issue. Probaly you want to
> write:
>
> -> <p>By default, all Apache services are registered to run as system
>    user (the <code>LocalSystem</code> account). The <code>LocalSystem
>    </code> account has no privileges to your network via any
>    Windows-secured mechanism, including the file system, named pipes,
>    DCOM, or secure RPC. It has, however, wide privileges locally.</p>

Right. Modified this one, too.

> Section "Running Apache as a Consolê Application":
>
> 3)
>    You can also run Apache via the shortcut Start Apache in Console placed
>    to Start Menu --> Programs --> Apache HTTP Server 2.0.xx --> Control
>    Apache Server during the installation. This will open a console window
>    and start Apache inside it. The window will remain visible until you
>    stop Apache.
>
> The Windows stays open only if Apache is not installed as a service.
> Otherwise this menu entry starts the service and closes the console window.
> (Tested on Windows 2000)

I reworked this paragraph a bit. Maybe this new version is better.

> 4)
>    If you don't specify a configuration file with -f  or -n, Apache will
>    use the file name compiled into the server, such as conf\httpd.conf,
>    relative to the path specified by the ServerRoot  directive.
>
> Maybe I'm missing something. But the sentence is mistakable. One could
> read: the configuration file is relative to the ServerRoot directive. This
> could never be because the configuration file must be found and read before
> apache is able to notice the ServerRoot directive.

Yes, this sentence was strange indeed. Actually it's almost ridiculous when
I read it afterwards! Please see the reworked version - might be SLIGHTLY
better. ;-)

I assume the hardcored configuration file path is relative to the Apache.exe
startup folder. Am I correct on this?

> 5) You are often using <li><p>....</p></li>. Is this intended?
Imho <li>...
> </li> is also ok.

They are two different things, actually. But you're right, there were
unneeded <p>'s around. With <p>'s you get a separation from another <li>'s,
which was needed in some cases. I removed some <p>'s, and the result seems
to be clearer.

> Section "Testing the Installation":
>
> 6)
>    After starting Apache (either in a console window or as a service) it
>    will be listening on port 80 (unless you changed the Listen directive in
>    the configuration files).
>
> -> After starting Apache (either in a console window or as a service) it
>    will be listening on port 80 (unless you changed the Listen directive in
>    the configuration files or installed apache only for the current user).

Changed this too.

I have little to add at this point. Seems to be pretty ready for
committing.

I attached a patch for sitemap.xml which removes the now-obsolete
win_service.xml link. The file on CVS is also not needed any more - I don't
know how that'll be handled.

Iikka

========================================
 Iikka Meriläinen
 Vaala, Finland
 E-mail: Iikka.Merilainen@pato.vaala.fi
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.0 (GNU/Linux)

iD8DBQE9+6VrCVGYZ+r4ZncRAqkhAJ4i4WFmGQb6PvLDGxbDskzJ5NVJzgCglk2b
VxhnGm3V8QuIvIm1uXC4IkY=
=4KJq
-----END PGP SIGNATURE-----

Mime
View raw message