summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/changelog/README.md
blob: f74d28c16f249198f1db4c5378fb38fd70faf10e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
# The `changelog` LaTeX package

Changelogs are important. Unfortunately, there are few facilities
for typesetting changelogs in LaTeX. `changelog` defines a `changelog`
environment to make changelogs simple and intuitive.

Inspired by [keepachangelog.com].

File                         | Description
-----------------------------|-------------------------------
changelog.sty                | The changelog package
changelog.pdf                | Documentation (English)
changelog.tex                | Documentation source
changelog-doc.sty            | Documentation styles
README.md                    | This file
LICENSE.md                   | GNU GPLv3

## Example

    \documentclass{article}
    \usepackage[color]{changelog}
    \begin{document}

    \begin{changelog}[author=Rebecca Turner]
    \begin{version}
      \added Really cool features
    \end{version}

    \begin{version}[date=2019-01-23]
      \item A version with only a date
    \end{version}

    \begin{version}[v=1.1.0]
      \item A version with no date
    \end{version}

    \begin{version}[v=1.0.1, yanked]
      \item A version with a terrible bug
    \end{version}

    \begin{version}[v=1.0.0, date=2018-10-26]
      \added a cool feature
      \changed some \textsc{api} detail
      \deprecated something that was a bad idea in the first place
      \removed something that was deprecated 3 versions ago
      \fixed a bug that would delete files instead of saving them
      \security improved with addition of buffer bound checks
      \item A change that doesn't fit into any other category
    \end{version}
    \shortversion{v=0.1.0, date=2018-10-19,
      changes=Initial beta.}
    \end{changelog}

    \end{document}

Which renders roughly as:

![Rendered changelog](screenshot.png)

[keepachangelog.com]: https://keepachangelog.com/