Improve documentation around deprecations

docs/reference/glib/Makefile.am

@@ -64,7 +64,6 @@ content_files =				\
 	running.sgml			\
 	building.sgml			\
 	changes.sgml			\
-	compiling.sgml			\
 	resources.sgml			\
 	regex-syntax.sgml		\
 	version.xml			\
@@ -74,6 +73,9 @@ content_files =				\
 	gvariant-varargs.xml		\
 	gvariant-text.xml
 
+expand_content_files = 			\
+	compiling.sgml
+
 # Extra options to supply to gtkdoc-fixref
 FIXXREF_OPTIONS=--extra-dir=$(srcdir)/../gobject/html --extra-dir=$(srcdir)/../gio/html
 

docs/reference/glib/compiling.sgml

@@ -75,7 +75,7 @@ Deprecated GLib functions are annotated to make the compiler
 emit warnings when they are used (e.g. with gcc, you need to use
 the -Wdeprecated-declarations option). If these warnings are
 problematic, they can be turned off by defining the preprocessor
-symbol GLIB_DISABLE_DEPRECATION_WARNINGS by using the commandline
+symbol %GLIB_DISABLE_DEPRECATION_WARNINGS by using the commandline
 option <literal>-DGLIB_DISABLE_DEPRECATION_WARNINGS</literal>
 </para>
 

docs/reference/glib/glib-docs.sgml

@@ -32,7 +32,7 @@
 
     <xi:include href="building.sgml" />
     <xi:include href="cross.sgml" />
-    <xi:include href="compiling.sgml" />
+    <xi:include href="xml/compiling.sgml" />
     <xi:include href="running.sgml" />
     <xi:include href="changes.sgml" />
     <xi:include href="resources.sgml" />

docs/reference/glib/glib-sections.txt

@@ -120,6 +120,7 @@ GLIB_VERSION_2_30
 GLIB_VERSION_2_32
 GLIB_VERSION_MIN_REQUIRED
 GLIB_VERSION_MAX_ALLOWED
+GLIB_DISABLE_DEPRECATION_WARNINGS
 </SECTION>
 
 <SECTION>