httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Noirin Plunkett <fireb...@nerdchic.net>
Subject Re: [PATCH] site: more debugging tips
Date Mon, 05 Sep 2005 13:33:37 GMT
On Mon, Sep 05, 2005 at 01:53:12PM +0100, Joe Orton wrote:
> After getting bored with writing these into bugzilla for the umpteenth 
> time, does this look OK?

Looks good, just a few style/readability suggestions below.

> +
> +<p>To ensure that a core dump can be written to a directory which is
I'd suggest this read
"To ensure that the core dump is written to a directory which is"
Otherwise, it seems tautological - the core dump can always be written
to a directory which is writeable by the apache user.

> +directive must be added to <code>httpd.conf</code>; for example:</p>

> +size must be lifted; for example:</p>

> +<p>On some platforms, further steps might be needed to enable core
> +dumps; see <a href="#sol27">Solaris 2.7 and coredumps</a> below.</p>

Semicolons are inappropriate here - try a dash, comma, or fullstop.

> +<p>When a child process crashes, a message will be logged to the
> +error_log like the following:</p>

"like the following" should come immediately after "a message".
Otherwise, it's unclear as to what will be like the following text - the
message, or the error log.

> +<p>if the text "possible coredump in /tmp" does not appear in the

> +<p>if attempting to debug a threaded server, such as using the

> +<p>this will produce a backtrace for each of the threads within the
> +process.</p>

I think these should start with capital letters - it just makes the text
easier to read.

Thanks!
Noirin

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


Mime
View raw message