AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2024-11-10 02:40:11 +00:00
Code Issues Projects Releases Wiki Activity

docs: Mention G_ENABLE_DIAGNOSTIC in the porting notes

Browse Source 
Since part of our type system is resolved at run time, we need to use
run time facilities to get diagnostic messages, like deprecation
warnings for properties and signals.

We should mention the G_ENABLE_DIAGNOSTIC environment variable in the
migration guide, to let developers know how to catch deprecations and
changes while porting their code.
This commit is contained in:
Emmanuele Bassi 2018-02-09 19:36:00 +00:00
parent d54321c1ca
commit 5c3c95a96c
1 changed files with 15 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
docs/reference/gtk/migrating-3to4.xml
View File

@ -52,6 +52,21 @@
</para>
</section>
<section>
<title>Enable diagnostic warnings</title>
<para>
Deprecations of properties and signals cannot be caught at compile
time, as both properties and signals are installed and used after
types have been instantiated. In order to catch deprecations and
changes in the run time components, you should use the
<envar>G_ENABLE_DIAGNOSTIC</envar> environment variable when
running your application, e.g.:
<programlisting>
G_ENABLE_DIAGNOSTIC=1 ./your-app
</programlisting>
</para>
</section>
<section>
<title>Do not use widget style properties</title>
<para>