./print/tex-tcolorbox-doc, Documentation for tex-tcolorbox

[ CVSweb ] [ Homepage ] [ RSS ] [ Required by ] [ Add to tracker ]


Branch: CURRENT, Version: 6.2.0, Package name: tex-tcolorbox-doc-6.2.0, Maintainer: pkgsrc-users

Documentation for tex-tcolorbox.


Required to run:
[print/kpathsea]

Master sites: (Expand)


Version history: (Expand)


CVS history: (Expand)


   2024-02-17 02:25:14 by Mark Davies | Files touched by this commit (4) | Package updated
Log message:
tex-tcolorbox{,-doc}: update to 6.2.0

6.1.0
### Added
- New option `redirectlowerto`

### Changed
- Added braces to protect square brackets, mostly for key values
- Internal `\__tcobox_include_graphics:nn` refactored
- `blend into` now also adapts `list type` accordingly,
  e.g. `blend into=figures` now sets `list type=figure`
- `every box`, `every box on layer <n>`, and `every box on higher layers`
  may contain `capture` mode settings now

### Fixed
- With parbox=false, `\par` was ignored in a `tcolorbox` that starts a list
- `varwidth upper` ignored horizontal alignment of upper part

6.2.0
### Added
- New convenience options for box content additions
    - Option `environment upper`
    - Option `environment upper args`
    - Option `environment lower`
    - Option `environment lower args`
    - Option `environment title`
    - Option `environment title args`
- Library `hooks`:
    - Option `environment upper app`
    - Option `environment upper args app`
    - Option `environment lower app`
    - Option `environment lower args app`
    - Option `environment title app`
    - Option `environment title args app`
    - Option `environment upper pre`
    - Option `environment upper args pre`
    - Option `environment lower pre`
    - Option `environment lower args pre`
    - Option `environment title pre`
    - Option `environment title args pre`
- Library `documentation`:
    - Option `index key formatter`
    - Option `index keys formatter`
    - Root (`/`) of a documented key made configurable
        - Option `doc key prefix`

### Changed
- Minor implementation change to `redirectlowerto`
- `pgfkeys` mentioned in the documentation
- Distinct `savelowerto`/`redirectlowerto` file names inside the documentation
- Updated documentation and warnings for the interaction between `saveto`
    and `savelowerto`(issue #249)
- Improved some `\sarg` examples in the documentation
- Small typos in the documentation
- Recording macros rewritten in expl3 code
- Usage of expl3 scratch variables like `\l_tmpa_tl` replaced by package
  variables like `\l__tcobox_tmpa_tl`
- Library `documentation`:
    - Expl3 arg-spec of internal macro corrected
    - `\tcbmakedocSubKey` and `\tcbmakedocSubKeys` take options now
- Library `external`: package loading of `pdftexcmds` and `shellesc` removed.
    Expl3 functions are used as drop-in replacements
- Libraries `listings`, `listingsutf8`, and `minted`:
    package loading of `pdftexcmds` and `shellesc` removed
- Needed LaTeX version updated to 2021-11-15

### Removed
- Loading of the `xparse` library dropped inside the `documentation`
  library since all needed features are part of the LaTeX format now

### Fixed
- Several documentation typos and minor improvements
- Extra top space if `parbox=false` and tcolorbox starts with a list
   2023-04-08 13:23:02 by Mark Davies | Files touched by this commit (4) | Package updated
Log message:
tex-tcolorbox{,-doc}: update to 6.0.3

6.0.0
### Added
- Generalized text alignment options (issue #184)
    - Option `halign code`
    - Option `halign upper code`
    - Option `halign lower code`
    - Option `halign title code`
- New Options:
    - Option `before title*` (equals `before title` until 5.1.1)
    - Option `after title*`  (equals `after title` until 5.1.1)
- New option for verbatim output and listings:
    - Option `verbatim ignore indention at end`
- Option `short title` (part of issue #186)
- Support for zref / zref-titleref / zref-clever (issue #206)
    - Option `label is label`
    - Option `label is zlabel`
- Library `theorems`: New theorem generation macros. Generated theorema
    support an optional short title now (part of issue #186):
    - `\NewTcbTheorem`
    - `\RenewTcbTheorem`
    - `\ProvideTcbTheorem`
    - `\DeclareTcbTheorem`
- Library `skins`: Default values added to the options
    - `watermark zoom`
    - `watermark shrink`
    - `watermark overzoom`
    - `watermark stretch`

- The 'TikZ Image and Picture Fill Extensions' are extracted from library `skins`
    into an `tcolorbox` indendent TikZ library `tikzfill.image` and made part
    of a new package `tikzfill`. Also, the respective documentation is moved into
    this new package (issue #185)
- Library `skins`: The implementation of all watermark options is changed and
    adapted to `tikzfill`. `clip watermark=false` has now some restrictions
- Library `skins`: `\tcbincludegraphics` implementation changed to LaTeX3 code

6.0.1
- Typo in CHANGES.md
- Regression bug: `\NewTCBInputListing` without initialization
  options produces an error

6.0.3
### Added
- Usage of `\tcblower` where not applicable gives a more helpful error message
- Usage of `capture=fitbox` for `\tcbox` gives an error message
- Library documentation:
    - Macro `\sarg`

### Changed
- Documentation:
    - List of initialization option macros enlarged
    - Removed `xparse` references
    - Typo correction
- Library `skins`:
    - `\tcbhypernode` made compatible for xelatex

### Fixed
- `parbox=false` accumulated negative `\parskip` values, if called several times
    or used with `attach title to upper`
- Library `breakable`:
    - Reverting to `\color{.}` hack to avoid color bleeding after the box
    - `Discard zero height first box part` problem hopefully solved
   2022-09-01 07:22:04 by Mark Davies | Files touched by this commit (4) | Package updated
Log message:
tex-tcolorbox{,-doc}: update to 5.1.1

5.1.1
### Changed
- Some documentation improvements
- Library `xparse` removed from settings `many` and `most`
- Slight implemenation change for `\newtcbtheorem` and `\renewtcbtheorem`

### Fixed
- Regression bug introduced with v5.0.0 2021-12-16
   Instead of `beforeafter skip balanced`, `autoparskip` was set as default,
   restoring the situation before v4.40 (with some inconsistencies)

5.1.0
 ### Added
 - Options wrapping `\tl_if_blank:nTF` and `\tl_if_empty:nTF`
 - Options to insert code at begin and end of floats
 - Library `skins`: overlap of lower part for `bicolor`, `tile`, and `beamer`
     made configurable
 - Library `documentation`: package warning, if `imakeidx` is loaded after the
     library is loaded
 - Library `documentation`: gather index LaTeX macros and configure gathering

 ### Changed
- Required latex2e specified `\NeedsTeXFormat{LaTeX2e}[2020/10/01]`
- Documentation: comment `default setting` for `every box on higher layers`
- Documentation: hyperlinking keys and commands where not already done inside
    the listings section
- All contents of library `xparse` are moved to the `tcolorbox` main package and
    to libraries `listings` and `fitting` respectively. `xparse` now only loads
    the package `xparse`
- Internal implementation of all `\new*` commands, e.g. `\newtcolorbox` changed.
    Note that a missing backlash for `tcbox`-like commands
    e.g. `\newtcbox{mybox}` instead of `\newtcbox{\mybox}` is no longer tolerated.

### Fixed
- With `parbox=false`, `before skip` was ignored in inner box
   2022-04-14 05:28:49 by Mark Davies | Files touched by this commit (5) | Package updated
Log message:
tex-tcolorbox{,-doc}: update to 5.0.2

5.0.2
### Changed
- Library `minted`: Temporary patch `\tcbTemporaryPatchMintedFancyvrb`
  removed because of update for package `minted` (2021/12/24).
  This is now the required version for `tcolorbox`

### Fixed
- Using the `documentation` library with `minted` was broken
- Library `theorems`: New implementation had title expansion with
  problems

5.0.1
### Fixed
- Library `minted`: Patch `\tcbTemporaryPatchMintedFancyvrb` fixed
- Fix for issue #157 disabled unbreakability for hbox type boxes
  This also affected boxes with sidebyside content

5.0.0
### Added
- Library `skins`: Option `attach boxed title to top text left`
- Library `skins`: Option `attach boxed title to top text right`
- Library `skins`: Option `attach boxed title to bottom text left`
- Library `skins`: Option `attach boxed title to bottom text right`
- Library `theorems`: Option `theorem number`
- Library `minted`: Option `default minted options`
- Library `minted`: Temporary patch `\tcbTemporaryPatchMintedFancyvrb`
    for the current minted/fancyvrb package clash

### Changed
- Changelog is switched to Markdown for entries from 2021 on
  [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
- From now on version numbers adhere to
  [Semantic Versioning](http://semver.org/spec/v2.0.0.html)
- Library `documentation`: warn about not installed `marvosym` and `pifont`
- Environments wrapped with `\tcolorboxenvironment` are now compatible with
  all three capture modes `minipage`, `hbox`, and `fitbox`
- Meaningful error prompts when using unknown capture modes
- Library `raster`: Inside a raster, `tcbrasternum` can now be
  referenced using `label={mylabel}`, if the box is not numbered otherwise
- Library `theorem`: Theorems with empty display name are now possible
  without glitches
- Library `theorem`: Major code parts rewritten in expl3 code
- Internal layer accounting changed from LaTeX to TeX code to avoid problems
  with counter macro manipulations by amsmath alignment environments
- Library `minted`: Option `minted options` now initialized with `default
  minted options`
- Library `minted`: Code parts rewritten in expl3 code

### Removed
- Library 'theorems': `\tcbmaketheorem` removed which is deprecated since
  version 2.40 (2013/07/15).  Use `\newtcbtheorem` instead.

### Fixed
- Library `documentation`: Inconsistent local/global assignment corrected
- Documentation: Changed bibtex link corrected
- Library `breakable`: Option `use color stack` was order dependant
- Library `raster`: Numbering for rasters inside rasters
- In certain situations options were set twice
   2021-10-26 13:15:15 by Nia Alarie | Files touched by this commit (1670)
Log message:
print: Replace RMD160 checksums with BLAKE2s checksums

All checksums have been double-checked against existing RMD160 and
SHA512 hashes
   2021-10-07 16:52:04 by Nia Alarie | Files touched by this commit (1670)
Log message:
print: Remove SHA1 hashes for distfiles
   2021-06-05 08:55:25 by Mark Davies | Files touched by this commit (5) | Package updated
Log message:
tex-tcolorbox{,-doc}: update to 4.50

- bug fix: 'tcbincludepdf' ignored some raster options
- bug fix: visible seam for 'bicolor' and 'tile' in 'sidebyside' mode
    around the lower (i.e. rightward) part
- Using group around arguments for title in the examples
- Allocate write registers \tcb at out and \tcb at record@out only when needed
- Documentation: recommend to use initialization options after loading hyperref
- Documentation: warn user about white title color becoming invisible
  for the skin 'empty'
- documentation correction
- documentation of library skins is split into a general part and the catalog
  of skins
- '\tcblistof' enhanced to take an optional short title and mimic
  '\listoffigures' where applicable
- library 'skins':
  * new option 'opacitybacklower'
  * new jigsaw variant of 'bicolor':
    'bicolor jigsaw', 'bicolorfirst jigsaw', 'bicolormiddle jigsaw',
    'bicolorlast jigsaw'
  * implementation of bicolor overhauled
  * skin documentation complemented with sidebyside examples.
- library 'theorems':
  * new option 'theorem hanging indent'
- library 'vignette':
  * documentation examples for fading styles for every side added
- library 'raster':
  * '\thetcbrasternum' changed output the content of a counter.
    LaTeX counter 'tcbrasterrow', 'tcbrastercolumn', 'tcbrasternum' documented.
   2021-02-20 11:55:08 by Mark Davies | Files touched by this commit (4) | Package updated
Log message:
tex-tcolorbox{,-doc}: update to 4.42

4.42
- due to several problems with the color algorithm introduced with
  version 4.32, essentially reversion to the proven pre 4.32 method.
  * support of luacolor persists (since 4.32)
  * color stacks (by pdfcol) are not mandatory any more,
    but are optional now with 'use color stack'. Note that effects
    of whatsits on the vertical space have to be expected.

4.41
- bug fix: color bleeding for xelatex and breakable boxes (since 4.32)

4.40
- bug fix: 'IfBooleanT', 'IfBooleanF'
- bug fix: 'widget' set 'toprule at break' and needed the breakable library
- (bug) fix: style 'marker' set 'breakable' and needed the breakable library
- 'capture=hbox' applies '\@parboxrestore' now to allow e.g. hbox style
    listings inside indented environments like itemize
- support 'hbox' for 'minted' listings
- New default vertical space options
        'before skip balanced', 'after skip balanced', 'beforeafter skip
  balanced'
  NOTE: These options replace the current default options
        'parskip', 'noparskip', 'autoparskip'
  WARNING: Old documents may need adapted manual page breaks where used.
           Otherwise: Use \tcbsetforeverylayer{autoparskip}
           to restore the old behavior!
- 'before skip' and 'before skip balanced' do not insert glue now, if
  the tcolorbox is the first element in a minipage (or sourrounding tcolorbox)

4.32
- documentation typo corrections and enhancements
- bug fix: 'index format=doc' caused redefinition of '\_'
  among other errors.
- bug fix: 'valign=scale*' was erroneous.
- enhancement: color stack support for breakable boxes (pdflatex and
  lualatex) to let colors survive a break to the next partial box.
- library 'xparse':
  * new options: 'IfNoValueT', 'IfNoValueF', 'IfValueT', 'IfValueF',
      'IfBooleanT', 'IfBooleanF'

4.31
- bug fix: \tcbincludepdf did not work for lualatex
- bug fix: Several tests had a missing \relax
- bug fix: Breakable tcolorbox may overlap with following the
  text
- bug fix: 'space to' did not result in a stable value
- Internal change: all 'code 2 args' replaced by 'code n args={2}'
- documentation typo corrections
- library 'documentation':
  * indention of <environment content> changed to \ttfamily