log4r 1.1.2 → 1.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (319) hide show
  1. data/README +2 -2
  2. data/Rakefile +3 -3
  3. data/TODO +0 -34
  4. data/examples/filelog.rb +25 -0
  5. data/examples/logs/TestSize000001.log +576 -0
  6. data/examples/logs/TestSize000002.log +567 -0
  7. data/examples/logs/TestSize000003.log +552 -0
  8. data/examples/logs/TestSize000004.log +552 -0
  9. data/examples/logs/TestSize000005.log +552 -0
  10. data/examples/logs/TestSize000006.log +552 -0
  11. data/examples/logs/TestSize000007.log +552 -0
  12. data/examples/logs/TestSize000008.log +552 -0
  13. data/examples/logs/TestSize000009.log +552 -0
  14. data/examples/logs/TestSize000010.log +552 -0
  15. data/examples/logs/TestSize000011.log +552 -0
  16. data/examples/logs/TestSize000012.log +552 -0
  17. data/examples/logs/TestSize000013.log +552 -0
  18. data/examples/logs/TestSize000014.log +552 -0
  19. data/examples/logs/TestSize000015.log +552 -0
  20. data/examples/logs/TestSize000016.log +552 -0
  21. data/examples/logs/TestSize000017.log +552 -0
  22. data/examples/logs/TestSize000018.log +552 -0
  23. data/examples/logs/TestSize000019.log +535 -0
  24. data/examples/logs/TestSize000020.log +534 -0
  25. data/examples/logs/TestSize000021.log +534 -0
  26. data/examples/logs/TestSize000022.log +534 -0
  27. data/examples/logs/TestSize000023.log +534 -0
  28. data/examples/logs/TestSize000024.log +534 -0
  29. data/examples/logs/TestSize000025.log +534 -0
  30. data/examples/logs/TestSize000026.log +534 -0
  31. data/examples/logs/TestSize000027.log +534 -0
  32. data/examples/logs/TestSize000028.log +534 -0
  33. data/examples/logs/TestSize000029.log +534 -0
  34. data/examples/logs/TestSize000030.log +534 -0
  35. data/examples/logs/TestSize000031.log +534 -0
  36. data/examples/logs/TestSize000032.log +534 -0
  37. data/examples/logs/TestSize000033.log +534 -0
  38. data/examples/logs/TestSize000034.log +534 -0
  39. data/examples/logs/TestSize000035.log +534 -0
  40. data/examples/logs/TestSize000036.log +534 -0
  41. data/examples/logs/TestSize000037.log +534 -0
  42. data/examples/logs/TestSize000038.log +534 -0
  43. data/examples/logs/TestSize000039.log +534 -0
  44. data/examples/logs/TestSize000040.log +534 -0
  45. data/examples/logs/TestSize000041.log +534 -0
  46. data/examples/logs/TestSize000042.log +534 -0
  47. data/examples/logs/TestSize000043.log +534 -0
  48. data/examples/logs/TestSize000044.log +534 -0
  49. data/examples/logs/TestSize000045.log +534 -0
  50. data/examples/logs/TestSize000046.log +534 -0
  51. data/examples/logs/TestSize000047.log +534 -0
  52. data/examples/logs/TestSize000048.log +534 -0
  53. data/examples/logs/TestSize000049.log +534 -0
  54. data/examples/logs/TestSize000050.log +534 -0
  55. data/examples/logs/TestSize000051.log +534 -0
  56. data/examples/logs/TestSize000052.log +534 -0
  57. data/examples/logs/TestSize000053.log +534 -0
  58. data/examples/logs/TestSize000054.log +534 -0
  59. data/examples/logs/TestSize000055.log +534 -0
  60. data/examples/logs/TestSize000056.log +534 -0
  61. data/examples/logs/TestSize000057.log +534 -0
  62. data/examples/logs/TestSize000058.log +534 -0
  63. data/examples/logs/TestSize000059.log +534 -0
  64. data/examples/logs/TestSize000060.log +534 -0
  65. data/examples/logs/TestSize000061.log +534 -0
  66. data/examples/logs/TestSize000062.log +534 -0
  67. data/examples/logs/TestSize000063.log +534 -0
  68. data/examples/logs/TestSize000064.log +534 -0
  69. data/examples/logs/TestSize000065.log +534 -0
  70. data/examples/logs/TestSize000066.log +534 -0
  71. data/examples/logs/TestSize000067.log +534 -0
  72. data/examples/logs/TestSize000068.log +534 -0
  73. data/examples/logs/TestSize000069.log +534 -0
  74. data/examples/logs/TestSize000070.log +534 -0
  75. data/examples/logs/TestSize000071.log +534 -0
  76. data/examples/logs/TestSize000072.log +534 -0
  77. data/examples/logs/TestSize000073.log +534 -0
  78. data/examples/logs/TestSize000074.log +534 -0
  79. data/examples/logs/TestSize000075.log +534 -0
  80. data/examples/logs/TestSize000076.log +534 -0
  81. data/examples/logs/TestSize000077.log +534 -0
  82. data/examples/logs/TestSize000078.log +534 -0
  83. data/examples/logs/TestSize000079.log +534 -0
  84. data/examples/logs/TestSize000080.log +534 -0
  85. data/examples/logs/TestSize000081.log +534 -0
  86. data/examples/logs/TestSize000082.log +534 -0
  87. data/examples/logs/TestSize000083.log +534 -0
  88. data/examples/logs/TestSize000084.log +534 -0
  89. data/examples/logs/TestSize000085.log +534 -0
  90. data/examples/logs/TestSize000086.log +534 -0
  91. data/examples/logs/TestSize000087.log +534 -0
  92. data/examples/logs/TestSize000088.log +534 -0
  93. data/examples/logs/TestSize000089.log +534 -0
  94. data/examples/logs/TestSize000090.log +534 -0
  95. data/examples/logs/TestSize000091.log +534 -0
  96. data/examples/logs/TestSize000092.log +534 -0
  97. data/examples/logs/TestSize000093.log +534 -0
  98. data/examples/logs/TestSize000094.log +534 -0
  99. data/examples/logs/TestSize000095.log +534 -0
  100. data/examples/logs/TestSize000096.log +534 -0
  101. data/examples/logs/TestSize000097.log +534 -0
  102. data/examples/logs/TestSize000098.log +534 -0
  103. data/examples/logs/TestSize000099.log +534 -0
  104. data/examples/logs/TestSize000100.log +534 -0
  105. data/examples/logs/TestSize000101.log +534 -0
  106. data/examples/logs/TestSize000102.log +534 -0
  107. data/examples/logs/TestSize000103.log +534 -0
  108. data/examples/logs/TestSize000104.log +534 -0
  109. data/examples/logs/TestSize000105.log +534 -0
  110. data/examples/logs/TestSize000106.log +534 -0
  111. data/examples/logs/TestSize000107.log +534 -0
  112. data/examples/logs/TestSize000108.log +534 -0
  113. data/examples/logs/TestSize000109.log +534 -0
  114. data/examples/logs/TestSize000110.log +534 -0
  115. data/examples/logs/TestSize000111.log +534 -0
  116. data/examples/logs/TestSize000112.log +534 -0
  117. data/examples/logs/TestSize000113.log +534 -0
  118. data/examples/logs/TestSize000114.log +534 -0
  119. data/examples/logs/TestSize000115.log +534 -0
  120. data/examples/logs/TestSize000116.log +534 -0
  121. data/examples/logs/TestSize000117.log +534 -0
  122. data/examples/logs/TestSize000118.log +534 -0
  123. data/examples/logs/TestSize000119.log +534 -0
  124. data/examples/logs/TestSize000120.log +534 -0
  125. data/examples/logs/TestSize000121.log +534 -0
  126. data/examples/logs/TestSize000122.log +534 -0
  127. data/examples/logs/TestSize000123.log +534 -0
  128. data/examples/logs/TestSize000124.log +534 -0
  129. data/examples/logs/TestSize000125.log +534 -0
  130. data/examples/logs/TestSize000126.log +534 -0
  131. data/examples/logs/TestSize000127.log +534 -0
  132. data/examples/logs/TestSize000128.log +534 -0
  133. data/examples/logs/TestSize000129.log +534 -0
  134. data/examples/logs/TestSize000130.log +534 -0
  135. data/examples/logs/TestSize000131.log +534 -0
  136. data/examples/logs/TestSize000132.log +534 -0
  137. data/examples/logs/TestSize000133.log +534 -0
  138. data/examples/logs/TestSize000134.log +534 -0
  139. data/examples/logs/TestSize000135.log +534 -0
  140. data/examples/logs/TestSize000136.log +534 -0
  141. data/examples/logs/TestSize000137.log +534 -0
  142. data/examples/logs/TestSize000138.log +534 -0
  143. data/examples/logs/TestSize000139.log +534 -0
  144. data/examples/logs/TestSize000140.log +534 -0
  145. data/examples/logs/TestSize000141.log +534 -0
  146. data/examples/logs/TestSize000142.log +534 -0
  147. data/examples/logs/TestSize000143.log +534 -0
  148. data/examples/logs/TestSize000144.log +534 -0
  149. data/examples/logs/TestSize000145.log +534 -0
  150. data/examples/logs/TestSize000146.log +534 -0
  151. data/examples/logs/TestSize000147.log +534 -0
  152. data/examples/logs/TestSize000148.log +534 -0
  153. data/examples/logs/TestSize000149.log +534 -0
  154. data/examples/logs/TestSize000150.log +534 -0
  155. data/examples/logs/TestSize000151.log +534 -0
  156. data/examples/logs/TestSize000152.log +534 -0
  157. data/examples/logs/TestSize000153.log +534 -0
  158. data/examples/logs/TestSize000154.log +534 -0
  159. data/examples/logs/TestSize000155.log +534 -0
  160. data/examples/logs/TestSize000156.log +534 -0
  161. data/examples/logs/TestSize000157.log +534 -0
  162. data/examples/logs/TestSize000158.log +534 -0
  163. data/examples/logs/TestSize000159.log +534 -0
  164. data/examples/logs/TestSize000160.log +534 -0
  165. data/examples/logs/TestSize000161.log +534 -0
  166. data/examples/logs/TestSize000162.log +534 -0
  167. data/examples/logs/TestSize000163.log +534 -0
  168. data/examples/logs/TestSize000164.log +534 -0
  169. data/examples/logs/TestSize000165.log +534 -0
  170. data/examples/logs/TestSize000166.log +534 -0
  171. data/examples/logs/TestSize000167.log +534 -0
  172. data/examples/logs/TestSize000168.log +534 -0
  173. data/examples/logs/TestSize000169.log +534 -0
  174. data/examples/logs/TestSize000170.log +534 -0
  175. data/examples/logs/TestSize000171.log +534 -0
  176. data/examples/logs/TestSize000172.log +534 -0
  177. data/examples/logs/TestSize000173.log +534 -0
  178. data/examples/logs/TestSize000174.log +534 -0
  179. data/examples/logs/TestSize000175.log +534 -0
  180. data/examples/logs/TestSize000176.log +534 -0
  181. data/examples/logs/TestSize000177.log +534 -0
  182. data/examples/logs/TestSize000178.log +534 -0
  183. data/examples/logs/TestSize000179.log +534 -0
  184. data/examples/logs/TestSize000180.log +534 -0
  185. data/examples/logs/TestSize000181.log +534 -0
  186. data/examples/logs/TestSize000182.log +534 -0
  187. data/examples/logs/TestSize000183.log +534 -0
  188. data/examples/logs/TestSize000184.log +534 -0
  189. data/examples/logs/TestSize000185.log +534 -0
  190. data/examples/logs/TestSize000186.log +534 -0
  191. data/examples/logs/TestSize000187.log +312 -0
  192. data/examples/logs/TestTime000001.log +11 -0
  193. data/examples/logs/TestTime000002.log +10 -0
  194. data/examples/logs/TestTime000003.log +10 -0
  195. data/examples/logs/TestTime000004.log +10 -0
  196. data/examples/logs/TestTime000005.log +10 -0
  197. data/examples/logs/TestTime000006.log +10 -0
  198. data/examples/logs/TestTime000007.log +10 -0
  199. data/examples/logs/TestTime000008.log +10 -0
  200. data/examples/logs/TestTime000009.log +10 -0
  201. data/examples/logs/TestTime000010.log +9 -0
  202. data/src/log4r.rb +5 -2
  203. data/src/log4r/GDC.rb +40 -0
  204. data/src/log4r/MDC.rb +59 -0
  205. data/src/log4r/NDC.rb +87 -0
  206. data/src/log4r/formatter/patternformatter.rb +11 -6
  207. data/src/log4r/outputter/bob.patch +25 -0
  208. data/src/log4r/outputter/emailoutputter.rb.orig +118 -0
  209. data/src/log4r/outputter/emailoutputter.rb.rej +46 -0
  210. data/src/log4r/outputter/fileoutputter.rb +12 -5
  211. data/src/log4r/outputter/rollingfileoutputter.rb +8 -3
  212. data/src/log4r/outputter/win32eventoutputter.rb +136 -0
  213. data/src/log4r/rdoc/GDC +14 -0
  214. data/src/log4r/rdoc/MDC +16 -0
  215. data/src/log4r/rdoc/NDC +41 -0
  216. data/src/log4r/rdoc/win32eventoutputter +7 -0
  217. data/src/log4r/repository.rb +73 -52
  218. data/src/log4r/yamlconfigurator.rb +0 -0
  219. data/tests/testGDC.rb +26 -0
  220. data/tests/testMDC.rb +21 -0
  221. data/tests/testNDC.rb +27 -0
  222. data/tests/testthreads.rb +23 -0
  223. metadata +215 -98
  224. data/src/doc/Log4r.html +0 -392
  225. data/src/doc/Log4r/BasicFormatter.html +0 -370
  226. data/src/doc/Log4r/ConfigError.html +0 -207
  227. data/src/doc/Log4r/Configurator.html +0 -1050
  228. data/src/doc/Log4r/DateFileOutputter.html +0 -454
  229. data/src/doc/Log4r/DefaultFormatter.html +0 -205
  230. data/src/doc/Log4r/EmailOutputter.html +0 -636
  231. data/src/doc/Log4r/FileOutputter.html +0 -321
  232. data/src/doc/Log4r/Formatter.html +0 -291
  233. data/src/doc/Log4r/IOOutputter.html +0 -392
  234. data/src/doc/Log4r/Log4rConfig.html +0 -193
  235. data/src/doc/Log4r/Log4rTools.html +0 -370
  236. data/src/doc/Log4r/LogEvent.html +0 -360
  237. data/src/doc/Log4r/LogServer.html +0 -322
  238. data/src/doc/Log4r/Logger.html +0 -1132
  239. data/src/doc/Log4r/Logger/LoggerFactory.html +0 -200
  240. data/src/doc/Log4r/Logger/Repository.html +0 -207
  241. data/src/doc/Log4r/ObjectFormatter.html +0 -262
  242. data/src/doc/Log4r/Outputter.html +0 -910
  243. data/src/doc/Log4r/Outputter/OutputterFactory.html +0 -200
  244. data/src/doc/Log4r/Outputter/consoleoutputters_rb.html +0 -57
  245. data/src/doc/Log4r/Outputter/datefileoutputter_rb.html +0 -93
  246. data/src/doc/Log4r/Outputter/emailoutputter_rb.html +0 -179
  247. data/src/doc/Log4r/Outputter/fileoutputter_rb.html +0 -64
  248. data/src/doc/Log4r/Outputter/iooutputter_rb.html +0 -59
  249. data/src/doc/Log4r/Outputter/outputter_rb.html +0 -222
  250. data/src/doc/Log4r/Outputter/outputterfactory_rb.html +0 -62
  251. data/src/doc/Log4r/Outputter/remoteoutputter_rb.html +0 -59
  252. data/src/doc/Log4r/Outputter/rollingfileoutputter_rb.html +0 -66
  253. data/src/doc/Log4r/Outputter/staticoutputter_rb.html +0 -55
  254. data/src/doc/Log4r/Outputter/syslogoutputter_rb.html +0 -110
  255. data/src/doc/Log4r/Outputter/tst_rb.html +0 -54
  256. data/src/doc/Log4r/PatternFormatter.html +0 -422
  257. data/src/doc/Log4r/ROMPClient.html +0 -193
  258. data/src/doc/Log4r/ROMPServer.html +0 -193
  259. data/src/doc/Log4r/RemoteOutputter.html +0 -384
  260. data/src/doc/Log4r/RollingFileOutputter.html +0 -528
  261. data/src/doc/Log4r/RootLogger.html +0 -512
  262. data/src/doc/Log4r/SimpleFormatter.html +0 -258
  263. data/src/doc/Log4r/StderrOutputter.html +0 -250
  264. data/src/doc/Log4r/StdoutOutputter.html +0 -250
  265. data/src/doc/Log4r/SyslogOutputter.html +0 -533
  266. data/src/doc/Log4r/YamlConfigurator.html +0 -948
  267. data/src/doc/Log4r/base_rb.html +0 -57
  268. data/src/doc/Log4r/config_rb.html +0 -76
  269. data/src/doc/Log4r/configurator_rb.html +0 -370
  270. data/src/doc/Log4r/formatter/formatter_rb.html +0 -121
  271. data/src/doc/Log4r/formatter/patternformatter_rb.html +0 -233
  272. data/src/doc/Log4r/lib/drbloader_rb.html +0 -57
  273. data/src/doc/Log4r/lib/xmlloader_rb.html +0 -57
  274. data/src/doc/Log4r/logevent_rb.html +0 -55
  275. data/src/doc/Log4r/logger_rb.html +0 -293
  276. data/src/doc/Log4r/loggerfactory_rb.html +0 -66
  277. data/src/doc/Log4r/logserver_rb.html +0 -161
  278. data/src/doc/Log4r/rdoc/configurator.html +0 -444
  279. data/src/doc/Log4r/rdoc/emailoutputter.html +0 -261
  280. data/src/doc/Log4r/rdoc/formatter.html +0 -200
  281. data/src/doc/Log4r/rdoc/log4r.html +0 -268
  282. data/src/doc/Log4r/rdoc/logger.html +0 -364
  283. data/src/doc/Log4r/rdoc/logserver.html +0 -247
  284. data/src/doc/Log4r/rdoc/outputter.html +0 -295
  285. data/src/doc/Log4r/rdoc/patternformatter.html +0 -313
  286. data/src/doc/Log4r/rdoc/syslogoutputter.html +0 -179
  287. data/src/doc/Log4r/rdoc/yamlconfigurator.html +0 -169
  288. data/src/doc/Log4r/repository_rb.html +0 -62
  289. data/src/doc/Log4r/staticlogger_rb.html +0 -55
  290. data/src/doc/Log4r/yamlconfigurator_rb.html +0 -95
  291. data/src/doc/REXML.html +0 -193
  292. data/src/doc/created.rid +0 -1
  293. data/src/doc/images/brick.png +0 -0
  294. data/src/doc/images/brick_link.png +0 -0
  295. data/src/doc/images/bug.png +0 -0
  296. data/src/doc/images/bullet_black.png +0 -0
  297. data/src/doc/images/bullet_toggle_minus.png +0 -0
  298. data/src/doc/images/bullet_toggle_plus.png +0 -0
  299. data/src/doc/images/date.png +0 -0
  300. data/src/doc/images/find.png +0 -0
  301. data/src/doc/images/loadingAnimation.gif +0 -0
  302. data/src/doc/images/macFFBgHack.png +0 -0
  303. data/src/doc/images/package.png +0 -0
  304. data/src/doc/images/page_green.png +0 -0
  305. data/src/doc/images/page_white_text.png +0 -0
  306. data/src/doc/images/page_white_width.png +0 -0
  307. data/src/doc/images/plugin.png +0 -0
  308. data/src/doc/images/ruby.png +0 -0
  309. data/src/doc/images/tag_green.png +0 -0
  310. data/src/doc/images/wrench.png +0 -0
  311. data/src/doc/images/wrench_orange.png +0 -0
  312. data/src/doc/images/zoom.png +0 -0
  313. data/src/doc/index.html +0 -384
  314. data/src/doc/js/darkfish.js +0 -116
  315. data/src/doc/js/jquery.js +0 -32
  316. data/src/doc/js/quicksearch.js +0 -114
  317. data/src/doc/js/thickbox-compressed.js +0 -10
  318. data/src/doc/rdoc.css +0 -696
  319. data/src/log4r/outputter/tst.rb +0 -8
data/src/doc/Log4r/rdoc/outputter.html DELETED
@@ -1,295 +0,0 @@
1
- <?xml version="1.0" encoding="utf-8"?>
2
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
3
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4
-
5
- <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
6
- <head>
7
- <meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
8
-
9
- <title>File: outputter [1.1.2 Log4r API Documentation]</title>
10
-
11
- <link type="text/css" media="screen" href="../../rdoc.css" rel="stylesheet" />
12
-
13
- <script src="../../js/jquery.js" type="text/javascript"
14
- charset="utf-8"></script>
15
- <script src="../../js/thickbox-compressed.js" type="text/javascript"
16
- charset="utf-8"></script>
17
- <script src="../../js/quicksearch.js" type="text/javascript"
18
- charset="utf-8"></script>
19
- <script src="../../js/darkfish.js" type="text/javascript"
20
- charset="utf-8"></script>
21
- </head>
22
-
23
- <body class="file">
24
- <div id="metadata">
25
- <div id="project-metadata">
26
-
27
-
28
- <div id="fileindex-section" class="section project-section">
29
- <h3 class="section-header">Files</h3>
30
- <ul>
31
-
32
- <li class="file"><a href="../../log4r/rdoc/configurator.html">configurator</a></li>
33
-
34
- <li class="file"><a href="../../log4r/rdoc/emailoutputter.html">emailoutputter</a></li>
35
-
36
- <li class="file"><a href="../../log4r/rdoc/formatter.html">formatter</a></li>
37
-
38
- <li class="file"><a href="../../log4r/rdoc/log4r.html">log4r</a></li>
39
-
40
- <li class="file"><a href="../../log4r/rdoc/logger.html">logger</a></li>
41
-
42
- <li class="file"><a href="../../log4r/rdoc/logserver.html">logserver</a></li>
43
-
44
- <li class="file"><a href="../../log4r/rdoc/outputter.html">outputter</a></li>
45
-
46
- <li class="file"><a href="../../log4r/rdoc/patternformatter.html">patternformatter</a></li>
47
-
48
- <li class="file"><a href="../../log4r/rdoc/syslogoutputter.html">syslogoutputter</a></li>
49
-
50
- <li class="file"><a href="../../log4r/rdoc/yamlconfigurator.html">yamlconfigurator</a></li>
51
-
52
- </ul>
53
- </div>
54
-
55
-
56
- <div id="classindex-section" class="section project-section">
57
- <h3 class="section-header">Class Index
58
- <span class="search-toggle"><img src="../../images/find.png"
59
- height="16" width="16" alt="[+]"
60
- title="show/hide quicksearch" /></span></h3>
61
- <form action="#" method="get" accept-charset="utf-8" class="initially-hidden">
62
- <fieldset>
63
- <legend>Quicksearch</legend>
64
- <input type="text" name="quicksearch" value=""
65
- class="quicksearch-field" />
66
- </fieldset>
67
- </form>
68
-
69
- <ul class="link-list">
70
-
71
- <li><a href="../../Log4r.html">Log4r</a></li>
72
-
73
- <li><a href="../../Log4r/BasicFormatter.html">Log4r::BasicFormatter</a></li>
74
-
75
- <li><a href="../../Log4r/ConfigError.html">Log4r::ConfigError</a></li>
76
-
77
- <li><a href="../../Log4r/Configurator.html">Log4r::Configurator</a></li>
78
-
79
- <li><a href="../../Log4r/DateFileOutputter.html">Log4r::DateFileOutputter</a></li>
80
-
81
- <li><a href="../../Log4r/DefaultFormatter.html">Log4r::DefaultFormatter</a></li>
82
-
83
- <li><a href="../../Log4r/EmailOutputter.html">Log4r::EmailOutputter</a></li>
84
-
85
- <li><a href="../../Log4r/FileOutputter.html">Log4r::FileOutputter</a></li>
86
-
87
- <li><a href="../../Log4r/Formatter.html">Log4r::Formatter</a></li>
88
-
89
- <li><a href="../../Log4r/IOOutputter.html">Log4r::IOOutputter</a></li>
90
-
91
- <li><a href="../../Log4r/Log4rTools.html">Log4r::Log4rTools</a></li>
92
-
93
- <li><a href="../../Log4r/LogEvent.html">Log4r::LogEvent</a></li>
94
-
95
- <li><a href="../../Log4r/LogServer.html">Log4r::LogServer</a></li>
96
-
97
- <li><a href="../../Log4r/Logger.html">Log4r::Logger</a></li>
98
-
99
- <li><a href="../../Log4r/ObjectFormatter.html">Log4r::ObjectFormatter</a></li>
100
-
101
- <li><a href="../../Log4r/Outputter.html">Log4r::Outputter</a></li>
102
-
103
- <li><a href="../../Log4r/PatternFormatter.html">Log4r::PatternFormatter</a></li>
104
-
105
- <li><a href="../../Log4r/RemoteOutputter.html">Log4r::RemoteOutputter</a></li>
106
-
107
- <li><a href="../../Log4r/RollingFileOutputter.html">Log4r::RollingFileOutputter</a></li>
108
-
109
- <li><a href="../../Log4r/RootLogger.html">Log4r::RootLogger</a></li>
110
-
111
- <li><a href="../../Log4r/SimpleFormatter.html">Log4r::SimpleFormatter</a></li>
112
-
113
- <li><a href="../../Log4r/StderrOutputter.html">Log4r::StderrOutputter</a></li>
114
-
115
- <li><a href="../../Log4r/StdoutOutputter.html">Log4r::StdoutOutputter</a></li>
116
-
117
- <li><a href="../../Log4r/SyslogOutputter.html">Log4r::SyslogOutputter</a></li>
118
-
119
- <li><a href="../../Log4r/YamlConfigurator.html">Log4r::YamlConfigurator</a></li>
120
-
121
- </ul>
122
- <div id="no-class-search-results" style="display: none;">No matching classes.</div>
123
- </div>
124
-
125
-
126
- </div>
127
- </div>
128
-
129
- <div id="documentation">
130
- <h1>Outputters</h1>
131
- <p>
132
- An Outputter is a logging destination with a particular way to format data.
133
- It has a level threshold and a flexible level mask.
134
- </p>
135
- <p>
136
- Outputters must have names.
137
- </p>
138
- <h2>Level Threshold</h2>
139
- <p>
140
- Outputters have their own level thresholds that default to <tt>root</tt>
141
- level. They will not write any log events with a rank less than their
142
- threshold.
143
- </p>
144
- <h2>Level Mask</h2>
145
- <p>
146
- Alternatively, an Outputter can be told to log specific levels only:
147
- </p>
148
- <pre>
149
- o = StdoutOutputter.new 'console'
150
- o.only_at DEBUG, FATAL # only DEBUG and FATAL get written
151
- </pre>
152
- <h2>Outputter Repository</h2>
153
- <p>
154
- When outputters are created, they store themselves in an Outputter
155
- repository similar to the Logger repository.
156
- </p>
157
- <pre>
158
- StdoutOutputter.new 'console' =&gt; Create 'console' outputter
159
- Outputter['console'] =&gt; Get it back from the stash.
160
- </pre>
161
- <h2>Formatter</h2>
162
- <p>
163
- An outputter has a format defined by its Formatter. If no Formatter is
164
- specified, DefaultFormatter will be used.
165
- </p>
166
- <h2>Outputter is Abstract</h2>
167
- <p>
168
- The basic Outputter class is both abstract and a null object.
169
- </p>
170
- <h2>Interesting Outputters</h2>
171
- <ul>
172
- <li><a
173
- href="../outputter/syslogoutputter_rb.html">log4r/outputter/syslogoutputter.rb</a>
174
- - Logs to syslog
175
-
176
- </li>
177
- <li><a
178
- href="../outputter/emailoutputter_rb.html">log4r/outputter/emailoutputter.rb</a>
179
- - Email logs
180
-
181
- </li>
182
- <li><a href="../logserver_rb.html">log4r/logserver.rb</a> - For remote logging
183
-
184
- </li>
185
- </ul>
186
- <h2>Subclasses</h2>
187
- <ul>
188
- <li><a href="../../Log4r/IOOutputter.html">Log4r::IOOutputter</a> - for any IO
189
- object
190
-
191
- </li>
192
- <li><a href="../../Log4r/StdoutOutputter.html">Log4r::StdoutOutputter</a> -
193
- $stdout
194
-
195
- </li>
196
- <li><a href="../../Log4r/StderrOutputter.html">Log4r::StderrOutputter</a> -
197
- $stderr
198
-
199
- </li>
200
- <li><a href="../../Log4r/FileOutputter.html">Log4r::FileOutputter</a> - log to
201
- a file
202
-
203
- </li>
204
- <li><a
205
- href="../../Log4r/RollingFileOutputter.html">Log4r::RollingFileOutputter</a>
206
- - log to a file and split it as it grows
207
-
208
- </li>
209
- <li><a href="../../Log4r/SyslogOutputter.html">Log4r::SyslogOutputter</a> -
210
- logs to syslog
211
-
212
- </li>
213
- <li><a href="../../Log4r/EmailOutputter.html">Log4r::EmailOutputter</a> - email
214
- logs
215
-
216
- </li>
217
- <li><a href="../../Log4r/RemoteOutputter.html">Log4r::RemoteOutputter</a> - for
218
- remote logging
219
-
220
- </li>
221
- </ul>
222
- <h2>Default Outputters</h2>
223
- <p>
224
- Two outputters named &#8216;stdout&#8217; and &#8216;stderr&#8217; are
225
- created automatically at the root level. They are nice shortcuts.
226
- </p>
227
- <pre>
228
- Outputter['stdout'] =&gt; 'stdout'
229
- Outputter['stderr'] =&gt; 'stderr'
230
- Outputter.stdout =&gt; 'stdout'
231
- Outputter.stderr =&gt; 'stderr'
232
- </pre>
233
- <h2>Configuring</h2>
234
- <p>
235
- Outputters must have names and receive hash arguments. The parameter name
236
- for the hash args can be either a symbol or a string. All defined
237
- outputters accept <tt>:level</tt> and <tt>:formatter</tt> arguments. For
238
- arguments specific to a convenience Outputter, please look at the class
239
- description.
240
- </p>
241
- <p>
242
- The level threshold, the levels to log at (only_at) and formatter can be
243
- changed dynamically using the <tt>=</tt> methods.
244
- </p>
245
- <p>
246
- As a collective example of all this, here are various ways to set up an
247
- IOOutputter:
248
- </p>
249
- <pre>
250
- IOOutputter.new ExoticIO.new 'exotic', 'level' =&gt; WARN,
251
- :formatter =&gt; MyFormatter.new
252
- # an equivalent way:
253
- o = IOOutputter.new ExoticIO.new 'exotic'
254
- o.level = WARN
255
- o.formatter = MyFormatter # we can specify just the class
256
- o.only_at = THIS, THAT
257
- </pre>
258
- <h2>XML Configuration</h2>
259
- <p>
260
- Specify outputters as children of <tt>&lt;log4r_config&gt;</tt>:
261
- </p>
262
- <pre>
263
- &lt;log4r_config&gt;
264
- &lt;outputter name=&quot;myout&quot; type=&quot;Log4r::StdoutOutputter&quot;&gt;
265
- &lt;only_at&gt;DEBUG, INFO&lt;/only_at&gt;
266
- &lt;/outputter&gt;
267
- &lt;outputter name=&quot;file&quot; level=&quot;WARN&quot;&gt;
268
- &lt;type&gt;FileOutputter&lt;/type&gt;
269
- &lt;filename&gt;#{logpath}/file.log&lt;/filename&gt;
270
- &lt;trunc&gt;false&lt;/trunc&gt;
271
- &lt;/outputter&gt;
272
- ...
273
- </pre>
274
- <p>
275
- As explained in <a
276
- href="../configurator_rb.html">log4r/configurator.rb</a>, the hash
277
- arguments you would normally pass to <tt>new</tt> are specified as <em>XML
278
- parameters</em>. It is given an IO object to write to, a Formatter to call,
279
- and, optionally, levels to write at.
280
- </p>
281
- <p>
282
- Outputters invoke print then flush on the wrapped IO object. If the IO
283
- chokes, the Outputter will close the IO and set its level to <tt>OFF</tt>.
284
- </p>
285
-
286
- </div>
287
-
288
- <div id="validator-badges">
289
- <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
290
- <p><small>Generated with the <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish
291
- Rdoc Generator</a> 1.1.6</small>.</p>
292
- </div>
293
- </body>
294
- </html>
295
-
data/src/doc/Log4r/rdoc/patternformatter.html DELETED
@@ -1,313 +0,0 @@
1
- <?xml version="1.0" encoding="utf-8"?>
2
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
3
- "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4
-
5
- <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
6
- <head>
7
- <meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
8
-
9
- <title>File: patternformatter [1.1.2 Log4r API Documentation]</title>
10
-
11
- <link type="text/css" media="screen" href="../../rdoc.css" rel="stylesheet" />
12
-
13
- <script src="../../js/jquery.js" type="text/javascript"
14
- charset="utf-8"></script>
15
- <script src="../../js/thickbox-compressed.js" type="text/javascript"
16
- charset="utf-8"></script>
17
- <script src="../../js/quicksearch.js" type="text/javascript"
18
- charset="utf-8"></script>
19
- <script src="../../js/darkfish.js" type="text/javascript"
20
- charset="utf-8"></script>
21
- </head>
22
-
23
- <body class="file">
24
- <div id="metadata">
25
- <div id="project-metadata">
26
-
27
-
28
- <div id="fileindex-section" class="section project-section">
29
- <h3 class="section-header">Files</h3>
30
- <ul>
31
-
32
- <li class="file"><a href="../../log4r/rdoc/configurator.html">configurator</a></li>
33
-
34
- <li class="file"><a href="../../log4r/rdoc/emailoutputter.html">emailoutputter</a></li>
35
-
36
- <li class="file"><a href="../../log4r/rdoc/formatter.html">formatter</a></li>
37
-
38
- <li class="file"><a href="../../log4r/rdoc/log4r.html">log4r</a></li>
39
-
40
- <li class="file"><a href="../../log4r/rdoc/logger.html">logger</a></li>
41
-
42
- <li class="file"><a href="../../log4r/rdoc/logserver.html">logserver</a></li>
43
-
44
- <li class="file"><a href="../../log4r/rdoc/outputter.html">outputter</a></li>
45
-
46
- <li class="file"><a href="../../log4r/rdoc/patternformatter.html">patternformatter</a></li>
47
-
48
- <li class="file"><a href="../../log4r/rdoc/syslogoutputter.html">syslogoutputter</a></li>
49
-
50
- <li class="file"><a href="../../log4r/rdoc/yamlconfigurator.html">yamlconfigurator</a></li>
51
-
52
- </ul>
53
- </div>
54
-
55
-
56
- <div id="classindex-section" class="section project-section">
57
- <h3 class="section-header">Class Index
58
- <span class="search-toggle"><img src="../../images/find.png"
59
- height="16" width="16" alt="[+]"
60
- title="show/hide quicksearch" /></span></h3>
61
- <form action="#" method="get" accept-charset="utf-8" class="initially-hidden">
62
- <fieldset>
63
- <legend>Quicksearch</legend>
64
- <input type="text" name="quicksearch" value=""
65
- class="quicksearch-field" />
66
- </fieldset>
67
- </form>
68
-
69
- <ul class="link-list">
70
-
71
- <li><a href="../../Log4r.html">Log4r</a></li>
72
-
73
- <li><a href="../../Log4r/BasicFormatter.html">Log4r::BasicFormatter</a></li>
74
-
75
- <li><a href="../../Log4r/ConfigError.html">Log4r::ConfigError</a></li>
76
-
77
- <li><a href="../../Log4r/Configurator.html">Log4r::Configurator</a></li>
78
-
79
- <li><a href="../../Log4r/DateFileOutputter.html">Log4r::DateFileOutputter</a></li>
80
-
81
- <li><a href="../../Log4r/DefaultFormatter.html">Log4r::DefaultFormatter</a></li>
82
-
83
- <li><a href="../../Log4r/EmailOutputter.html">Log4r::EmailOutputter</a></li>
84
-
85
- <li><a href="../../Log4r/FileOutputter.html">Log4r::FileOutputter</a></li>
86
-
87
- <li><a href="../../Log4r/Formatter.html">Log4r::Formatter</a></li>
88
-
89
- <li><a href="../../Log4r/IOOutputter.html">Log4r::IOOutputter</a></li>
90
-
91
- <li><a href="../../Log4r/Log4rTools.html">Log4r::Log4rTools</a></li>
92
-
93
- <li><a href="../../Log4r/LogEvent.html">Log4r::LogEvent</a></li>
94
-
95
- <li><a href="../../Log4r/LogServer.html">Log4r::LogServer</a></li>
96
-
97
- <li><a href="../../Log4r/Logger.html">Log4r::Logger</a></li>
98
-
99
- <li><a href="../../Log4r/ObjectFormatter.html">Log4r::ObjectFormatter</a></li>
100
-
101
- <li><a href="../../Log4r/Outputter.html">Log4r::Outputter</a></li>
102
-
103
- <li><a href="../../Log4r/PatternFormatter.html">Log4r::PatternFormatter</a></li>
104
-
105
- <li><a href="../../Log4r/RemoteOutputter.html">Log4r::RemoteOutputter</a></li>
106
-
107
- <li><a href="../../Log4r/RollingFileOutputter.html">Log4r::RollingFileOutputter</a></li>
108
-
109
- <li><a href="../../Log4r/RootLogger.html">Log4r::RootLogger</a></li>
110
-
111
- <li><a href="../../Log4r/SimpleFormatter.html">Log4r::SimpleFormatter</a></li>
112
-
113
- <li><a href="../../Log4r/StderrOutputter.html">Log4r::StderrOutputter</a></li>
114
-
115
- <li><a href="../../Log4r/StdoutOutputter.html">Log4r::StdoutOutputter</a></li>
116
-
117
- <li><a href="../../Log4r/SyslogOutputter.html">Log4r::SyslogOutputter</a></li>
118
-
119
- <li><a href="../../Log4r/YamlConfigurator.html">Log4r::YamlConfigurator</a></li>
120
-
121
- </ul>
122
- <div id="no-class-search-results" style="display: none;">No matching classes.</div>
123
- </div>
124
-
125
-
126
- </div>
127
- </div>
128
-
129
- <div id="documentation">
130
- <h1>PatternFormatter</h1>
131
- <p>
132
- PatternFormatter offers complete control over the appearance of <a
133
- href="../../Log4r.html">Log4r</a> log events without having to write custom
134
- Formatter classes. In order to take advantage of PatternFormatter, some
135
- familarity with Kernel#sprintf or the C printf function is recommended. For
136
- time formatting, please look at Time.strftime.
137
- </p>
138
- <p>
139
- PatternFormatter accepts three hash arguments:
140
- </p>
141
- <table>
142
- <tr><td valign="top"><tt>pattern</tt>:</td><td>Log event format string.
143
-
144
- </td></tr>
145
- <tr><td valign="top"><tt>date_pattern</tt>:</td><td>Date format string.
146
-
147
- </td></tr>
148
- <tr><td valign="top"><tt>date_method</tt>:</td><td><tt>Time</tt> method to call (instead of using date_pattern).
149
-
150
- </td></tr>
151
- </table>
152
- <p>
153
- The <tt>pattern</tt> format string is something like &#8220;%l [%d]
154
- %80M&#8221;, which resembles a pattern one would normally pass to
155
- Kernel#sprintf. However, the directives are specific to <a
156
- href="../../Log4r.html">Log4r</a>. Before we go on, let&#8217;s cover some
157
- terminology.
158
- </p>
159
- <h2>Terminology</h2>
160
- <dl>
161
- <dt><b>%</b></dt><dd>The directive identifier. Everything after this up to and including one of
162
- the <em>directive letters</em> defines a <em>directive</em>.
163
-
164
- </dd>
165
- <dt><b>directive letter</b></dt><dd>Letters in the set <tt>[cCdtmMl%]</tt>. These identify what kind of data
166
- we&#8217;re interested in. They are detailed below.
167
-
168
- </dd>
169
- <dt><b>format directive</b></dt><dd>The numbers and assorted symbols that appears between <b>%</b> and a
170
- <em>directive letter</em> is a format directive. It is comprised of an
171
- integer specifying the field width followed optionally by a period and an
172
- integer specifying the precision. The field width is the minimum number of
173
- characters to copy from the data string while the precision is the maximum
174
- number to copy. If the field width is preceded by a - sign, the data will
175
- be left-justified. Otherwise, it is right-justified.
176
-
177
- </dd>
178
- <dt><b>directive</b></dt><dd>A statement that says, &#8220;I want this data to appear with this
179
- (optional) particular format.&#8221; A directive starts with a <b>%</b> and
180
- is followed by a format directive and terminates in a directive letter.
181
-
182
- </dd>
183
- </dl>
184
- <h2>What the Directive Letters mean</h2>
185
- <dl>
186
- <dt><b>c</b></dt><dd>Produces a logger&#8217;s name. Fast.
187
-
188
- </dd>
189
- <dt><b>C</b></dt><dd>Produces a logger&#8217;s full name. Fast.
190
-
191
- </dd>
192
- <dt><b>d</b></dt><dd>Produces the time in a format specified by <b>date_pattern</b> or by
193
- <b>date_method</b>. If neither is specified, the default will be used
194
- (ISO8601). Slow.
195
-
196
- </dd>
197
- <dt><b>t</b></dt><dd>Produces the file and line number of the log event. The appearance varies
198
- by Ruby version, but it is the same output returned by Kernel#caller[0].
199
- Slow.
200
-
201
- </dd>
202
- <dt><b>m</b></dt><dd>The non-inspected log message. That is, to_s called on the object passed
203
- into a log method. Fast.
204
-
205
- </dd>
206
- <dt><b>M</b></dt><dd>The message formatted by the <tt>format_object</tt> method in
207
- BasicFormatter. It will pretty-print Exceptions, print Strings and inspect
208
- everything else. Slow.
209
-
210
- </dd>
211
- <dt><b>l</b></dt><dd>The name of the level. That&#8217;s l as in Lambda. Fast.
212
-
213
- </dd>
214
- <dt><b>%</b></dt><dd>%% just prints a %. Any formatting is <em>probably</em> ignored. Fast.
215
-
216
- </dd>
217
- </dl>
218
- <h2>Examples of directives:</h2>
219
- <dl>
220
- <dt><b>%d</b></dt><dd>Prints out the date according to our date_pattern or date_method. By
221
- default, it looks like this: 2001-01-12 13:15:50
222
-
223
- </dd>
224
- <dt><b>%.120m</b></dt><dd>Prints out at most 120 characters of the log message.
225
-
226
- </dd>
227
- <dt><b>%15t</b></dt><dd>Prints the execution trace and pads it on the left with enough whitespace
228
- to make the whole thing 15 chars.
229
-
230
- </dd>
231
- </dl>
232
- <h2>Pattern String</h2>
233
- <p>
234
- A pattern string is simply a bunch of directives combined with the desired
235
- format. For instance, to show the level in brackets followed by the date
236
- and then the log message trimmed to 15 characters, we use the following
237
- pattern:
238
- </p>
239
- <pre>
240
- &quot;[%l] %d :: %.15m&quot; #=&gt; [DEBUG] 2001-01-12 13:15:50 :: This is a messa
241
- </pre>
242
- <p>
243
- To create a PatternFormatter with this format:
244
- </p>
245
- <pre>
246
- p = PatternFormatter.new(:pattern =&gt; &quot;[%l] %d :: %.15m&quot;)
247
- </pre>
248
- <h2>Formatting time</h2>
249
- <p>
250
- To format time, do one of the following:
251
- </p>
252
- <ul>
253
- <li>Specify a date_pattern
254
-
255
- </li>
256
- <li>Specify what class method of Ruby&#8217;s <tt>Time</tt> class to call.
257
-
258
- </li>
259
- <li>Use the default format
260
-
261
- </li>
262
- </ul>
263
- <p>
264
- If neither date_pattern nor date_method is specified, the default date
265
- format will be used. Currently, that would be ISO8601,
266
- </p>
267
- <p>
268
- The date_pattern is exactly what one would pass to <tt>Time.strftime</tt>.
269
- To specify a date_pattern, pass
270
- <tt>:date_pattern=&gt;&quot;pattern&quot;</tt> to PatternFormat.new.
271
- </p>
272
- <p>
273
- Alternatively, date_method can be specified to produce the output of a
274
- specific <tt>Time</tt> method, such as <tt>usec</tt> or <tt>to_s</tt> or
275
- any other zero argument <tt>Time</tt> method that produces a time. More
276
- precisely, the method to call will be invoked on <tt>Time.now</tt>. To
277
- specify a date_method, pass <tt>:date_method=&gt;'methodname'</tt> (or a
278
- Symbol equivalent) to <tt>PatternFormatter.new</tt>.
279
- </p>
280
- <h1>XML Configuration</h1>
281
- <p>
282
- As explained in <a
283
- href="../configurator_rb.html">log4r/configurator.rb</a>, the hash
284
- arguments to PatternFormatter are <em>XML parameters</em>. Here&#8217;s an
285
- example:
286
- </p>
287
- <pre>
288
- &lt;formatter type=&quot;PatternFormatter&quot; pattern=&quot;[%l] %d :: %.15m&quot;&gt;
289
- &lt;date_method&gt;usec&lt;/date_method&gt;
290
- &lt;/formatter&gt;
291
- </pre>
292
- <h1>Performace considerations</h1>
293
- <p>
294
- The performance impact of using a particular directive letter is noted in
295
- the <b>What the Directives Letters mean</b> section.
296
- </p>
297
- <p>
298
- The performance impact of time formatting merits special attention. If you
299
- aren&#8217;t aware yet, the Time class is kind of a kludge. Time.now.usec
300
- happens to be faster than Time.now. If you&#8217;re concerned about
301
- performance, please profile the various time methods and patterns.
302
- </p>
303
-
304
- </div>
305
-
306
- <div id="validator-badges">
307
- <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
308
- <p><small>Generated with the <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish
309
- Rdoc Generator</a> 1.1.6</small>.</p>
310
- </div>
311
- </body>
312
- </html>
313
-