Merge branch 'css-docs' into 'master'

Shorten CSS docs

See merge request GNOME/gtk!1712

NEWS

@@ -13,9 +13,23 @@ Overview of Changes in GTK 3.98.3
 * GtkEmojiChooser:
  - Improve keyboard navigation
 
+* GtkLabel:
+ - Remove pattern API
+
+* GtkAspectFrame:
+ - Modernize and simplify
+
 * Chooser buttons:
  - Make dialogs modal by default
 
+* Various widgets:
+ - Replace shadow-type and relief properties by
+   a simpler has-frame
+
+* CSS:
+ - Use :focus-visible instead of :focus(visible)
+ - Add support for :focus-within
+
 * Focus handling
  - Fix crossing event generation
  - Fix focus handling in various widgets
@@ -41,10 +55,13 @@ Overview of Changes in GTK 3.98.3
  - Simplify modifier support, drop GdkModifierIntent
  - Move key event matching to GDK
  - Add GdkSurface::enter/leave-monitor signals
+ - Turn GskEvent into a derivable type, and make
+   it introspectable
 
 * GSK:
  - Turn GskRenderNode into a derivable type, and make
    it introspectable
+ - Fall back to cairo if compiling shaders fails
 
 * Translation updates:
  - Japanese

docs/reference/gtk/gtk4-docs.xml

@@ -371,7 +371,6 @@
   <part id="theming">
     <title>Theming in GTK</title>
     <xi:include href="css-overview.xml" />
-    <xi:include href="css-properties.xml" />
     <xi:include href="xml/gtkstylecontext.xml" />
     <xi:include href="xml/gtkcssprovider.xml" />
     <xi:include href="xml/gtkstyleprovider.xml" />

docs/reference/gtk/meson.build

@@ -343,7 +343,6 @@ content_files = [
   'building.xml',
   'compiling.xml',
   'css-overview.xml',
-  'css-properties.xml',
   'drawing-model.xml',
   'glossary.xml',
   'gtk4-broadwayd.xml',

gtk/gtkdrawingarea.c

@@ -52,7 +52,7 @@ static GParamSpec *props[LAST_PROP] = { NULL, };
 
 /**
  * SECTION:gtkdrawingarea
- * @Short_description: A simple widget for custom user interface elements
+ * @Short_description: A simple widget for drawing with cairo
  * @Title: GtkDrawingArea
  * @See_also: #GtkImage
  *

gtk/gtkfilechooserbutton.c

@@ -65,7 +65,7 @@
 
 /**
  * SECTION:gtkfilechooserbutton
- * @Short_description: A button to launch a file selection dialog
+ * @Short_description: A button to launch a file chooser dialog
  * @Title: GtkFileChooserButton
  * @See_also:#GtkFileChooserDialog
  *

gtk/gtkfilechooserdialog.c

@@ -43,12 +43,12 @@
 
 /**
  * SECTION:gtkfilechooserdialog
- * @Short_description: A file chooser dialog, suitable for “File/Open” or “File/Save” commands
+ * @Short_description: A file chooser dialog, suitable for “File Open” or “File Save” commands
  * @Title: GtkFileChooserDialog
  * @See_also: #GtkFileChooser, #GtkDialog, #GtkFileChooserNative
  *
  * #GtkFileChooserDialog is a dialog box suitable for use with
- * “File/Open” or “File/Save as” commands.  This widget works by
+ * “File Open” or “File Save” commands.  This widget works by
  * putting a #GtkFileChooserWidget inside a #GtkDialog.  It exposes
  * the #GtkFileChooser interface, so you can use all of the
  * #GtkFileChooser functions on the file chooser dialog as well as

gtk/gtkfilechoosernative.c

@@ -43,12 +43,12 @@
 
 /**
  * SECTION:gtkfilechoosernative
- * @Short_description: A native file chooser dialog, suitable for “File/Open” or “File/Save” commands
+ * @Short_description: A native file chooser dialog, suitable for “File Open” or “File Save” commands
  * @Title: GtkFileChooserNative
  * @See_also: #GtkFileChooser, #GtkNativeDialog, #GtkFileChooserDialog
  *
  * #GtkFileChooserNative is an abstraction of a dialog box suitable
- * for use with “File/Open” or “File/Save as” commands. By default, this
+ * for use with “File Open” or “File Save as” commands. By default, this
  * just uses a #GtkFileChooserDialog to implement the actual dialog.
  * However, on certain platforms, such as Windows and macOS, the native platform
  * file chooser is used instead. When the application is running in a
@@ -56,10 +56,13 @@
  * #GtkFileChooserNative may call the proper APIs (portals) to let the user
  * choose a file and make it available to the application.
  *
- * While the API of #GtkFileChooserNative closely mirrors #GtkFileChooserDialog, the main
- * difference is that there is no access to any #GtkWindow or #GtkWidget for the dialog.
- * This is required, as there may not be one in the case of a platform native dialog.
- * Showing, hiding and running the dialog is handled by the #GtkNativeDialog functions.
+ * While the API of #GtkFileChooserNative closely mirrors #GtkFileChooserDialog,
+ * the main difference is that there is no access to any #GtkWindow or #GtkWidget
+ * for the dialog. This is required, as there may not be one in the case of a
+ * platform native dialog.
+ *
+ * Showing, hiding and running the dialog is handled by the #GtkNativeDialog
+ * functions.
  *
  * ## Typical usage ## {#gtkfilechoosernative-typical-usage}
  *