You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: NEWS.md
+43-13Lines changed: 43 additions & 13 deletions
Original file line number
Diff line number
Diff line change
@@ -337,7 +337,10 @@ as the tidyverse is committed to support 5 major versions of R.
337
337
338
338
## Breaking changes
339
339
340
-
This is a minor release and breaking changes have been kept to a minimum. End users of ggplot2 are unlikely to encounter any issues. However, there are a few items that developers of ggplot2 extensions should be aware of. For additional details, see also the discussion accompanying issue #2890.
340
+
This is a minor release and breaking changes have been kept to a minimum. End users of
341
+
ggplot2 are unlikely to encounter any issues. However, there are a few items that developers
342
+
of ggplot2 extensions should be aware of. For additional details, see also the discussion
343
+
accompanying issue #2890.
341
344
342
345
* In non-user-facing internal code (specifically in the `aes()` function and in
343
346
the `aesthetics` argument of scale functions), ggplot2 now always uses the British
@@ -937,25 +940,45 @@ This is a minor release and breaking changes have been kept to a minimum. End us
937
940
938
941
### Subtitle and caption
939
942
940
-
Thanks to @hrbrmstr plots now have subtitles and captions, which can be set with the `subtitle` and `caption` arguments to `ggtitle()` and `labs()`. You can control their appearance with the theme settings `plot.caption` and `plot.subtitle`. The main plot title is now left-aligned to better work better with a subtitle. The caption is right-aligned (@hrbrmstr).
943
+
Thanks to @hrbrmstr plots now have subtitles and captions, which can be set with
944
+
the `subtitle` and `caption` arguments to `ggtitle()` and `labs()`. You can
945
+
control their appearance with the theme settings `plot.caption` and
946
+
`plot.subtitle`. The main plot title is now left-aligned to better work better
947
+
with a subtitle. The caption is right-aligned (@hrbrmstr).
941
948
942
949
### Stacking
943
950
944
-
`position_stack()` and `position_fill()` now sort the stacking order to match grouping order. This allows you to control the order through grouping, and ensures that the default legend matches the plot (#1552, #1593). If you want the opposite order (useful if you have horizontal bars and horizontal legend), you can request reverse stacking by using `position = position_stack(reverse = TRUE)` (#1837).
951
+
`position_stack()` and `position_fill()` now sort the stacking order to match
952
+
grouping order. This allows you to control the order through grouping, and
953
+
ensures that the default legend matches the plot (#1552, #1593). If you want the
954
+
opposite order (useful if you have horizontal bars and horizontal legend), you
955
+
can request reverse stacking by using `position = position_stack(reverse = TRUE)`
956
+
(#1837).
945
957
946
-
`position_stack()` and `position_fill()` now accepts negative values which will create stacks extending below the x-axis (#1691).
958
+
`position_stack()` and `position_fill()` now accepts negative values which will
959
+
create stacks extending below the x-axis (#1691).
947
960
948
-
`position_stack()` and `position_fill()` gain a `vjust` argument which makes it easy to (e.g.) display labels in the middle of stacked bars (#1821).
961
+
`position_stack()` and `position_fill()` gain a `vjust` argument which makes it
962
+
easy to (e.g.) display labels in the middle of stacked bars (#1821).
949
963
950
964
### Layers
951
965
952
-
`geom_col()` was added to complement `geom_bar()` (@hrbrmstr). It uses `stat="identity"` by default, making the `y` aesthetic mandatory. It does not support any other `stat_()` and does not provide fallback support for the `binwidth` parameter. Examples and references in other functions were updated to demonstrate `geom_col()` usage.
966
+
`geom_col()` was added to complement `geom_bar()` (@hrbrmstr). It uses
967
+
`stat="identity"` by default, making the `y` aesthetic mandatory. It does not
968
+
support any other `stat_()` and does not provide fallback support for the
969
+
`binwidth` parameter. Examples and references in other functions were updated to
970
+
demonstrate `geom_col()` usage.
953
971
954
-
When creating a layer, ggplot2 will warn if you use an unknown aesthetic or an unknown parameter. Compared to the previous version, this is stricter for aesthetics (previously there was no message), and less strict for parameters (previously this threw an error) (#1585).
972
+
When creating a layer, ggplot2 will warn if you use an unknown aesthetic or an
973
+
unknown parameter. Compared to the previous version, this is stricter for
974
+
aesthetics (previously there was no message), and less strict for parameters
975
+
(previously this threw an error) (#1585).
955
976
956
977
### Facetting
957
978
958
-
The facet system, as well as the internal panel class, has been rewritten in ggproto. Facets are now extendable in the same manner as geoms and stats, as described in `vignette("extending-ggplot2")`.
979
+
The facet system, as well as the internal panel class, has been rewritten in
980
+
ggproto. Facets are now extendable in the same manner as geoms and stats, as
981
+
described in `vignette("extending-ggplot2")`.
959
982
960
983
We have also added the following new fatures.
961
984
@@ -977,7 +1000,10 @@ We have also added the following new fatures.
977
1000
978
1001
### Extensions
979
1002
980
-
Unfortunately there was a major oversight in the construction of ggproto which lead to extensions capturing the super object at package build time, instead of at package run time (#1826). This problem has been fixed, but requires re-installation of all extension packages.
1003
+
Unfortunately there was a major oversight in the construction of ggproto which
1004
+
lead to extensions capturing the super object at package build time, instead of
1005
+
at package run time (#1826). This problem has been fixed, but requires
1006
+
re-installation of all extension packages.
981
1007
982
1008
## Scales
983
1009
@@ -1012,7 +1038,10 @@ Unfortunately there was a major oversight in the construction of ggproto which l
1012
1038
1013
1039
### Discrete scales
1014
1040
1015
-
The treatment of missing values by discrete scales has been thoroughly overhauled (#1584). The underlying principle is that we can naturally represent missing values on discrete variables (by treating just like another level), so by default we should.
1041
+
The treatment of missing values by discrete scales has been thoroughly
1042
+
overhauled (#1584). The underlying principle is that we can naturally represent
1043
+
missing values on discrete variables (by treating just like another level), so
1044
+
by default we should.
1016
1045
1017
1046
This principle applies to:
1018
1047
@@ -1343,7 +1372,8 @@ There were a number of tweaks to the theme elements that control legends:
1343
1372
1344
1373
### Extensibility
1345
1374
1346
-
There is now an official mechanism for defining Stats, Geoms, and Positions in other packages. See `vignette("extending-ggplot2")` for details.
1375
+
There is now an official mechanism for defining Stats, Geoms, and Positions in
1376
+
other packages. See `vignette("extending-ggplot2")` for details.
1347
1377
1348
1378
* All Geoms, Stats and Positions are now exported, so you can inherit from them
1349
1379
when making your own objects (#989).
@@ -1414,7 +1444,7 @@ A number of geoms have been renamed to be internally consistent:
1414
1444
to `geom_density_2d()`/`stat_density_2d()`.
1415
1445
1416
1446
* `stat_spoke()` is now `geom_spoke()` since I realised it'sa
1417
-
reparameterisationof `geom_segment().
1447
+
reparameterisationof`geom_segment()`.
1418
1448
1419
1449
*`stat_bindot()`hasbeenremovedbecauseit's so tightly coupled to
1420
1450
`geom_dotplot()`. If you happened to use `stat_bindot()`, just change to
0 commit comments