library/log4php/xml/log4php.dtd
changeset 46 f11c31f7fa3e
parent 45 a56e7f9a0463
child 47 03388ec805b4
equal deleted inserted replaced
45:a56e7f9a0463 46:f11c31f7fa3e
     1 <?xml version="1.0" encoding="UTF-8" ?>
       
     2         <!--
       
     3          Licensed to the Apache Software Foundation (ASF) under one or more
       
     4          contributor license agreements.  See the NOTICE file distributed with
       
     5          this work for additional information regarding copyright ownership.
       
     6          The ASF licenses this file to You under the Apache License, Version 2.0
       
     7          (the "License"); you may not use this file except in compliance with
       
     8          the License.  You may obtain a copy of the License at
       
     9 
       
    10               http://www.apache.org/licenses/LICENSE-2.0
       
    11 
       
    12          Unless required by applicable law or agreed to in writing, software
       
    13          distributed under the License is distributed on an "AS IS" BASIS,
       
    14          WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
       
    15          See the License for the specific language governing permissions and
       
    16          limitations under the License.
       
    17          -->
       
    18         <!-- Authors: Chris Taylor, Ceki Gülcü. -->
       
    19         <!-- Version: 1.2 -->
       
    20 
       
    21         <!-- PHP Port Modifications Author: Marco Vassura -->
       
    22         <!-- PHP dtd Version: $Revision: 823875 $ -->
       
    23 
       
    24         <!-- A configuration element consists of optional renderer
       
    25         elements,appender elements, categories and an optional root
       
    26         element. -->
       
    27         <!-- [log4php] -->
       
    28         <!--
       
    29             category instead of logger cannot be used. categoryFactory is not implemented in log4php.
       
    30         -->
       
    31         <!-- [/log4php] -->
       
    32         <!ELEMENT log4php:configuration (renderer*, appender*,(logger)*,root?)>
       
    33 
       
    34         <!-- The "threshold" attribute takes a level value such that all -->
       
    35         <!-- logging statements with a level equal or below this value are -->
       
    36         <!-- disabled. -->
       
    37 
       
    38         <!-- Setting the "debug" enable the printing of internal log4j logging   -->
       
    39         <!-- statements.                                                         -->
       
    40 
       
    41         <!-- By default, debug attribute is "null", meaning that we not do touch -->
       
    42         <!-- internal log4j logging settings. The "null" value for the threshold -->
       
    43         <!-- attribute can be misleading. The threshold field of a repository    -->
       
    44         <!-- cannot be set to null. The "null" value for the threshold attribute -->
       
    45         <!-- simply means don't touch the threshold field, the threshold field   -->
       
    46         <!-- keeps its old value.                                                -->
       
    47 
       
    48         <!ATTLIST log4php:configuration
       
    49                 xmlns:log4php            CDATA #FIXED "http://logging.apache.org/log4php"
       
    50                 threshold                (all|debug|info|warn|error|fatal|off|null) "null"
       
    51                 >
       
    52 
       
    53         <!-- renderer elements allow the user to customize the conversion of  -->
       
    54         <!-- message objects to String.                                       -->
       
    55         <!ELEMENT renderer EMPTY>
       
    56         <!ATTLIST renderer
       
    57                 renderedClass  CDATA #REQUIRED
       
    58                 renderingClass CDATA #REQUIRED
       
    59                 >
       
    60 
       
    61         <!-- Appenders must have a name and a class. -->
       
    62         <!-- Appenders may contain an error handler, a layout, optional parameters -->
       
    63         <!-- and filters. They may also reference (or include) other appenders. -->
       
    64         <!-- [log4php] -->
       
    65         <!-- error handler tag has no effects since log4php does not handle errors. Defintion deleted. -->
       
    66         <!-- [/log4php] -->
       
    67         <!ELEMENT appender (param*, layout?, filter*, appender-ref*)>
       
    68         <!ATTLIST appender
       
    69                 name      ID  #REQUIRED
       
    70                 class     CDATA   #REQUIRED
       
    71                 >
       
    72 
       
    73         <!ELEMENT layout (param*)>
       
    74         <!ATTLIST layout
       
    75                 class     CDATA   #REQUIRED
       
    76                 >
       
    77 
       
    78         <!ELEMENT filter (param*)>
       
    79         <!ATTLIST filter
       
    80                 class     CDATA   #REQUIRED
       
    81                 >
       
    82 
       
    83 
       
    84         <!ELEMENT param EMPTY>
       
    85         <!ATTLIST param
       
    86                 name      CDATA   #REQUIRED
       
    87                 value     CDATA   #REQUIRED
       
    88                 >
       
    89 
       
    90         <!ELEMENT priority EMPTY>
       
    91         <!ATTLIST priority
       
    92                 value   CDATA #REQUIRED
       
    93                 >
       
    94 
       
    95         <!ELEMENT level EMPTY>
       
    96         <!ATTLIST level
       
    97                 value   CDATA #REQUIRED
       
    98                 >
       
    99 
       
   100         <!-- If no level element is specified, then the configurator MUST not -->
       
   101         <!-- touch the level of the named logger. -->
       
   102         <!ELEMENT logger (level?,appender-ref*)>
       
   103         <!ATTLIST logger
       
   104                 name      ID  #REQUIRED
       
   105                 additivity    (true|false) "true"
       
   106                 >
       
   107 
       
   108         <!ELEMENT appender-ref EMPTY>
       
   109         <!ATTLIST appender-ref
       
   110                 ref IDREF #REQUIRED
       
   111                 >
       
   112 
       
   113         <!-- If no priority element is specified, then the configurator MUST not -->
       
   114         <!-- touch the priority of root. -->
       
   115         <!-- The root category always exists and cannot be subclassed. -->
       
   116         <!ELEMENT root (param*, (priority|level)?, appender-ref*)>
       
   117 
       
   118 
       
   119         <!-- ==================================================================== -->
       
   120         <!--                       A logging event                                -->
       
   121         <!-- ==================================================================== -->
       
   122         <!ELEMENT log4php:eventSet (log4php:event*)>
       
   123         <!ATTLIST log4php:eventSet
       
   124                 xmlns:log4php          CDATA #FIXED "http://www.vxr.it/log4php/"
       
   125                 version                (0.2|0.3) "0.3"
       
   126                 includesLocationInfo   (true|false) "true"
       
   127                 >
       
   128 
       
   129         <!ELEMENT log4php:event (log4php:message, log4php:locationInfo?) >
       
   130 
       
   131         <!-- The timestamp format is application dependent. -->
       
   132         <!ATTLIST log4php:event
       
   133                 logger     CDATA #REQUIRED
       
   134                 level      CDATA #REQUIRED
       
   135                 thread     CDATA #REQUIRED
       
   136                 timestamp  CDATA #REQUIRED
       
   137                 >
       
   138 
       
   139         <!ELEMENT log4php:message (#PCDATA)>
       
   140         <!ELEMENT log4php:NDC (#PCDATA)>
       
   141 
       
   142         <!ELEMENT log4php:locationInfo EMPTY>
       
   143         <!ATTLIST log4php:locationInfo
       
   144                 class  CDATA  #REQUIRED
       
   145                 method CDATA  #REQUIRED
       
   146                 file   CDATA  #REQUIRED
       
   147                 line   CDATA  #REQUIRED
       
   148                 >