Changes in version 3.2.0 (2026-03-04) - Added input validation: error if a mean lies outside its confidence limits or if a lower bound exceeds its upper bound. Prevents missing boxes and internal Inf/logical errors when working with negative estimates. - New fp_span() helper (and span attribute) allows a label to occupy multiple text columns. Useful for centering sub‑headers such as "Events / N" beneath several adjacent columns. - New fp_extract_labeltext() helper simplifies label column extraction for both grouped and ungrouped data, with optional column renaming and NA replacement. - New selector-style post-processing helpers fp_align_where(), fp_txt_where(), and fp_span_where() allow row/column/cell targeted alignment, text styling, and spanning directly on gforge_forestplot objects. - New fp_set_summary() helper allows setting summary rows on existing gforge_forestplot objects using selector-style predicates in a pipe flow. - Internal label handling now tolerates grid grobs and other non-atomic objects in labeltext. Previously such values could trigger coercion errors during preparation; these are now treated as valid content. - New fp_set_favors() helper allows setting the "favors" text on existing gforge_forestplot objects in a pipe flow. Changes in version 3.1.7 (2025-06-12) - Fixed box issue when first row is not a header (issue #70) Changes in version 3.1.6 (2024-11-19) - Fixed grouped_df for dplyr dataframes (issue #69) Changes in version 3.1.5 (2024-10-11) - Fixed xticks bug with log transformation (issue #67) Changes in version 3.1.4 - Fixed lineheight bug (issue #64) Changes in version 3.1.3 (2023-08-26) - Fixed bug for horizontal legends (issue #59) Changes in version 3.1.2 - Fixed bug width single row forestplots (issue #57) Changes in version 3.1.1 (2022-12-06) - Fixed missing grid parameter - Fixed zebra style issue when no header is present and also graph box fill defaults now defaults to NA to allow zebra style. Also fixed multiple sub-headers. - Fixed bad handling when providing ticks with xlog transformation Changes in version 3.1.0 (2022-10-09) - Added fp_add_lines() for superseding hrzl_lines argument and also adding the option of vertical lines - Fixed align bug and added align to fp_set_style - Fixed width calculation bug - Fixed multi-line NA bug Changes in version 3.0.0 (2022-09-29) - The forestplot() now returns an object with raw data that can be manipulated by subsequent functions prior to plotting. All visual output is now generated during the actual generation of the graph - this allows saving the plot and plotting it when explicitly requested. BREAKING - this may be a breaking feature although most of the old syntax should work without much need for adaptation. - New additive syntax with: - Row manipulation: fp_insert_row, fp_add_header, and fp_append_row - Style functions: fp_set_style, fp_set_zebra_style, and fp_decorate_graph - Text styling: fp_txt_bold, fp_txt_italic, ... - Align functions: fp_align_left, fp_align_center, fp_align_right - Fixed bug with how grouped data frames are processed and presented. - Expressions are now allowed in data.frame tidyverse input. - Moved to native R-pipe operator (|> instead of %>%) - Fixed case when all rows are summaries (Thanks Christian Röver) - Fixed automated ticks. - Fixed bug calculating graph width - Added graph decoration (fixes issue #11) Changes in version 2.0.1 (2021-09-03) - Fixed missing lwd.zero (issue #42) - Fixed ignored clip argument when zero was outside the clip area. - zero-line is now properly ignored when NA Changes in version 2.0 - Changed function so that it returns a gforge_forestplot object instead of directly plotting. The print.gforge_forestplot calls the draw function that converts the object to the actual forestplot. Breaking if you have used the function within loops this will cause a break in the old behavior. - Implemented dplyr compatible API that allows using standard dplyr syntax - Fixed shapes_gp legend bug Changes in version 1.10 (2020-07-16) - Minor improvement for error message when plotting lines - Bugfix for multicolumn expressions (issue #30, thanks André Gillibert) - Added shapes_gp parameter (issue #32, thanks André Gillibert) Changes in version 1.9 (2019-06-24) - Fixed bug for factor label argument Changes in version 1.8 (2019-06-01) - Fixed issue #10 with non-log grid lines - Suppressing the "zero" line #8 - Fixed bug when automatic lower/upper are to be identified and the data contains NA - Fixed bug reported related to legends on SO: https://stackoverflow.com/questions/43217570/forestplot-want-to-give-legend-for-each-4-colums Changes in version 1.7 (2017-01-07) - Fixed bug when merging gpar() with font & fontface options (thanks Katherine T. Mills) - Fixed input bug with 3-dim array - Improved auto detection of upper and lower intervals Changes in version 1.6 (2016-11-14) - Changed forestplot function to S3 style (thanks Christian Röver) - Fixed bug with alignment for summary elements - When any of the inputs is missing for a line the line is skipped (issue #5) - Added checkmate for argument validation - Added option of just specifying the rows that the CI should be applied to (issue #7) - Added fpDrawBarCI (thanks Christian Röver) - Fixed xlog bug - Added a colgap option - Bug fix for plots wider than the div (Thanks Michael Obeda for reporting) Changes in version 1.5 - Changed new_page to default to TRUE - Removed warnings for compatibility - Fixed so that squared multiline tables should now follow color behavior Changes in version 1.4 (2016-01-31) - Added a bug fix for when number of colors isn't equal to the dimension of the input causing the box not to be drawn - Fixed bug concerning vertical offset for clippers Changes in version 1.3 (2015-11-16) - Fixed bug when specifying graphwidth - Added ability to tailor the tick text - Added vertices example to vignette Changes in version 1.2 - Line-type can be specified - Line endings can now be marked by a T vertical, this default for all line types other than 1 - The arrow height defaults to the same height as the vertices - Added a grid option - Improved documentation Changes in version 1.1 (2015-03-10) - Multiple lines can now have NA values - Added ability to position the graph - Added ability to generate horizontal lines - Minor documentation changes Changes in version 1.0 (2014-12-30) - Separation from the Gmisc-package - Name change - forestplot2 is now just forestplot in order to allow a deprecated call within the Gmisc package without generating a conflict - The fontfamily arguments are now embedded in the txt_gp that takes input from the fpTxtGp function. The fonts for the labels/summaries can be specified down to the cell level. - If provided a vector of length two for the zero argument you get an area for the zero-effect - There is a maximum colgap length for the box corresponding to the box height - confintNormalFn, confintSummaryFn, legendMarkerFn are now called fn.ci_norm, fn.ci_sum, fn.legend - Argument main in forestplot has changed to title