Fixes #2679

Author: bjreisman

NEWS.md

@@ -1,5 +1,20 @@
-# ggplot2 2.2.1.9000
-To be released as 2.3.0
+# ggplot2 3.0.0.9000
+*   `stat_contour()`, `stat_density2d()`, `stat_bin2d()`,  `stat_binhex()` also
+    now calculate normalized statistics including `nlevel`, `ndensity`, and
+    `ncount`. (@bjreisman, #2679)
+    
+*   `stat_density()` now includes the calculated statistic `nlevel`, an alias 
+    for `scaled`, to better match the syntax of `stat_bin()` (@bjreisman, #2679)
+    
+*  `geom_hex()` now understands the `size` and `linetype` aesthetics
+   (@mikmart, #2488).
+  
+*   Data is no longer internally reordered when faceting. This makes it safer to
+    feed data columns into `aes()` or into parameters of geoms or stats. However,
+    doing so remains discouraged (@clauswilke).
+
+
+# ggplot2 3.0.0
 
 ## Breaking changes
 
@@ -18,10 +33,11 @@ To be released as 2.3.0
     constants (like `aes(x = 1)` or `aes(colour = "smoothed")`) are stored
     as is.
 
-    In this version of ggplot2, you need to describe a mapping in a string, 
-    use `quo_name()` (for shorter labels) or `quo_text()` (if you want 
-    everything). If you do need to extract the value of a variable instead use 
-    `rlang::eval_tidy()`. You may want to condition on 
+    In this version of ggplot2, if you need to describe a mapping in a string, 
+    use `quo_name()` (to generate single-line strings; longer expressions may 
+    be abbreviated) or `quo_text()` (to generate non-abbreviated strings that
+    may span multiple lines). If you do need to extract the value of a variable
+    instead use `rlang::eval_tidy()`. You may want to condition on 
     `(packageVersion("ggplot2") <= "2.2.1")` so that your code can work with
     both released and development versions of ggplot2.
 
@@ -157,17 +173,6 @@ To be released as 2.3.0
 
 ### Layers: geoms, stats, and position adjustments
 
-* `stat_contour()`, `stat_density2d()`, `stat_bin2d()`,  `stat_binhex()` now
-  include  a normalized version the `level`, `density`, and `count` parameters, 
-  named `nlevel`, `ndensity`, and `ncount`. This mirrors the use of `ndensity`
-  in `stat_density()` and `ncount`/`ndensity` in `stat_bin()`. These stats
-  should be useful for faceted 2D density plots and bin plots in cases where
-  the distribution of density within a facet is more relevant than the absolute
-  density or count across facets. (@bjreisman, #2680)
-
-* `stat_density()` now includes the calculated statistic `nlevel`, an alias 
-  for `scaled`, to better match the syntax of `stat_bin` (@bjreisman, #2680)
-
 * `geom_segment()` and `geom_curve()` have a new `arrow.fill` parameter which 
   allows you to specify a separate fill colour for closed arrowheads 
   (@hrbrmstr and @clauswilke, #2375).

R/stat-density.r

@@ -21,8 +21,8 @@
 #'   \item{count}{density * number of points - useful for stacked density
 #'      plots}
 #'   \item{scaled}{density estimate, scaled to maximum of 1}
-#'   \item{ndensity}{alias for stat(scaled), to mirror the syntax of
-#'    geom_bin}
+#'   \item{ndensity}{alias for `stat(scaled)`, to mirror the syntax of
+#'    `geom_bin()`}
 #' }
 #' @export
 #' @rdname geom_density