nobody at rubyforge.org
2007-Feb-12 19:30 UTC
[Wxruby-development] [867] trunk/wxruby2/doc/textile/log.txtl: Fix methods section, organise instance and class methods
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="content-type"
content="text/html; charset=utf-8" /><style
type="text/css"><!--
#msg dl { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:'':'';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer { font-family:
verdana,arial,helvetica,sans-serif; font-size: 10pt; }
#msg dl a { font-weight: bold}
#msg dl a:link { color:#fc3; }
#msg dl a:active { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt;
font-weight: bold; }
#msg pre { overflow: auto; background: #ffc; border: 1px #fc0 solid; padding:
6px; }
#msg ul, pre { overflow: auto; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid;
padding: 6px; }
#patch { width: 100%; }
#patch h4 {font-family:
verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch
.binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<title>[867] trunk/wxruby2/doc/textile/log.txtl: Fix methods section,
organise instance and class methods</title>
</head>
<body>
<div id="msg">
<dl>
<dt>Revision</dt> <dd>867</dd>
<dt>Author</dt> <dd>brokentoy</dd>
<dt>Date</dt> <dd>2007-02-12 14:30:47 -0500 (Mon, 12 Feb
2007)</dd>
</dl>
<h3>Log Message</h3>
<pre>Fix methods section, organise instance and class methods</pre>
<h3>Modified Paths</h3>
<ul>
<li><a
href="#trunkwxruby2doctextilelogtxtl">trunk/wxruby2/doc/textile/log.txtl</a></li>
</ul>
</div>
<div id="patch">
<h3>Diff</h3>
<a id="trunkwxruby2doctextilelogtxtl"></a>
<div class="modfile"><h4>Modified:
trunk/wxruby2/doc/textile/log.txtl (866 => 867)</h4>
<pre class="diff"><span>
<span class="info">---
trunk/wxruby2/doc/textile/log.txtl        2007-02-12
19:22:55 UTC (rev 866)
+++
trunk/wxruby2/doc/textile/log.txtl        2007-02-12
19:30:47 UTC (rev 867)
</span><span class="lines">@@ -33,18 +33,6 @@
</span><span class="cx"> only useful when the application
is terminating and shouldn''t be used in other
</span><span class="cx"> situations because it may easily
lead to a loss of messages.
</span><span class="cx">
</span><del>-"on_log":#Log_onlog
-
-"get_active_target":#Log_getactivetarget
-
-"set_active_target":#Log_setactivetarget
-
-"dont_create_on_demand":#Log_dontcreateondemand
-
-"Suspend":logsuspend.html
-
-"Resume":logresume.html
-
</del><span class="cx"> h3(#loggingfunctions). Logging
functions
</span><span class="cx">
</span><span class="cx"> There are two functions which
must be implemented by any derived class to
</span><span class="lines">@@ -136,34 +124,92 @@
</span><span class="cx"> window on the corresponding error
message. If you wish to enable it, please use
</span><span class="cx">
"set_timestamp":#Log_settimestamp explicitly.
</span><span class="cx">
</span><del>-"add_trace_mask":#Log_addtracemask
</del><span class="cx">
</span><del>-"remove_trace_mask":#Log_removetracemask
</del><ins>+h2. Class Methods
</ins><span class="cx">
</span><del>-"clear_trace_masks":#Log_cleartracemasks
</del><ins>+* "on_log":#Log_onlog
+* "get_active_target":#Log_getactivetarget
+* "set_active_target":#Log_setactivetarget
+* "dont_create_on_demand":#Log_dontcreateondemand
+* "suspend":#Log_suspend
+* "resume":#Log_resume
</ins><span class="cx">
</span><del>-"get_trace_masks":#Log_gettracemasks
</del><ins>+h2. Instance Methods
</ins><span class="cx">
</span><del>-"is_allowed_trace_mask":#Log_isallowedtracemask
</del><ins>+* "add_trace_mask":#Log_addtracemask
+* "remove_trace_mask":#Log_removetracemask
+* "clear_trace_masks":#Log_cleartracemasks
+* "get_trace_masks":#Log_gettracemasks
+* "is_allowed_trace_mask":#Log_isallowedtracemask
+* "set_verbose":#Log_setverbose
+* "get_verbose":#Log_getverbose
+* "set_timestamp":#Log_settimestamp
+* "get_timestamp":#Log_gettimestamp
+* "set_trace_mask":#Log_settracemask
+* "get_trace_mask":#Log_gettracemask
</ins><span class="cx">
</span><del>-"set_verbose":#Log_setverbose
</del><ins>+h3(#Log_onlog). Log.on_log
</ins><span class="cx">
</span><del>-"get_verbose":#Log_getverbose
</del><ins>+ *on_log*(%(arg-type)LogLevel% level, %(arg-type)char%
message)
</ins><span class="cx">
</span><del>-"set_timestamp":#Log_settimestamp
</del><ins>+Forwards the message at specified level to the _DoLog()_
function of the
+active log target if there is any, does nothing otherwise.
</ins><span class="cx">
</span><del>-"get_timestamp":#Log_gettimestamp
</del><ins>+h3(#Log_getactivetarget). Log.get_active_target
</ins><span class="cx">
</span><del>-"set_trace_mask":#Log_settracemask
</del><ins>+ "Log":log.html *get_active_target*()
</ins><span class="cx">
</span><del>-"get_trace_mask":#Log_gettracemask
</del><ins>+Returns the active log target (may be @nil@).
</ins><span class="cx">
</span><del>-2
</del><ins>+h3(#Log_setactivetarget). Log.set_active_target
</ins><span class="cx">
</span><del>-h4. Members
</del><ins>+ "Log":log.html
*set_active_target*(%(arg-type)Log% logtarget)
</ins><span class="cx">
</span><ins>+Sets the specified log target as the active one.
Returns the
+previous active log target (may be @nil@). To supress logging use a new
+instance of LogNull not @nil@. If the active log target is set to @nil@ a
+new default log target will be created when logging occurs.
</ins><span class="cx">
</span><ins>+h3(#Log_suspend). Log.suspend
</ins><span class="cx">
</span><ins>+ *suspend*()
+
+Suspends the logging until "Resume":logresume.html is called. Note
that
+the latter must be called the same number of times as the former to undo it,
+i.e. if you call Suspend() twice you must call Resume() twice as well.
+
+Note that suspending the logging means that the log sink won''t be be
flushed
+periodically, it doesn''t have any effect if the current log target
does the
+logging immediately without waiting for "Flush":logflush.html to be
+called (the standard GUI log target only shows the log dialog when it is
+flushed, so Suspend() works as expected with it).
+
+h4. See also
+
+"resume":logresume.html,
+
+"LogNull":logoverview.html
+
+h3(#Log_resume). Log.resume
+
+ *resume*()
+
+Resumes logging previously suspended by a call to
+"suspend":logsuspend.html. All messages logged in the meanwhile will
be
+flushed soon.
+
+h3(#Log_dontcreateondemand). Log.dont_create_on_demand
+
+ *dont_create_on_demand*()
+
+Instructs Log to not create new log targets on the fly if there is none
+currently. (Almost) for internal use only: it is supposed to be called by the
+application shutdown code.
+
+Note that this function also calls
+"clear_trace_masks":#Log_cleartracemasks.
+
+
</ins><span class="cx"> h3(#Log_addtracemask).
Log#add_trace_mask
</span><span class="cx">
</span><span class="cx">
*add_trace_mask*(%(arg-type)String% mask)
</span><span class="lines">@@ -197,56 +243,6 @@
</span><span class="cx">
</span><span class="cx">
"add_trace_mask":#Log_addtracemask.
</span><span class="cx">
</span><del>-h3(#Log_onlog). Log#on_log
-
- *on_log*(%(arg-type)LogLevel% level, %(arg-type)char% message)
-
-Forwards the message at specified level to the _DoLog()_ function of the
-active log target if there is any, does nothing otherwise.
-
-h3(#Log_getactivetarget). Log#get_active_target
-
- "Log":log.html *get_active_target*()
-
-Returns the pointer to the active log target (may be NULL).
-
-h3(#Log_setactivetarget). Log#set_active_target
-
- "Log":log.html *set_active_target*(%(arg-type)Log% logtarget)
-
-Sets the specified log target as the active one. Returns the pointer to the
-previous active log target (may be NULL). To supress logging use a new
-instance of LogNull not NULL. If the active log target is set to NULL a
-new default log target will be created when logging occurs.
-
-h3(#Log_suspend). Log#suspend
-
- *suspend*()
-
-Suspends the logging until "Resume":logresume.html is called. Note
that
-the latter must be called the same number of times as the former to undo it,
-i.e. if you call Suspend() twice you must call Resume() twice as well.
-
-Note that suspending the logging means that the log sink won''t be be
flushed
-periodically, it doesn''t have any effect if the current log target
does the
-logging immediately without waiting for "Flush":logflush.html to be
-called (the standard GUI log target only shows the log dialog when it is
-flushed, so Suspend() works as expected with it).
-
-h4. See also
-
-"Resume":logresume.html,
-
-"LogNull":logoverview.html
-
-h3(#Log_resume). Log#resume
-
- *resume*()
-
-Resumes logging previously suspended by a call to
-"Suspend":logsuspend.html. All messages logged in the meanwhile will
be
-flushed soon.
-
</del><span class="cx"> h3(#Log_dolog). Log#do_log
</span><span class="cx">
</span><span class="cx"> *do_log*(%(arg-type)LogLevel%
level, %(arg-type)Char% msg, %(arg-type)time_t% timestamp)
</span><span class="lines">@@ -269,17 +265,6 @@
</span><span class="cx"> A simple implementation may just
send the string to @stdout@ or, better,
</span><span class="cx"> @stderr@.
</span><span class="cx">
</span><del>-h3(#Log_dontcreateondemand). Log#dont_create_on_demand
-
- *dont_create_on_demand*()
-
-Instructs Log to not create new log targets on the fly if there is none
-currently. (Almost) for internal use only: it is supposed to be called by the
-application shutdown code.
-
-Note that this function also calls
-"clear_trace_masks":#Log_cleartracemasks.
-
</del><span class="cx"> h3(#Log_flush). Log#flush
</span><span class="cx">
</span><span class="cx"> *flush*()
</span></span></pre>
</div>
</div>
</body>
</html>
