~ubuntu-branches/ubuntu/utopic/gnome-online-accounts/utopic

« back to all changes in this revision

Viewing changes to doc/html/goa-Logging.html

  • Committer: Package Import Robot
  • Author(s): Andreas Henriksson, Laurent Bigonville, Andreas Henriksson
  • Date: 2014-05-16 11:42:52 UTC
  • mfrom: (1.1.28) (0.1.12 sid)
  • Revision ID: package-import@ubuntu.com-20140516114252-u5ect6mk6ht8i38x
Tags: 3.12.2-1
[ Laurent Bigonville ]
* debian/control.in: Recommends realmd package (Closes: #725965)

[ Andreas Henriksson ]
* New upstream release.
  - Removes chat support from Windows Live provider (XMPP gateway gone).
* Bump Standards-Version to 3.9.5

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
 
<html>
3
 
<head>
4
 
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
 
<title>Logging</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
7
 
<link rel="home" href="index.html" title="GNOME Online Accounts Reference Manual">
8
 
<link rel="up" href="ch07.html" title="Core">
9
 
<link rel="prev" href="ch07.html" title="Core">
10
 
<link rel="next" href="goa-Utilities.html" title="Utilities">
11
 
<meta name="generator" content="GTK-Doc V1.19 (XML mode)">
12
 
<link rel="stylesheet" href="style.css" type="text/css">
13
 
</head>
14
 
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15
 
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
16
 
<tr valign="middle">
17
 
<td><a accesskey="p" href="ch07.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
18
 
<td><a accesskey="u" href="ch07.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
19
 
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
20
 
<th width="100%" align="center">GNOME Online Accounts Reference Manual</th>
21
 
<td><a accesskey="n" href="goa-Utilities.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
22
 
</tr>
23
 
<tr><td colspan="5" class="shortcuts">
24
 
<a href="#goa-Logging.synopsis" class="shortcut">Top</a>
25
 
                   | 
26
 
                  <a href="#goa-Logging.description" class="shortcut">Description</a>
27
 
</td></tr>
28
 
</table>
29
 
<div class="refentry">
30
 
<a name="goa-Logging"></a><div class="titlepage"></div>
31
 
<div class="refnamediv"><table width="100%"><tr>
32
 
<td valign="top">
33
 
<h2><span class="refentrytitle"><a name="goa-Logging.top_of_page"></a>Logging</span></h2>
34
 
<p>Logging — Logging Routines</p>
35
 
</td>
36
 
<td valign="top" align="right"></td>
37
 
</tr></table></div>
38
 
<div class="refsynopsisdiv">
39
 
<a name="goa-Logging.synopsis"></a><h2>Synopsis</h2>
40
 
<pre class="synopsis">enum                <a class="link" href="goa-Logging.html#GoaLogLevel" title="enum GoaLogLevel">GoaLogLevel</a>;
41
 
<span class="returnvalue">void</span>                <a class="link" href="goa-Logging.html#goa-log" title="goa_log ()">goa_log</a>                             (<em class="parameter"><code><a class="link" href="goa-Logging.html#GoaLogLevel" title="enum GoaLogLevel"><span class="type">GoaLogLevel</span></a> level</code></em>,
42
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *function</code></em>,
43
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *location</code></em>,
44
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *format</code></em>,
45
 
                                                         <em class="parameter"><code>...</code></em>);
46
 
 
47
 
#define             <a class="link" href="goa-Logging.html#goa-debug" title="goa_debug()">goa_debug</a>                           (...)
48
 
#define             <a class="link" href="goa-Logging.html#goa-info" title="goa_info()">goa_info</a>                            (...)
49
 
#define             <a class="link" href="goa-Logging.html#goa-notice" title="goa_notice()">goa_notice</a>                          (...)
50
 
#define             <a class="link" href="goa-Logging.html#goa-warning" title="goa_warning()">goa_warning</a>                         (...)
51
 
#define             <a class="link" href="goa-Logging.html#goa-error" title="goa_error()">goa_error</a>                           (...)
52
 
</pre>
53
 
</div>
54
 
<div class="refsect1">
55
 
<a name="goa-Logging.description"></a><h2>Description</h2>
56
 
<p>
57
 
TODO: explain a bit more what these logging routines do - e.g. that
58
 
<a class="link" href="goa-Logging.html#GOA-LOG-LEVEL-NOTICE:CAPS"><code class="literal">GOA_LOG_LEVEL_NOTICE</code></a> and higher goes to the syslog and so on
59
 
etc. etc.
60
 
</p>
61
 
</div>
62
 
<div class="refsect1">
63
 
<a name="goa-Logging.details"></a><h2>Details</h2>
64
 
<div class="refsect2">
65
 
<a name="GoaLogLevel"></a><h3>enum GoaLogLevel</h3>
66
 
<pre class="programlisting">typedef enum {
67
 
  GOA_LOG_LEVEL_DEBUG,
68
 
  GOA_LOG_LEVEL_INFO,
69
 
  GOA_LOG_LEVEL_NOTICE,
70
 
  GOA_LOG_LEVEL_WARNING,
71
 
  GOA_LOG_LEVEL_ERROR
72
 
} GoaLogLevel;
73
 
</pre>
74
 
<p>
75
 
Logging levels.
76
 
</p>
77
 
<div class="variablelist"><table border="0" class="variablelist">
78
 
<colgroup>
79
 
<col align="left" valign="top">
80
 
<col>
81
 
</colgroup>
82
 
<tbody>
83
 
<tr>
84
 
<td><p><a name="GOA-LOG-LEVEL-DEBUG:CAPS"></a><span class="term"><code class="literal">GOA_LOG_LEVEL_DEBUG</code></span></p></td>
85
 
<td>Debug messages.
86
 
</td>
87
 
</tr>
88
 
<tr>
89
 
<td><p><a name="GOA-LOG-LEVEL-INFO:CAPS"></a><span class="term"><code class="literal">GOA_LOG_LEVEL_INFO</code></span></p></td>
90
 
<td>Informational messages.
91
 
</td>
92
 
</tr>
93
 
<tr>
94
 
<td><p><a name="GOA-LOG-LEVEL-NOTICE:CAPS"></a><span class="term"><code class="literal">GOA_LOG_LEVEL_NOTICE</code></span></p></td>
95
 
<td>Messages that the administrator should take notice of.
96
 
</td>
97
 
</tr>
98
 
<tr>
99
 
<td><p><a name="GOA-LOG-LEVEL-WARNING:CAPS"></a><span class="term"><code class="literal">GOA_LOG_LEVEL_WARNING</code></span></p></td>
100
 
<td>Warning messages.
101
 
</td>
102
 
</tr>
103
 
<tr>
104
 
<td><p><a name="GOA-LOG-LEVEL-ERROR:CAPS"></a><span class="term"><code class="literal">GOA_LOG_LEVEL_ERROR</code></span></p></td>
105
 
<td>Error messages.
106
 
</td>
107
 
</tr>
108
 
</tbody>
109
 
</table></div>
110
 
</div>
111
 
<hr>
112
 
<div class="refsect2">
113
 
<a name="goa-log"></a><h3>goa_log ()</h3>
114
 
<pre class="programlisting"><span class="returnvalue">void</span>                goa_log                             (<em class="parameter"><code><a class="link" href="goa-Logging.html#GoaLogLevel" title="enum GoaLogLevel"><span class="type">GoaLogLevel</span></a> level</code></em>,
115
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *function</code></em>,
116
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *location</code></em>,
117
 
                                                         <em class="parameter"><code>const <span class="type">gchar</span> *format</code></em>,
118
 
                                                         <em class="parameter"><code>...</code></em>);</pre>
119
 
<p>
120
 
Low-level logging function used by <a class="link" href="goa-Logging.html#goa-debug" title="goa_debug()"><code class="function">goa_debug()</code></a> and other macros.
121
 
</p>
122
 
<div class="variablelist"><table border="0" class="variablelist">
123
 
<colgroup>
124
 
<col align="left" valign="top">
125
 
<col>
126
 
</colgroup>
127
 
<tbody>
128
 
<tr>
129
 
<td><p><span class="term"><em class="parameter"><code>level</code></em> :</span></p></td>
130
 
<td>A <a class="link" href="goa-Logging.html#GoaLogLevel" title="enum GoaLogLevel"><span class="type">GoaLogLevel</span></a>.</td>
131
 
</tr>
132
 
<tr>
133
 
<td><p><span class="term"><em class="parameter"><code>function</code></em> :</span></p></td>
134
 
<td>Pass <span class="type">G_STRFUNC</span> here.</td>
135
 
</tr>
136
 
<tr>
137
 
<td><p><span class="term"><em class="parameter"><code>location</code></em> :</span></p></td>
138
 
<td>Pass <span class="type">G_STRLOC</span> here.</td>
139
 
</tr>
140
 
<tr>
141
 
<td><p><span class="term"><em class="parameter"><code>format</code></em> :</span></p></td>
142
 
<td>printf()-style format.</td>
143
 
</tr>
144
 
<tr>
145
 
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
146
 
<td>Arguments for format.</td>
147
 
</tr>
148
 
</tbody>
149
 
</table></div>
150
 
</div>
151
 
<hr>
152
 
<div class="refsect2">
153
 
<a name="goa-debug"></a><h3>goa_debug()</h3>
154
 
<pre class="programlisting">#define goa_debug(...)   goa_log(GOA_LOG_LEVEL_DEBUG, G_STRFUNC, G_STRLOC, __VA_ARGS__);
155
 
</pre>
156
 
<p>
157
 
Logging macro for <a class="link" href="goa-Logging.html#GOA-LOG-LEVEL-DEBUG:CAPS"><code class="literal">GOA_LOG_LEVEL_DEBUG</code></a>.
158
 
</p>
159
 
<div class="variablelist"><table border="0" class="variablelist">
160
 
<colgroup>
161
 
<col align="left" valign="top">
162
 
<col>
163
 
</colgroup>
164
 
<tbody><tr>
165
 
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
166
 
<td>printf()-style format string and arguments</td>
167
 
</tr></tbody>
168
 
</table></div>
169
 
</div>
170
 
<hr>
171
 
<div class="refsect2">
172
 
<a name="goa-info"></a><h3>goa_info()</h3>
173
 
<pre class="programlisting">#define goa_info(...)    goa_log(GOA_LOG_LEVEL_INFO, G_STRFUNC, G_STRLOC, __VA_ARGS__);
174
 
</pre>
175
 
<p>
176
 
Logging macro for <a class="link" href="goa-Logging.html#GOA-LOG-LEVEL-INFO:CAPS"><code class="literal">GOA_LOG_LEVEL_INFO</code></a>.
177
 
</p>
178
 
<div class="variablelist"><table border="0" class="variablelist">
179
 
<colgroup>
180
 
<col align="left" valign="top">
181
 
<col>
182
 
</colgroup>
183
 
<tbody><tr>
184
 
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
185
 
<td>printf()-style format string and arguments</td>
186
 
</tr></tbody>
187
 
</table></div>
188
 
</div>
189
 
<hr>
190
 
<div class="refsect2">
191
 
<a name="goa-notice"></a><h3>goa_notice()</h3>
192
 
<pre class="programlisting">#define goa_notice(...)    goa_log(GOA_LOG_LEVEL_NOTICE, G_STRFUNC, G_STRLOC, __VA_ARGS__);
193
 
</pre>
194
 
<p>
195
 
Logging macro for <a class="link" href="goa-Logging.html#GOA-LOG-LEVEL-NOTICE:CAPS"><code class="literal">GOA_LOG_LEVEL_NOTICE</code></a>.
196
 
</p>
197
 
<div class="variablelist"><table border="0" class="variablelist">
198
 
<colgroup>
199
 
<col align="left" valign="top">
200
 
<col>
201
 
</colgroup>
202
 
<tbody><tr>
203
 
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
204
 
<td>printf()-style format string and arguments</td>
205
 
</tr></tbody>
206
 
</table></div>
207
 
</div>
208
 
<hr>
209
 
<div class="refsect2">
210
 
<a name="goa-warning"></a><h3>goa_warning()</h3>
211
 
<pre class="programlisting">#define goa_warning(...) goa_log(GOA_LOG_LEVEL_WARNING, G_STRFUNC, G_STRLOC, __VA_ARGS__);
212
 
</pre>
213
 
<p>
214
 
Logging macro for <a class="link" href="goa-Logging.html#GOA-LOG-LEVEL-WARNING:CAPS"><code class="literal">GOA_LOG_LEVEL_WARNING</code></a>.
215
 
</p>
216
 
<div class="variablelist"><table border="0" class="variablelist">
217
 
<colgroup>
218
 
<col align="left" valign="top">
219
 
<col>
220
 
</colgroup>
221
 
<tbody><tr>
222
 
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
223
 
<td>printf()-style format string and arguments</td>
224
 
</tr></tbody>
225
 
</table></div>
226
 
</div>
227
 
<hr>
228
 
<div class="refsect2">
229
 
<a name="goa-error"></a><h3>goa_error()</h3>
230
 
<pre class="programlisting">#define goa_error(...)   goa_log(GOA_LOG_LEVEL_ERROR, G_STRFUNC, G_STRLOC, __VA_ARGS__);
231
 
</pre>
232
 
<p>
233
 
Logging macro for <a class="link" href="goa-Logging.html#GOA-LOG-LEVEL-ERROR:CAPS"><code class="literal">GOA_LOG_LEVEL_ERROR</code></a>.
234
 
</p>
235
 
<div class="variablelist"><table border="0" class="variablelist">
236
 
<colgroup>
237
 
<col align="left" valign="top">
238
 
<col>
239
 
</colgroup>
240
 
<tbody><tr>
241
 
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
242
 
<td>printf()-style format string and arguments</td>
243
 
</tr></tbody>
244
 
</table></div>
245
 
</div>
246
 
</div>
247
 
</div>
248
 
<div class="footer">
249
 
<hr>
250
 
          Generated by GTK-Doc V1.19</div>
251
 
</body>
252
 
</html>
 
 
b'\\ No newline at end of file'