← Back to branch summary

~ubuntu-branches/ubuntu/trusty/libbonobo/trusty-proposed

« back to all changes in this revision

Viewing changes to doc/api/html/debugging.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2007-07-30 22:13:59 UTC
  • mfrom: (1.1.15 upstream)
  • Revision ID: james.westby@ubuntu.com-20070730221359-xblbyyhx8edlxmqj
Tags: 2.19.6-0ubuntu1
* New upstream version:
  - Use gmodule-no-export-2.0 instead of gmodule-2.0
  - Win32 fix for pipe macro

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/api/html/debugging.html
30
30
<div class="refentry" lang="en">
31
31
<a name="debugging"></a><div class="titlepage"></div>
32
32
<div class="refsect1" lang="en">
33
 
<a name="id2664831"></a><h2>Debugging</h2>
 
33
<a name="id2664947"></a><h2>Debugging</h2>
34
34
<p>Bonobo component debugging advice, version 0.1
35
35
            by Michael Meeks &lt;mmeeks@gnu.org&gt;</p>
36
36
<p>Since it is not transparently obvious how to debug
37
37
            Bonobo components the following suggestions may be of use.</p>
38
38
<div class="refsect2" lang="en">
39
 
<a name="id2664621"></a><h3>Read the FAQ</h3>
 
39
<a name="id2664737"></a><h3>Read the FAQ</h3>
40
40
<p>This will cover particularly common errors and their
41
41
                solutions obviating the need for further debugging.</p>
42
42
</div>
43
43
<hr>
44
44
<div class="refsect2" lang="en">
45
 
<a name="id2664632"></a><h3>Versions</h3>
 
45
<a name="id2664747"></a><h3>Versions</h3>
46
46
<p> It is vital to ensure that the correct versions of
47
47
                both the component and the container are being
48
48
                run. The safest way to make sure this is the case is
51
51
</div>
52
52
<hr>
53
53
<div class="refsect2" lang="en">
54
 
<a name="id2665726"></a><h3>Correct install</h3>
 
54
<a name="id2665842"></a><h3>Correct install</h3>
55
55
<p>It is rather important to make sure that bonobo has
56
56
                compiled and installed correctly. If you are using CVS
57
57
                ensure that your bonobo has installed without errors
59
59
</div>
60
60
<hr>
61
61
<div class="refsect2" lang="en">
62
 
<a name="id2665739"></a><h3>Stale processes</h3>
 
62
<a name="id2665854"></a><h3>Stale processes</h3>
63
63
<p>It is a good idea to check there are no stale
64
64
                component processes running in the background, check
65
65
                with</p>
68
68
</div>
69
69
<hr>
70
70
<div class="refsect2" lang="en">
71
 
<a name="id2665765"></a><h3>Debugging</h3>
 
71
<a name="id2665880"></a><h3>Debugging</h3>
72
72
<p>So: debugging. The best way to do this is to have
73
73
                two X-terms, in one run the component:</p>
74
74
<span><strong class="command"><pre class="screen">
95
95
</div>
96
96
<hr>
97
97
<div class="refsect2" lang="en">
98
 
<a name="id2665842"></a><h3>CORBA method tracing</h3>
 
98
<a name="id2665957"></a><h3>CORBA method tracing</h3>
99
99
<p>There is beautiful built in ORBit2 method tracing
100
100
                facility that will show you all CORBA invocations,
101
101
                their objects, arguments, microsecond timestamps
107
107
</div>
108
108
<hr>
109
109
<div class="refsect2" lang="en">
110
 
<a name="id2665861"></a><h3>Order of execution</h3>
 
110
<a name="id2665977"></a><h3>Order of execution</h3>
111
111
<p>It is of course important to ensure that the
112
112
                component has registered before executing the
113
113
                container.  A good guide is to wait until your hard
116
116
</div>
117
117
<hr>
118
118
<div class="refsect2" lang="en">
119
 
<a name="id2665874"></a><h3>Nothing will activate!</h3>
 
119
<a name="id2665989"></a><h3>Nothing will activate!</h3>
120
120
<span><strong class="command"><pre class="screen">
121
121
export BONOBO_ACTIVATION_DEBUG_OUTPUT=1
122
122
bonobo-slay
126
126
</div>
127
127
<hr>
128
128
<div class="refsect2" lang="en">
129
 
<a name="id2665895"></a><h3>Nothing seems to happen, the code just locks</h3>
 
129
<a name="id2666011"></a><h3>Nothing seems to happen, the code just locks</h3>
130
130
<p>Check that you are doing either a
131
131
                <code class="function">bonobo_main()</code> or a
132
132
                <code class="function">bonobo_activate()</code> followed by
138
138
</div>
139
139
<hr>
140
140
<div class="refsect2" lang="en">
141
 
<a name="id2665927"></a><h3>Getting more information</h3>
 
141
<a name="id2666042"></a><h3>Getting more information</h3>
142
142
<p>If you are doing serious development consider
143
143
                compiling gtk+, glib and bonobo with debugging
144
144
                symbols:</p>
151
151
</div>
152
152
<hr>
153
153
<div class="refsect2" lang="en">
154
 
<a name="id2665966"></a><h3>Debugging bonobo-activation</h3>
 
154
<a name="id2666082"></a><h3>Debugging bonobo-activation</h3>
155
155
<p> This is often best done by running: </p>
156
156
<span><strong class="command"><pre class="screen">
157
157
gdb ./bonobo-activation
162
162
</div>
163
163
<hr>
164
164
<div class="refsect2" lang="en">
165
 
<a name="id2665991"></a><h3>The last resort</h3>
 
165
<a name="id2666106"></a><h3>The last resort</h3>
166
166
<p>And finally when the handfuls of hair are coming out
167
167
                thick and fast, consider reading the source, it only
168
168
                looks scary, it won't bite.</p>
169
169
</div>
170
170
<hr>
171
171
<div class="refsect2" lang="en">
172
 
<a name="id2666002"></a><h3>Talk to the experts.</h3>
 
172
<a name="id2666117"></a><h3>Talk to the experts.</h3>
173
173
<p> Try reading the mailing list <a href="http://www.gnome.org/mailing-lists/archives/gnome-components-list/" target="_top">
174
174
            archive </a>.  </p>
175
175
<p>