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