[libadwaita/wip/exalm/docs: 1/4] window: Clarify docs around child/content

[Alexander Mikhaylenko <alexm src gnome org>]

commit 971b247fda5982aef00f2ebc7da556614e5477e0
Author: Alexander Mikhaylenko <alexm gnome org>
Date:   Wed Aug 10 15:27:29 2022 +0400

    window: Clarify docs around child/content

 src/adw-application-window.c | 2 ++
 src/adw-window.c             | 7 +++++--
 2 files changed, 7 insertions(+), 2 deletions(-)
---
diff --git a/src/adw-application-window.c b/src/adw-application-window.c
index 72e2b599..c218e0d0 100644
--- a/src/adw-application-window.c
+++ b/src/adw-application-window.c
@@ -126,6 +126,8 @@ adw_application_window_class_init (AdwApplicationWindowClass *klass)
    *
    * The content widget.
    *
+   * This property should always be used instead of [property@Gtk.Window:child].
+   *
    * Since: 1.0
    */
   props[PROP_CONTENT] =
diff --git a/src/adw-window.c b/src/adw-window.c
index 65da591a..074a1cae 100644
--- a/src/adw-window.c
+++ b/src/adw-window.c
@@ -38,8 +38,9 @@
  * </object>
  * ```
  *
- * Using [method@Gtk.Window.get_titlebar] and [method@Gtk.Window.set_titlebar]
- * is not supported and will result in a crash.
+ * Using [property@Gtk.Window:titlebar] or [property@Gtk.Window:child]
+ * is not supported and will result in a crash. Use [property@Window:content]
+ * instead.
  *
  * Since: 1.0
  */
@@ -140,6 +141,8 @@ adw_window_class_init (AdwWindowClass *klass)
    *
    * The content widget.
    *
+   * This property should always be used instead of [property@Gtk.Window:child].
+   *
    * Since: 1.0
    */
   props[PROP_CONTENT] =