coar 97/09/12 07:50:54 Modified: htdocs/manual/mod mod_log_config.html src CHANGES src/modules/standard mod_log_config.c Log: Changes to mod_log_config to allow naming of format strings. Format nicknames are defined with "LogFormat fmt nickname", and can be used with "LogFormat nickname" and "CustomLog logtarget nickname". Revision Changes Path 1.19 +65 -18 apachen/htdocs/manual/mod/mod_log_config.html Index: mod_log_config.html =================================================================== RCS file: /export/home/cvs/apachen/htdocs/manual/mod/mod_log_config.html,v retrieving revision 1.18 retrieving revision 1.19 diff -u -r1.18 -r1.19 --- mod_log_config.html 1997/06/04 16:14:22 1.18 +++ mod_log_config.html 1997/09/12 14:50:47 1.19 @@ -203,36 +203,79 @@ href="mod_cookies.html">mod_cookies, and is deprecated.
- -The first argument is the filename to log to. This is used -exactly like the argument to TransferLog, that is, -it is either a full path, or relative to the current -server root.
+Compatibility: Nickname only available in Apache 1.3
+ or later
+Module: mod_log_config +
+The first argument is the filename to which log records should be +written. This is used +exactly like the argument to +TransferLog; +that is, it is either a full path or relative to the current +server root. ++
The format argument specifies a format for each line of the log file. The options available for the format are exactly the same as for the argument of the LogFormat directive. If the format includes any spaces (which it will do in almost all cases) it should be enclosed in double quotes. - ++
+Instead of an actual format string, you can use a format nickname defined with +the +LogFormat +directive. ++
LogFormat "%h %l %u %t \"%r\" %s %b"
- -This sets the format of the logfile. See -Custom Log Formats for details on the format arguments.
+This sets the format of the default logfile named by the +TransferLog +directive . See the section on +Custom Log Formats for details on the format +arguments. ++
+If you include a nickname for the format on the directive line, you can +use it in other LogFormat and +CustomLog +directives rather than repeating the entire format string. ++
+A +LogFormat directive which defines a nickname does +nothing else -- that is, it only defines the nickname, +it doesn't actually apply the format and make it the default. ++
-The TransferLog directive adds a log file in Common Log Format. +The TransferLog directive adds a log file in the format defined by the +most recent +LogFormat +directive, or Common Log Format if no other default format has been +specified. File-pipe is one of