primary location of btrfs-progs changelog: The wiki?

primary location of btrfs-progs changelog: The wiki?

[Nicholas D Steeves]

Hi,

I'm just wondering where the primary location of the btrfs-progs
changelog is located, because I'd like to include upstream changes in
the Debian package.  Is it really the wiki?  If so, it would seem my
options are copying+pasting with every release, or writing a script to
download the page, convert it to text, and then do something like cut
everything before By version (btrfs-progs) and everything after By
version (linux kernel).

Sincerely,
Nicholas

Re: primary location of btrfs-progs changelog: The wiki?

[Duncan]

Nicholas D Steeves posted on Fri, 22 Apr 2016 20:41:36 -0400 as excerpted:

> I'm just wondering where the primary location of the btrfs-progs
> changelog is located, because I'd like to include upstream changes in
> the Debian package.  Is it really the wiki?  If so, it would seem my
> options are copying+pasting with every release, or writing a script to
> download the page, convert it to text, and then do something like cut
> everything before By version (btrfs-progs) and everything after By
> version (linux kernel).

As with most modern projects, particularly those that are kernel related, 
I believe the _primary_ and authoritative changelog is git log. =:^)  
Particularly with the kernel, Linus's merge-commits for the various 
subsystems (btrfs in this case) tend to give a rather good if somewhat 
technical overview of what's going on with the whole merge, so you don't 
need to drill down to individual commits unless it's something you're 
/that/ interested in.

Beyond git log and other than the wiki, for userspace see the "Btrfs progs 
release" (that should be a reasonable subject search on any of the list 
archives, or use pre-release if you want them) messages authored by David 
Sterba here on this list.  They normally contain a reasonable "user-
level" summary, similar to what eventually gets put on the wiki (indeed, 
I'd guess the wiki copies from the release announcements).

For example:

http://permalink.gmane.org/gmane.comp.file-systems.btrfs/54781

For the kernel, search on "[GIT PULL] Btrfs" messages from Chris Mason.  
For example:

http://permalink.gmane.org/gmane.linux.kernel/219422

As with many subsystems Linus often uses these pretty directly in his 
merge commit comments, so it's pretty close to the same thing you'd get 
by reading the git log merge commits.

But beyond that, I think it's the wiki, which I believe can also have 
slightly more mainstreamed/sysadmin-level-change descriptions, 
particularly for the kernel, as I believe they're edited a bit 
differently than the git pull notices, where Linus and git log readers 
are the primary audience.

-- 
Duncan - List replies preferred.   No HTML msgs.
"Every nonfree program has a lord, a master --
and if you use the program, he is your master."  Richard Stallman

Re: primary location of btrfs-progs changelog: The wiki?

[David Sterba]

On Fri, Apr 22, 2016 at 08:41:36PM -0400, Nicholas D Steeves wrote:
> I'm just wondering where the primary location of the btrfs-progs
> changelog is located, because I'd like to include upstream changes in
> the Debian package.  Is it really the wiki?  If so, it would seem my
> options are copying+pasting with every release, or writing a script to
> download the page, convert it to text, and then do something like cut
> everything before By version (btrfs-progs) and everything after By
> version (linux kernel).

At the moment it's the release announcement in this mailinglist, that
gets copied to the wiki with some formatting adjustments. I'm willing to
copy the announcement text to a file in git (and will do for the next
release). But at the moment I won't add all the past changelogs so if
anybody wants to do that I'l appreciate that.

Re: primary location of btrfs-progs changelog: The wiki?

[Nicholas D Steeves]

On 25 April 2016 at 07:12, David Sterba <dsterba@suse.cz> wrote:
> On Fri, Apr 22, 2016 at 08:41:36PM -0400, Nicholas D Steeves wrote:
>> I'm just wondering where the primary location of the btrfs-progs
>> changelog is located
>
> At the moment it's the release announcement in this mailinglist, that
> gets copied to the wiki with some formatting adjustments. I'm willing to
> copy the announcement text to a file in git (and will do for the next
> release). But at the moment I won't add all the past changelogs so if
> anybody wants to do that I'l appreciate that.

I'd be happy to.  Are you looking for something like:

curl https://btrfs.wiki.kernel.org/index.php/Changelog | html2text |
sed '0,/(announcement)/d;/By version (linux kernel)/Q' | gzip -9 >
changelog

With some formatting adjustments?

Cheers,
Nicholas

Re: primary location of btrfs-progs changelog: The wiki?

[Nicholas D Steeves]

oops, that gzip -9 shouldn't be there :-/

Re: primary location of btrfs-progs changelog: The wiki?

[David Sterba]

On Mon, Apr 25, 2016 at 07:24:27AM -0400, Nicholas D Steeves wrote:
> On 25 April 2016 at 07:12, David Sterba <dsterba@suse.cz> wrote:
> > On Fri, Apr 22, 2016 at 08:41:36PM -0400, Nicholas D Steeves wrote:
> >> I'm just wondering where the primary location of the btrfs-progs
> >> changelog is located
> >
> > At the moment it's the release announcement in this mailinglist, that
> > gets copied to the wiki with some formatting adjustments. I'm willing to
> > copy the announcement text to a file in git (and will do for the next
> > release). But at the moment I won't add all the past changelogs so if
> > anybody wants to do that I'l appreciate that.
> 
> I'd be happy to.  Are you looking for something like:
> 
> curl https://btrfs.wiki.kernel.org/index.php/Changelog | html2text |
> sed '0,/(announcement)/d;/By version (linux kernel)/Q' | gzip -9 >
> changelog
> 
> With some formatting adjustments?

The conversion looks relatively ok, indentation could be 2 spaces and
all bullet lists with '*'. Thanks.

Re: primary location of btrfs-progs changelog: The wiki?

[Nicholas D Steeves]

[-- Attachment #1: Type: text/plain, Size: 367 bytes --]

On 25 April 2016 at 07:36, David Sterba <dsterba@suse.cz> wrote:
> The conversion looks relatively ok, indentation could be 2 spaces and
> all bullet lists with '*'. Thanks.

Done.  I also added one line before each new version.  I've attached
it, since it's just one file; however, if you prefer I can clone your
repo on github and submit it that way.

Cheers,
Nick

[-- Attachment #2: changelog.gz --]
[-- Type: application/x-gzip, Size: 6455 bytes --]

Re: primary location of btrfs-progs changelog: The wiki?

[David Sterba]

On Mon, Apr 25, 2016 at 08:06:47AM -0400, Nicholas D Steeves wrote:
> On 25 April 2016 at 07:36, David Sterba <dsterba@suse.cz> wrote:
> > The conversion looks relatively ok, indentation could be 2 spaces and
> > all bullet lists with '*'. Thanks.
> 
> Done.  I also added one line before each new version.  I've attached
> it, since it's just one file; however, if you prefer I can clone your
> repo on github and submit it that way.

Thanks. I had a look how a changes file is usually formatted and made
further changes: fixed ordering of the minor releases, added exact dates
of release and un-indented in a few more places, plus some minor fixes.