release notes file
Cy Schubert
Cy.Schubert at cschubert.com
Mon Jun 24 13:47:48 UTC 2019
On June 23, 2019 2:20:13 PM PDT, Oliver Pinter <oliver.pinter at hardenedbsd.org> wrote:
>On Sunday, June 23, 2019, Mark Johnston <markj at freebsd.org> wrote:
>
>> Hi,
>>
>> Today we add a Relnotes tag to commits that warrant a release note.
>> My impression is that it doesn't work so well: if a committer forgets
>> or doesn't know to add one there's no way to amend the commit message
>> (same for MFCs), and a commit message isn't a convenient place to
>write
>> the text of a release note. I would like to propose adding a
>top-level
>> RELNOTES file instead, which like UPDATING would document notes for
>> specific commits. It would be truncated every time the head branch
>is
>> forked, and changes to it would be MFCed. This fixes the
>> above-mentioned problems and would hopefully reduce the amount of
>time
>> needed by re@ to compile release notes.
>
>
>
>In the future with git you could easily add meta infos for specific
>commits. The project currently using this to store git-svn meta, but
>you
>can add more the one note to each commit.
>W
>
>
>
>
>>
>> For example:
>>
>> Index: RELNOTES
>> ===================================================================
>> --- RELNOTES (nonexistent)
>> +++ RELNOTES (working copy)
>> @@ -0,0 +1,8 @@
>> +Release notes for FreeBSD 13.0.
>> +
>> +r349286:
>> + swapon(8) can now erase a swap device immediately before
>> + enabling it, similar to newfs(8)'s -E option. This behaviour
>> + can be specified by adding -E to swapon(8)'s command-line
>> + parameters, or by adding the "trimonce" option to a swap
>> + device's /etc/fstab entry.
>>
>> What do folks think?
>> _______________________________________________
>> freebsd-hackers at freebsd.org mailing list
>> https://lists.freebsd.org/mailman/listinfo/freebsd-hackers
>> To unsubscribe, send any mail to
>"freebsd-hackers-unsubscribe at freebsd.org"
>>
>_______________________________________________
>freebsd-hackers at freebsd.org mailing list
>https://lists.freebsd.org/mailman/listinfo/freebsd-hackers
>To unsubscribe, send any mail to
>"freebsd-hackers-unsubscribe at freebsd.org"
It should be a .md file to format it properly on github. The more I think of it, a Makefile target to install it to / instead of /etc is more intuitive.
--
Pardon the typos and autocorrect, small keyboard in use.
Cheers,
Cy Schubert <Cy.Schubert at cschubert.com>
FreeBSD UNIX: <cy at FreeBSD.org> Web: http://www.FreeBSD.org
The need of the many outweighs the greed of the few.
More information about the freebsd-hackers
mailing list