RONLOG: Migration from existing RST-based CHANGELOG

[kevinmatthes]

I would like to turn my old CHANGELOG.rst into a RONLOG. Is there any option to simplify this or do I have to enter all changes manually?

[kevinmatthes]

Aeruginous provides utilities for exactly that case. For each release documented in your old CHANGELOG.rst, copy the list of changes into a separate file in a temporary directory in order process it with Aeruginous. For example, if your CHANGELOG.rst would contain this section:

1.2.3 — 1970-01-01
------------------

Added
.....

- change 1

- change 2

Changed
.......

- change 3

... you would need to copy the following to a file named new-dir/fragment.rst.

Added
.....

- change 1

- change 2

Changed
.......

- change 3

Now, you can call Aeruginous to add this information to your already existing RONLOG.

aeruginous ronlog release -i new-dir -v 1.2.3 -T 19700101T012345+0000

The value passed to -T is the timestamp of the release. You can find it in your Git history or by hovering the release date in GitHub's tag inspection tab, for example. The latter also gives you the mandatory timezone you need to pass to Aeruginous to have it entering the new section appropriately.