Add news for theme doc changes

Author: arcresu

NEWS.md

@@ -1,67 +1,71 @@
 # ggplot2 (development version)
 
-* `geom_boxplot()`/`stat_boxplot()` gain a `quantile.type` parameter (default `7`) 
-   to control the percentile definition used for hinges and median; set `quantile.type = 2` 
-   to match SAS's default `PCTLDEF = 5`, enabling parity with SAS boxplots out-of-the-box. 
+* `geom_boxplot()`/`stat_boxplot()` gain a `quantile.type` parameter (default `7`)
+   to control the percentile definition used for hinges and median; set `quantile.type = 2`
+   to match SAS's default `PCTLDEF = 5`, enabling parity with SAS boxplots out-of-the-box.
    (@munoztd0, #6819)
 * `make_constructor()` no longer captures `rlang::list2()` at build time.
-* The `arrow` and `arrow.fill` arguments are now available in 
+* The `arrow` and `arrow.fill` arguments are now available in
   `geom_linerange()` and `geom_pointrange()` layers (@teunbrand, #6481).
 * (internal) `zeroGrob()` now returns a `grid::nullGrob()` (#6390).
 * `stat_ydensity()` now only requires the `x` or `y` aesthetic. The other will
   be populated with 0, similar to `stat_boxplot()` (@teunbrand, #6600)
-* Implemented `as.list()` and `S7::convert()` methods for lists and classes in ggplot2 
+* Implemented `as.list()` and `S7::convert()` methods for lists and classes in ggplot2
   (@teunbrand, #6695)
-* The default linetype in `geom_sf()` is derived from `geom_polygon()` for 
+* The default linetype in `geom_sf()` is derived from `geom_polygon()` for
   polygons and from `geom_line()` for (multi)linestrings (@teunbrand, #6543).
-* Using infinite `radius` aesthetic in `geom_spoke()` now throws a warning 
+* Using infinite `radius` aesthetic in `geom_spoke()` now throws a warning
   (#6671)
 * Scales and guides specified by a string can now use package name prefixes to
   indicate a namespace wherein to look for the scale/guide. For example, one can
   use `scale_x_continuous(guide = "legendry::axis_base")` (@teunbrand, #4705).
-* `get_layer_data()` and `get_layer_grob()` now accept layer names as index 
+* `get_layer_data()` and `get_layer_grob()` now accept layer names as index
   (@lgaborini, #6724)
-* Added new argument `geom_curve(shape)` that will be passed down to 
+* Added new argument `geom_curve(shape)` that will be passed down to
   `grid::curveGrob()` (@fmarotta, #5998).
 * Fixed a regression where default `width` was miscalculated when some panels
   are empty (@teunbrand, #6758)
 * `geom_hex()` has a new `radius` aesthetic, representing the relative size of
   the hexagons (@teunbrand, #6727)
 * Added `preserve` argument to `position_jitterdodge()` (@teunbrand, #6584).
-* Fixed `position_jitterdodge(jitter.height, jitter.width)` applying to the 
+* Fixed `position_jitterdodge(jitter.height, jitter.width)` applying to the
   wrong dimension with flipped geoms (@teunbrand, #6535).
 * New `position_dodge2(group.row)` argument that can be set to `"many"` to
-  dodge groups with more than one row, such as in `geom_violin()` 
+  dodge groups with more than one row, such as in `geom_violin()`
   (@teunbrand, #6663)
+* `palette.{aes}.discrete` and `palette.{aes}.continuous` are now documented
+  in `theme()` and have a new helper `theme_sub_palette()`.
+  `strip.position.x` and `strip.position.y` are also documented and work
+  with `theme_sub_strip()` (@arcresu, #6829).
 
 # ggplot2 4.0.2
 
 This hotfix release makes ggplot2 more interoperable between rlang versions.
 
 # ggplot2 4.0.1
 
-This is a smaller patch release focussed on fixing regressions from 4.0.0 and 
+This is a smaller patch release focussed on fixing regressions from 4.0.0 and
 polishing the recent features.
 
 ## Bug fixes
 
-* Fixed regression where `geom_area()` didn't draw panels with single groups 
+* Fixed regression where `geom_area()` didn't draw panels with single groups
   when `stat = "align"` (@teunbrand, #6680)
 * Fixed regression where `position_stack(vjust)` was ignored when there are
   only single groups (#6692)
 * Fixed bug where `NA` handling in `geom_path()` was ignoring panels (@teunbrand, #6533)
 * Fixed bug where `stat_bin(boundary)` was ignored (#6682).
-* `geom_text()` and `geom_label()` accept expressions as the `label` aesthetic 
+* `geom_text()` and `geom_label()` accept expressions as the `label` aesthetic
   (@teunbrand, #6638)
-* Fixed regression where `draw_key_rect()` stopped using `fill` colours 
+* Fixed regression where `draw_key_rect()` stopped using `fill` colours
   (@mitchelloharawild, #6609).
 * Fixed regression where `scale_{x,y}_*()` threw an error when an expression
   object is set to `labels` argument (@yutannihilation, #6617).
-* Fixed regression where the first (unnamed) argument to colour/fill scales was 
+* Fixed regression where the first (unnamed) argument to colour/fill scales was
   not passed as the `name` argument (@teunbrand, #6623)
-* Fixed issue where vectorised `arrow()`s caused errors in drawing the 
+* Fixed issue where vectorised `arrow()`s caused errors in drawing the
   legend glyphs (@teunbrand, #6594)
-* Fixed regression where `NULL`-aesthetics contributed to plot labels too 
+* Fixed regression where `NULL`-aesthetics contributed to plot labels too
   insistently. Now they contribute only as fallback labels (@teunbrand, #6616)
 * Fixed regression where empty arguments to colour/fill scale caused errors
   (@jmbarbone, #6710)
@@ -73,10 +77,10 @@ polishing the recent features.
 * Allow `stat` in `geom_hline`, `geom_vline`, and `geom_abline`. (@sierrajohnson, #6559)
 * `stat_boxplot()` treats `width` as an optional aesthetic (@Yunuuuu, #6575)
 * The `theme(panel.widths, panel.heights)` setting attempts to preserve the
-  plot's aspect ratio when only one of the two settings is given, and the plot 
+  plot's aspect ratio when only one of the two settings is given, and the plot
   has a single panel (@teunbrand, #6701).
 * Logical values for the linetype aesthetic will be interpreted numerically,
-  so that `linetype = FALSE` becomes 0/'blank' and `linetype = TRUE` becomes 
+  so that `linetype = FALSE` becomes 0/'blank' and `linetype = TRUE` becomes
   1/'solid' (@teunbrand, #6641)
 * Out-of-bounds datapoints used as padding by `stat_align()` now get removed
   silently rather than verbosely (@teunbrand, #6667)
@@ -98,15 +102,15 @@ polishing the recent features.
     * The `element_geom()` function can be used to populate that argument.
     * The `from_theme()` function allows access to the theme default fields from
       inside the `aes()` function.
-* Moved the following packages in the description. If your package depended on 
-  ggplot2 to install these dependencies, you may need to list these in your 
+* Moved the following packages in the description. If your package depended on
+  ggplot2 to install these dependencies, you may need to list these in your
   own DESCRIPTION file now (#5986).
     * Moved mgcv from Imports to Suggests
     * Moved tibble from Imports to Suggests
     * Removed glue dependency
-* Default labels are derived in `build_ggplot()` (previously `ggplot_build()`) 
-  rather than in the layer method of `update_ggplot()` 
-  (previously `ggplot_add.Layer()`). This may affect code that accessed the 
+* Default labels are derived in `build_ggplot()` (previously `ggplot_build()`)
+  rather than in the layer method of `update_ggplot()`
+  (previously `ggplot_add.Layer()`). This may affect code that accessed the
   `plot$labels` property (@teunbrand, #5894).
 * In binning stats, the default `boundary` is now chosen to better adhere to
   the `nbin` argument. This may affect plots that use default binning
@@ -118,7 +122,7 @@ polishing the recent features.
   of warnings.
 * Functions and arguments that were soft-deprecated up to ggplot2 3.4.0 now
   throw warnings.
-* `annotation_borders()` replaces the now-deprecated `borders()` 
+* `annotation_borders()` replaces the now-deprecated `borders()`
   (@teunbrand, #6392)
 * Turned off fallback for `size` to `linewidth` translation in
   `geom_bar()`/`geom_col()` (#4848).
@@ -144,28 +148,28 @@ polishing the recent features.
   | `get_layer_data()`   | `layer_data()`    |
   | `get_layer_grob()`   | `layer_grob()`    |
   | `get_panel_scales()` | `layer_scales()`  |
-  
+
 * `facet_wrap()` has new options for the `dir` argument for additional control
-  over panel directions. They absorb interactions with the now-deprecated 
+  over panel directions. They absorb interactions with the now-deprecated
   `as.table` argument. Internally `dir = "h"` or `dir = "v"` is deprecated
   (@teunbrand, #5212).
 * `coord_trans()` was renamed to `coord_transform()` (@nmercadeb, #5825).
-  
+
 ### Improvements
 
 #### Themes
 
 * The `theme()` function offers new arguments:
     * `geom` to set defaults for layer aesthetics (#2239).
-    * `spacing`/`margins` as root elements that are inherited by all other 
+    * `spacing`/`margins` as root elements that are inherited by all other
       spacings and (non-text) margins (@teunbrand, #5622).
     * `palette.{aes}.discrete` and `palette.{aes}.continuous` which determine
       the palettes used when scales have `palette = NULL`. This is the new
-      default for generic scales like `scale_colour_discrete()` or 
+      default for generic scales like `scale_colour_discrete()` or
       `scale_fill_continuous()`, see also the 'Scales' section (#4696).
     * `panel.widths` and `panel.heights` to control the (absolute) size of the
       panels (#5338, @teunbrand).
-    * `legend.key.justification` to control the alignment of legend keys 
+    * `legend.key.justification` to control the alignment of legend keys
       (@teunbrand, #3669)
 * Built-in `theme_*()` functions have new arguments:
     * `ink`/`paper`/`accent` to control foreground, background and highlight
@@ -193,39 +197,39 @@ polishing the recent features.
     * Axis line ends are now `"square"`.
     * The panel grid is now blank at the `panel.grid` hierarchy level instead of
     the `panel.grid.major` and `panel.grid.minor` levels.
-* The `theme(legend.spacing.{x/y})` setting now accepts `null`-units 
+* The `theme(legend.spacing.{x/y})` setting now accepts `null`-units
   (@teunbrand, #6417).
 
 #### Scales
 
-* The default colour and fill scales have a new `palette` argument. The default, 
+* The default colour and fill scales have a new `palette` argument. The default,
   `palette = NULL` will retrieve palettes from the theme (see the Themes section).
-  This replaces the old options-based `type` system, with some limited backward 
+  This replaces the old options-based `type` system, with some limited backward
   compatibility (@teunbrand, #6064).
 * All scales now expose the `aesthetics` parameter (@teunbrand, #5841)
 * All position scales now use the same definition of `x` and `y` aesthetics.
   This lets uncommon aesthetics like `xintercept` expand scales as usual.
   (#3342, #4966, @teunbrand)
-* In continuous scales, when `breaks` is a function and `n.breaks` is set, the 
-  `n.breaks` will be passed to the `breaks` function. Previously, `n.breaks` 
+* In continuous scales, when `breaks` is a function and `n.breaks` is set, the
+  `n.breaks` will be passed to the `breaks` function. Previously, `n.breaks`
   only applied to the default break calculation (@teunbrand, #5972).
 * Changes in discrete scales:
-    * Added `palette` argument, which can be used to customise spacings between 
+    * Added `palette` argument, which can be used to customise spacings between
       levels (@teunbrand, #5770)
     * Added `continuous.limits` argument to control the display range
       (@teunbrand, #4174, #6259).
     * Added `minor_breaks` argument. This only makes sense in position scales,
       where it affects the placement of minor ticks and minor gridlines (#5434).
     * Added `sec.axis` argument. Discrete scales don't support transformations
       so it is recommended to use  `dup_axis()` to set custom breaks or labels.
-      Secondary discrete axes work with the continuous analogues of discrete 
+      Secondary discrete axes work with the continuous analogues of discrete
       breaks (@teunbrand, #3171)
     * When `breaks` yields a named vector, the names will be used as `labels`
       by default (@teunbrand, #6147).
 * Changes in date/time scales:
-    * <POSIXct> is silently cast to <Date> in date scales. Vice versa, <Date> 
+    * <POSIXct> is silently cast to <Date> in date scales. Vice versa, <Date>
       is cast to <POSIXct> in datetime scales (@laurabrianna, #3533)
-    * Bare numeric provided to date or datetime scales get inversely transformed 
+    * Bare numeric provided to date or datetime scales get inversely transformed
       (i.e. cast to <Date>/<POSIXct>) with a warning (@teunbrand)
     * The `date_breaks`, `date_minor_breaks` and `date_labels` arguments have
       been copied over to `scale_{x/y}_time()` (@teunbrand, #4335).
@@ -241,8 +245,8 @@ polishing the recent features.
   argument (#4021, @teunbrand).
 * `coord_*(expand)` can now take a logical vector to control expansion at any
   side of the panel (top, right, bottom, left) (@teunbrand, #6020)
-* New `coord_cartesian(ratio)` argument that absorbs the aspect ratio 
-  functionality from `coord_equal()` and `coord_fixed()`, which are now 
+* New `coord_cartesian(ratio)` argument that absorbs the aspect ratio
+  functionality from `coord_equal()` and `coord_fixed()`, which are now
   wrappers for `coord_cartesian()`.
 * In non-orthogonal coordinate systems (`coord_sf()`, `coord_polar()` and
   `coord_radial()`), using 'AsIs' variables escape transformation when
@@ -354,7 +358,7 @@ polishing the recent features.
   instead of just rendering the axis line (@teunbrand, #5816).
 * Better handling of the `guide_axis_logticks(negative.small)` parameter when
   scale limits have small maximum (@teunbrand, #6121).
-* Fixed regression in `guide_bins(reverse = TRUE)` (@teunbrand, #6183).  
+* Fixed regression in `guide_bins(reverse = TRUE)` (@teunbrand, #6183).
 * Binned guides now accept expressions as labels (@teunbrand, #6005)
 * Fixed bug where binned scales wouldn't simultaneously accept transformations
   and function-limits (@teunbrand, #6144).
@@ -368,12 +372,12 @@ polishing the recent features.
 * Secondary axes respect `n.breaks` setting in continuous scales (@teunbrand, #4483).
 * The size of the `draw_key_polygon()` glyph now reflects the `linewidth`
   aesthetic which internally defaults to 0 (#4852).
-* `draw_key_rect()` replaces a `NA` fill by the `colour` aesthetic 
+* `draw_key_rect()` replaces a `NA` fill by the `colour` aesthetic
   (@teunbrand, #5385, #5756).
 * Fixed bug where `na.value` was incorrectly mapped to non-`NA` values
   (@teunbrand, #5756).
 * Missing values from discrete palettes are no longer inappropriately translated
-  (@teunbrand, #5929). 
+  (@teunbrand, #5929).
 * Fixed bug where empty discrete scales weren't recognised as such
   (@teunbrand, #5945).
 * Fixed regression with incorrectly drawn gridlines when using `coord_flip()`
@@ -426,7 +430,7 @@ polishing the recent features.
   (@teunbrand, #1864).
 * Prevented `facet_wrap(..., drop = FALSE)` from throwing spurious errors when
   a character facetting variable contained `NA`s (@teunbrand, #5485).
-  
+
 ## Developer facing
 
 ### Utilities
@@ -450,7 +454,7 @@ polishing the recent features.
 * New function `get_strip_labels()` to retrieve facet labels (@teunbrand, #4979)
 * The ViewScale class has a `make_fixed_copy()` method to permit
   copying trained position scales (#3441).
-  
+
 ### Internal changes
 
 * Facet gains a new method `setup_panel_params` to interact with the
@@ -461,15 +465,15 @@ polishing the recent features.
 * Using `after_scale()` in the `Geom*$default_aes` field is now
   evaluated in the context of data (@teunbrand, #6135)
 * Improvements to `pal_qualitative()` (@teunbrand, #5013)
-* Panel clipping responsibility moved from Facet class to Coord class through 
+* Panel clipping responsibility moved from Facet class to Coord class through
   new `Coord$draw_panel()` method.
 * Rearranged the code of `Facet$draw_panels()` method (@teunbrand).
 * Added `gg` class to `labs()` (@phispu, #5553).
-* The plot's layout now has a coord parameter that is used to prevent setting 
+* The plot's layout now has a coord parameter that is used to prevent setting
   up identical panel parameters more than once (#5427)
-* Applying defaults in `geom_sf()` has moved from the internal `sf_grob()` to 
+* Applying defaults in `geom_sf()` has moved from the internal `sf_grob()` to
   `GeomSf$use_defaults()` (@teunbrand).
-* New `Facet$draw_panel_content()` method for delegating panel 
+* New `Facet$draw_panel_content()` method for delegating panel
   assembly (@Yunuuuu, #6406).
 * Layer data can be attenuated with parameter attributes (@teunbrand, #3175).
 * When facets coerce the faceting variables to factors, the 'ordered' class
@@ -478,15 +482,15 @@ polishing the recent features.
   alignment is not necessary (#5788).
 * `position_stack()` skips computation when all `x` values are unique and
   therefore stacking is not necessary (#5788).
-* The summary function of `stat_summary()` and `stat_summary_bin()` is setup 
+* The summary function of `stat_summary()` and `stat_summary_bin()` is setup
   once in total instead of once per group (@teunbrand, #5971)
 * Removed barriers for using 2D structures as aesthetics (@teunbrand, #4189).
 * Stricter check on `register_theme_elements(element_tree)` (@teunbrand, #6162)
 * The `legend.key.width` and `legend.key.height` calculations are no
   longer precomputed before guides are drawn (@teunbrand, #6339)
 * When `validate_subclass()` fails to find a class directly, it tries
   to retrieve the class via constructor functions (@teunbrand).
-  
+
 # ggplot2 3.5.2
 
 This is a small release focusing on providing infrastructure for other packages