You are viewing a plain text version of this content. The canonical link for it is here.
Posted to bugs@httpd.apache.org by bu...@apache.org on 2010/10/18 13:00:57 UTC

DO NOT REPLY [Bug 50110] New: missing Log options on website

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

           Summary: missing Log options on website
           Product: Apache httpd-2
           Version: 2.2.16
          Platform: PC
        OS/Version: Linux
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Documentation
        AssignedTo: bugs@httpd.apache.org
        ReportedBy: mnalis-apachebug@voyager.hr


Web documentation on http://httpd.apache.org/docs/2.2/logs.html misses some
Log-related configuration directives, like BufferLogs explained in
http://httpd.apache.org/docs/2.2/mod/mod_log_config.html

it should be added

-- 
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@httpd.apache.org
For additional commands, e-mail: bugs-help@httpd.apache.org


DO NOT REPLY [Bug 50110] missing Log options on website

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=50110

Eric Covener <co...@gmail.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |RESOLVED
         Resolution|                            |WONTFIX

--- Comment #1 from Eric Covener <co...@gmail.com> 2010-10-18 08:15:59 EDT ---
I don't think the "users guide" entry on should necessarily mention every
directive in the manual that relates to the topic, and specifically that the
entry on logging needs to mention an obscure directive like BufferedLogs.

-- 
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@httpd.apache.org
For additional commands, e-mail: bugs-help@httpd.apache.org


DO NOT REPLY [Bug 50110] missing Log options on website

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=50110

Matija Nalis <mn...@voyager.hr> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |mnalis-apachebug@voyager.hr

-- 
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@httpd.apache.org
For additional commands, e-mail: bugs-help@httpd.apache.org


DO NOT REPLY [Bug 50110] missing Log options on website

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=50110

Matija Nalis <mn...@voyager.hr> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|RESOLVED                    |REOPENED
         Resolution|WONTFIX                     |

--- Comment #2 from Matija Nalis <mn...@voyager.hr> 2010-10-18 09:40:02 EDT ---
Well, under section "Other Log Files" it mentions even way more obscure options
like ForensicLog, ScriptLogBuffer and more. Should those be removed too, then? 

I do not ask for the option to be detailed on
http://httpd.apache.org/docs/2.2/logs.html, just for mod_log_config (and its
options, of which BufferedLogs is but one) to be linked under that "Other Log
Files" section. 

I do not think that this is unreasonable request, as the way it is (when even
mod_log_forensic and mod_logio are mentioned but mod_log_config isn't) it looks
like the option doesn't exist at all (I'd actually only found about it by
looking at the source, and then re-searched the web and found other reference
to it).

Also note that BufferedLogs is not so obscure -- it's very useful (I'd almost
say necessary) on higher load servers; for example on our site (many prefork
children, a lots of small and fast hits to serve, and yes we need the logs) the
load average (caused mostly by millions of small write I/O on ext3) dropped
from 10-20 to less than 1-2 just by turning that option on. I'd even recommend
for that option to be On by default in apache

So I hope I've presented my case and would like to ask you to please
reconsider, hence reopening the bug. All I'm asking is to add "mod_log_config"
with "BufferedLogs", "CookieLog" and "TransferLog" to the "Other Log Files"
"Related Modules/Related Directives" box for sake of completeness and helping
others hoping to find that same (extremely useful) directive.

I can make a patch for the webpage if that would help (although I would need
XML source of the webpage to do that, as it looks auto-generated from XML)

Thank you for your time, and I hope you might find it reasonable thing to do.

-- 
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@httpd.apache.org
For additional commands, e-mail: bugs-help@httpd.apache.org


DO NOT REPLY [Bug 50110] missing Log options on website

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=50110

Rich Bowen <rb...@apache.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|REOPENED                    |RESOLVED
         Resolution|                            |FIXED

--- Comment #4 from Rich Bowen <rb...@apache.org> 2010-10-29 10:29:19 EDT ---
I've added mod_log_config and BufferedLogs in the "other logs" section. I have
not added CookieLog because it's deprecated, and I don't see any value in
drawing attention to it. I have not added TransferLog because I think using
TransferLog is *extremely* bad practice, leading to unexpected results when
LogFormat directives are added and TransferLog suddenly starts logging in a
different format than before.

I'll make the same change to trunk in a moment.

Thanks for the bug report.

-- 
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@httpd.apache.org
For additional commands, e-mail: bugs-help@httpd.apache.org


DO NOT REPLY [Bug 50110] missing Log options on website

Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=50110

--- Comment #3 from Eric Covener <co...@gmail.com> 2010-10-18 09:49:08 EDT ---
Fair game for someone else who might be interested.

-- 
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@httpd.apache.org
For additional commands, e-mail: bugs-help@httpd.apache.org