git-changelog - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

git-changelog - Створення звіту про журнал змін

СИНТАКСИС

git-changelog [параметри] [ ]
git-changelog {-h | --допомога | ?}

ОПИС

Створює журнал змін із мерзотник(1) теги (анотовані або спрощені) і повідомлення фіксації.
Існуючі файли журналу змін із іменами файлів, які починаються з Редагувати or Історія буде
ідентифікується автоматично за допомогою шаблону відповідності без урахування регістру, а наявний вміст буде
бути додано до нового згенерованого виводу - таку поведінку можна вимкнути, вказавши
параметр обрізати (-p|--prune-old). Створений файл буде відкрито в $ РЕДАКТОР коли встановлено.

Якщо тегів не існує, виводяться всі коміти; якщо теги існують, то лише найновіші
коміти виводяться до останнього ідентифікованого тегу. Цю поведінку можна змінити за допомогою
вказуючи один або обидва варіанти діапазону (-f|--final-tag і -s|--start-tag).

ВАРІАНТИ

Ім'я вихідного файлу. За замовчуванням новий файл буде History.md якщо не існує
журнал змін виявлено, і в цьому випадку існуючий файл буде оновлено.

-а, --усі

Отримати всі коміти. Ігнорує параметри -s|--start-tag і -f|--final-tag (якщо встановлено).

-l, --список

Показати коміти у форматі списку (без заголовків, дат).

-t, --тег

Укажіть мітку тегу для останніх (без тегів) комітів.

-f, --фінальний тег

У разі вказівки діапазону найновіший тег, на якому завершиться отримання фіксації. Здійснює
буде повернено від самого першого коміту до останнього тегу, якщо також не буде початкового тегу
вказано.

-s, --start-tag

Коли вказується діапазон, найстаріший тег для отримання фіксується. Коміти будуть повернені
від початкового тегу до зараз, якщо також не вказано кінцевий тег.

-n, --no-merges

Відфільтровує коміти злиття (коміти з більш ніж 1 батьківським) зі згенерованого журналу змін.

-m, --merges-only

Використовує лише коміти злиття (коміти з більш ніж 1 батьківським) для згенерованого журналу змін. Він також
змінює формат за замовчуванням, щоб включити тіло повідомлення коміту злиття, як на github
рядок теми commits містить лише назву гілки, але не містить інформації про вміст
злиття.

-p, --prune-star

Повністю замінити існуючий журнал змін новим згенерованим вмістом, таким чином вимкнувши
типова поведінка додавання вмісту будь-якого виявленого журналу змін до кінця newly
створений контент.

-x, --stdout

Записувати вихідні дані в stdout замість нового файлу журналу змін.

-h, --help, ?

Показати довідкове повідомлення з основною інформацією про використання.

ПРИКЛАДИ

Оновлення наявного файлу або створення нового History.md файл із досить відформатованим виводом:

$ git журнал змін

Лістинг комітів із поточної версії:

$ git журнал змін --список

Перелік діапазону комітів від 2.1.0 до тепер:

$ git changelog --list --start-tag 2.1.0

Перелік досить відформатованої версії того самого:

$ git changelog --start-tag 2.1.0

Перелік діапазону комітів від початкового коміту до 2.1.0:

$ git changelog --list --final-tag 2.1.0

Перелік досить відформатованого діапазону комітів між 0.5.0 і 1.0.0:

$ git журнал змін --start-tag 0.5.0 --final-tag 1.0.0

Визначення файлу для виведення:

$ git журнал змін ChangeLog.md

І якщо існуючий журнал змін існує, повністю замініть його вміст:

$ git журнал змін --prune-old

Використовуйте git-changelog онлайн за допомогою сервісів onworks.net