[gtk/a11y/buildable: 3/3] docs: Document the "accessibility" custom tag

[Emmanuele Bassi <ebassi src gnome org>]

commit 7702670d86e7339fa0437df4be4df37d88711efb
Author: Emmanuele Bassi <ebassi gnome org>
Date:   Wed Oct 21 13:33:06 2020 +0100

    docs: Document the "accessibility" custom tag

 gtk/gtkwidget.c | 21 ++++++++++++++++-----
 1 file changed, 16 insertions(+), 5 deletions(-)
---
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 126712b9c8..8747e8efcd 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -248,8 +248,8 @@
  *
  * # GtkWidget as GtkBuildable
  *
- * The GtkWidget implementation of the GtkBuildable interface supports a
- * custom <accelerator> element, which has attributes named ”key”, ”modifiers”
+ * The GtkWidget implementation of the #GtkBuildable interface supports a
+ * custom `<accelerator>` element, which has attributes named ”key”, ”modifiers”
  * and ”signal” and allows to specify accelerators.
  *
  * An example of a UI definition fragment specifying an accelerator:
@@ -260,7 +260,7 @@
  * ]|
  *
  * If the parent widget uses a #GtkLayoutManager, #GtkWidget supports a
- * custom <layout> element, used to define layout properties:
+ * custom `<layout>` element, used to define layout properties:
  *
  * |[
  * <object class="MyGrid" id="grid1">
@@ -288,8 +288,8 @@
  * </object>
  * ]|
  *
- * Finally, GtkWidget allows style information such as style classes to
- * be associated with widgets, using the custom <style> element:
+ * GtkWidget allows style information such as style classes to
+ * be associated with widgets, using the custom `<style>` element:
  * |[
  * <object class="GtkButton" id="button1">
  *   <style>
@@ -299,6 +299,17 @@
  * </object>
  * ]|
  *
+ * GtkWidget allows defining accessibility information, such as properties,
+ * relations, and states, using the custom `<accessibility>` element:
+ * |[
+ * <object class="GtkButton" id="button1">
+ *   <accessibility>
+ *     <property name="label">Download</property>
+ *     <relation name="labelled-by">label1</relation>
+ *   </accessibility>
+ * </object>
+ * ]|
+ *
  * # Building composite widgets from template XML ## {#composite-templates}
  *
  * GtkWidget exposes some facilities to automate the procedure