/
DebugTemplate
68 lines (61 loc) · 1.99 KB
/
DebugTemplate
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
__NAME__ purpose
specify format of debug messages
__END__
__NAME__ synopsis
<group rep='repeat' choice='plain'>
<arg><replaceable>time_spec</replaceable></arg>
<arg choice='plain'><literal>{CALLER0}</literal> ... <literal>{CALLER9}</literal></arg>
<arg choice='plain'><literal>{CATALOG}</literal></arg>
<arg choice='plain'><literal>{HOST}</literal></arg>
<arg choice='plain'><literal>{MESSAGE}</literal></arg>
<arg choice='plain'><literal>{PAGE}</literal></arg>
<arg choice='plain'><literal>{REMOTE_ADDR}</literal></arg>
<arg choice='plain'><literal>{TAG}</literal></arg>
</group>
__END__
__NAME__ see also
DebugFile, DEBUG
__END__
__NAME__ description
&conf-DebugTemplate;, a global directive, allows you to change the
format of debug messages.
<itemizedlist>
<listitem><para>
<literal>time_spec</literal> -
POSIX::strftime() format specifiers. Take
a look at the &glos-time; glossary entry for a complete list. Since the
character <literal>%</literal> is treated as the beginning of a specifier,
use <literal>%%</literal> to insert a literal <literal>%</literal>.
</para></listitem>
<listitem><para>
<literal>{CALLER0}</literal> ... <literal>{CALLER9}</literal> -
members of the caller() list (see caller() &PERL; function).
</para></listitem>
<listitem><para>
<literal>{CATALOG}</literal> - catalog name
</para></listitem>
<listitem><para>
<literal>{HOST}</literal> - remote hostname or IP address
</para></listitem>
<listitem><para>
<literal>{MESSAGE}</literal> - actual debug message
</para></listitem>
<listitem><para>
<literal>{PAGE}</literal> - current page name (&var-MV_PAGE;)
</para></listitem>
<listitem><para>
<literal>{REMOTE_ADDR}</literal> - remote IP address
</para></listitem>
<listitem><para>
<literal>{TAG}</literal> - current tag name
(from <classname>Vend::Parse</classname>)
</para></listitem>
</itemizedlist>
__END__
__NAME__ notes
__END__
__NAME__ example: Setting __FILENAME__
<programlisting>
DebugTemplate %c {CALLER0} {MESSAGE} {PAGE} {TAG}
</programlisting>
__END__