# Changelog ## v1.9.0 (2024/10/16) * Replaced buffer length counters with macros to prevent issues with `\includeonly` resetting counters. ## v1.8.0 (2024/09/14) * Added new option `backgroundcolor` (alias `bgcolor`). This provides a basic, `\colorbox`-based implementation of background colors for commands and environments. Added new option `backgroundcolorvphantom` (alias `bgcolorvphantom`) for customizing background height. Added new option `backgroundcolorpadding` (alias `bgcolorpadding`) for customizing padding between text and the edge of the region with background color. * Added option `insertenvname`. This customizes the verbatim environment used by `\VerbatimInsertBuffer`. * When `numberblanklines=false`, `highlightlines` no longer highlights blank lines at the end of a highlighted range (#25, gpoore/minted#226). * An unnecessary line break is no longer inserted before the last "word" of a line when it is preceded by a long "word" that is broken internally as a result of `breakbefore`, `breakafter`, or `breakanywhere` (#26). * Added option `breakpreferspaces` (default `true`). This determines whether line breaks are preferentially inserted at normal spaces rather than at other locations allowed by `breakbefore`, `breakafter`, or `breakanywhere` (#26). * Added option `breakanywhereinlinestretch` (gpoore/minted#387). * `\FVExtraReadVArg` now takes a multi-line (but not multi-paragraph) verbatim argument. The new `\FVExtraReadVArgSingleLine` provides the old functionality of taking an argument restricted to a single line (gpoore/minted#376). * By default, `\Verb` and `\SaveVerb` now take multi-line (but not multi-paragraph) verbatim arguments. The old behavior of requiring verbatim arguments to be on a single line can be restored by setting the new option `vargsingleline` to `true`. * Added documentation for undocumented `fancyvrb` option `listparameters` (gpoore/minted#256). * Expanded `breaklines` documentation with discussion of limitations and alternatives (gpoore/minted#400). ## v1.7.0 (2024/05/16) * Added new command `\VerbatimClearBuffer`. * `VerbatimBuffer` environments with the same buffer name now append to the same buffer, regardless of the value of `globalbuffer`. Previously, `globalbuffer=false` caused any pre-existing buffer to be cleared. Now, `globalbuffer=false` causes anything that is appended to the buffer to be removed at the end of the environment, but the entire buffer is not cleared. * `\FVExtraUnexpandedReadStarOArgMArgBVArg` now checks that the final argument it reads is braced (#22). * Text that immediately follows `\VerbatimInsertBuffer` is no longer indented to start a new paragraph. * Updated `tcblisting` usage in docs for compatibility with the latest `tcolorbox`. ## v1.6.1 (2023/11/28) * Fixed bug from v1.6 that caused a space following a comma to be lost (#21). ## v1.6 (2023/11/19) * Added new environment `VerbatimWrite`. This is similar to `fancyvrb`'s `VerbatimOut`, except that it allows for writing to a file multiple times and guarantees truly verbatim output via `\detokenize`. * Added new environment `VerbatimBuffer`. This stores the contents of an environment verbatim in a "buffer," a sequence of numbered macros each of which contains one line of the environment. The "buffered" lines can then be looped over for further processing or later use. * Added new command `\VerbatimInsertBuffer`. This inserts an existing buffer created by `VerbatimBuffer` as a `Verbatim` environment. * Redefined visible space `\FancyVerbSpace` so that it now has the correct width. It had previously been redefined as `\textvisiblespace`, but that was slightly too narrrow. * Added option `spacebreak`. This determines the line break that is inserted around spaces when `showspaces=true` or `breakcollapsespaces=false`, by defining the new macro `\FancyVerbSpaceBreak`. * `breakbefore`, `breakafter`, and `breakanywhere` now produce plain breaks around spaces when `showspaces=true`, instead of breaks with a break symbol at the end of wrapped lines. `\FancyVerbBreakAnywhereBreak`, `\FancyVerbBreakBeforeBreak`, and `\FancyVerbBreakAfterBreak` are no longer inserted next to spaces. Instead, `\FancyVerbSpaceBreak` is inserted or (depending on options) `\FV@Space` is defined to include `\FancyVerbSpaceBreak`. * Added option `breakcollapsespaces`. When `true` (default), a line break within a run of regular spaces (`showspaces=false`) replaces all spaces with a single break, and the wrapped line after the break starts with a non-space character. When `false`, a line break within a run of regular spaces preserves all spaces, and the wrapped line after the break may start with one or more spaces. This causes regular spaces to behave exactly like the visible spaces produced with `showspaces`; both give identical line breaks, with the only difference being the appearance of spaces. * `breaklines` now automatically enables breaks after space characters when `showspaces=true`. * Reimplemented definition of `\FV@Space` to work with new space options. * Added documentation about how reimplemented commands handle the `codes` option differently compared to `fancyvrb` (#17). * Starred commands such as `\Verb*` now use both visible spaces and visible tabs instead of just visible spaces. This is more similar to the current behavior of `\verb*`, except that `\verb*` converts tabs into visible spaces (#19). * The `mathescape` option now resets the ampersand `&` catcode (#18). ## v1.5 (2022/11/30) * Added `\FancyVerbFormatInline` for customizing the formatting of inline verbatim, such as `\Verb`. This parallels `\FancyVerbFormatLine` and `\FancyVerbFormatText`. * Added line breaking option `breaknonspaceingroup`. When `commandchars` is used to allow macros within verbatim, this inserts breaks within groups `{...}`. * Added `\FVExtraUnexpandedReadStarOArgMArgBVArg` to support reimplementation of `\mintinline` for `minted`. * Added `VerbEnv` environment, which is an environment variant of `\Verb`. This supports reimplementation of `\mintinline` for `minted`. * `breakbefore` and `breakafter` now support the escaped comma `\,` (#15). * Fixed unintended line breaks after hyphens under LuaTeX (#14). * Added documentation on Pandoc compatibility (#11). * Replaced `breakbeforegroup` with `breakbeforeinrun`, and replaced `breakaftergroup` with `breakafterinrun`. With the introduction of `breaknonspaceingroup`, "`group`" is now reserved for referring to TeX groups `{...}`. * Removed dependency on `ifthen` package. * `breakautoindent` now works correctly with Pygments output that treats leading whitespace as a separate token or as part of a token. ## v1.4 (2019/02/04) * Reimplemented `\Verb`. It now works as expected inside other commands (with a few limitations), including in movable arguments, and is compatible with `hyperref` for things like PDF bookmarks. It now supports `breaklines` and relevant line-breaking options. * Reimplemented `\SaveVerb` and `\UseVerb` to be equivalent to the new `\Verb`. The new option `retokenize` allows saved verbatim material to be retokenized under new `commandchars` and `codes` when it is inserted with `\UseVerb`. * New command `\EscVerb` works like the reimplemented `\Verb`, except that special characters can be escaped with a backslash. It works inside other commands without any limitations, including in movable arguments, and is compatible with `hyperref` for things like PDF bookmarks. * Added `extra` option for switching between the reimplemented `\Verb`, `\SaveVerb`, `\UseVerb` and the original `fancyvrb` definitions. Reimplemented versions are used by default. This option will apply to any future reimplemented commands and environments. * New command `\fvinlineset` only applies options to commands related to typesetting verbatim inline, like `\Verb`, `\SaveVerb`, `\UseVerb`. It only works with commands that are defined or reimplemented by `fvextra`. It overrides options from `\fvset`. * Patched `fancyvrb` so that `\Verb` (either reimplemented version or original) can use characters like `%` for delimiters when used outside any commands. * `obeytabs` now works with the `calc` package's redefined `\setcounter`. Since `minted` loads `calc`, this also fixes `minted` compatibility (`minted` #221). * Added new option `fontencoding` (`minted` #208). * `highlightlines` now works correctly with `frame` (#7). ## v1.3.1 (2017/07/08) * `beameroverlays` now works with `VerbatimOut`. ## v1.3 (2017/07/08) * Added `beameroverlays` option, which enables `beamer` overlays using the `<` and `>` characters. * Added options `breakindentnchars`, `breaksymbolsepleftnchars` (alias `breaksymbolsepnchars`), `breaksymbolseprightnchars`, `breaksymbolindentleftnchars` (alias `breaksymbolindentnchars`), and `breaksymbolindentrightnchars`. These are identical to the pre-existing options without the `nchars` suffix, except that they allow indentation to be specified as an integer number of characters rather than as a dimension. As a result of these new options, `\settowidth` is no longer used in the preamble, resolving some font incompatibilities (#4). * Clarified in the docs that `breaksymbolsepright` is a *minimum*, rather than exact, distance. ## v1.2.1 (2016/09/02) * The package is now compatible with classes and packages that redefine `\raggedright`. * Fixed a bug that introduced extra space in inline contexts such as `\mintinline` when `breaklines=true` (#3). ## v1.2 (2016/07/20) * Added support for line breaking when working with Pygments for syntax highlighting. * The default `highlightcolor` is now defined with `rgb` for compatibility with the `color` package. Fixed a bug in the conditional color definition when `color` and `xcolor` are not loaded before `fvextra`. ## v1.1 (2016/07/14) * The options `rulecolor` and `fillcolor` now accept color names directly; using `\color{}` is no longer necessary, though it still works. * Added `tabcolor` and `spacecolor` options for use with `showtabs` and `showspaces`. * Added `highlightlines` option that takes a line number or range of line numbers and highlights the corresponding lines. Added `highlightcolor` option that controls highlighting color. * `obeytabs` no longer causes lines to vanish when tabs are inside macro arguments. Tabs and spaces inside a macro argument but otherwise at the beginning of a line are expanded correctly. Tabs inside a macro argument that are preceded by non-whitespace characters (not spaces or tabs) are expanded based on the starting position of the run of whitespace in which they occur. * The line breaking options `breakanywhere`, `breakbefore`, and `breakafter` now work with multi-byte UTF-8 code points under pdfTeX with `inputenc`. They were already fully functional under XeTeX and LuaTeX. * Added `curlyquotes` option, which essentially disables the `uquote` package. ## v1.0 (2016/06/28) * Initial release.