Changelog

Uses your system voice; voice and rate in settings.

Snapshot

≈ 4 min read

Names in other languages

No names in other languages are held for this entry yet.

Article bodies are English and are not machine-translated. A name in another language is not a translation of the article.

A changelog is a list of changes made to software that has been revised over time such as a codebase or a product. A changelog can be a curated record. The author of the changelog can present the information to make it easy to understand and consume.

For a software project and a software release, a changelog often is organized as bug fixes and new features. A changelog can also be a generated report that includes all changes without regard to the ease of consuming or understanding.

Typically, a version control system such as git can generate a list of code changes, but some view this as unhelpful and prefer a curated list of notable changes. Another example of generated changelog is that of the typical wiki that lists changes made to each article. In particular, Wikipedia provides this feature via the "View history" link on each article page.

The name of a changelog file varies. Commonly-used names include "CHANGELOG", "CHANGES" and "HISTORY". The GNU Automake naming convention is "ChangeLog".

Sometimes that file name includes a file name extension to indicate file format, such as ".txt" for text, ".md" for Markdown, or ".rst" for reStructuredText. Often a codebase, especially an open-source software project, includes a changelog file in the top level of a distribution directory tree. Sometimes, information limited to recent changes is included in a product release.…

A changelog is a list of changes made to software that has been revised over time such as a codebase or a product. A changelog can be a curated record. The author of the changelog can present the information to make it easy to understand and consume.

For a software project and a software release, a changelog often is organized as bug fixes and new features. A changelog can also be a generated report that includes all changes without regard to the ease of consuming or understanding.

Typically, a version control system such as git can generate a list of code changes, but some view this as unhelpful and prefer a curated list of notable changes. Another example of generated changelog is that of the typical wiki that lists changes made to each article. In particular, Wikipedia provides this feature via the "View history" link on each article page.

The name of a changelog file varies. Commonly-used names include "CHANGELOG", "CHANGES" and "HISTORY". The GNU Automake naming convention is "ChangeLog".

Sometimes that file name includes a file name extension to indicate file format, such as ".txt" for text, ".md" for Markdown, or ".rst" for reStructuredText. Often a codebase, especially an open-source software project, includes a changelog file in the top level of a distribution directory tree. Sometimes, information limited to recent changes is included in a product release.

This might be exposed as a feature or a file named something like "news", "recent changes" or "release notes".

Format

In general, the format of a changelog varies dramatically, but the GNU coding standards specify that a changelog is organized as blocks that each identify when a change was made and by whom (name and email address) and describes each change within a function or file. Between the date and the name, and between the name and the email address, there are two spaces.

It is common to enclose the email address in . The Emacs editor creates such entries when creating additional changelog entries. For example:

GNU Coding Standards: Change Logs Keep a CHANGELOG

Text derived from https://en.wikipedia.org/w/index.php?oldid=1369314718 under CC BY-SA 4.0; modifications have been made.

Sources cited in this revision

4 named source(s) extracted from the cited revision. A source with no author is shown by its publication; nothing is invented.