FAQ Search Today's Posts Mark Forums Read
» Video Reviews

» Linux Archive

Linux-archive is a website aiming to archive linux email lists and to make them easily accessible for linux users/developers.


» Sponsor

» Partners

» Sponsor

Go Back   Linux Archive > ArchLinux > ArchLinux Development

 
 
LinkBack Thread Tools
 
Old 01-13-2012, 01:49 PM
Angel Velásquez
 
Default ChangeLog usage ..

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi,

For some packages that i've been maintaining over months I have to
keep a ChangeLog .. since it's supported with pacman, and give us
(devs and tus) some resume, also this resume give to our users the
idea of what is being applied in this release/version of a package.

I usually do that on critical packages, and packages that have a
previous ChangeLog file.

So, a good practice is, if you're doing the favour to other dev to
maintain or rebuild his package, and this guy added a ChangeLog .. the
correct way to proceed is to write something in it, maybe this can
sound you like zomfg this is not kiss! .. but stuff like this bring us
quality IMHO. For example, I have been busy those months, and maybe i
will continue to be busy a few months more, but trust me, in my real
spare time, i dedicate sometime to the project, and when I saw that my
packages were updated I would like to know who and what change he did
instead to diff + look at the bugtracker + look at the rebuilds + look
at the mailing list .. as i've said, sometimes the free time is like 2
hours or less per day, so i loose some much time just seing commit
logs and checking the bug tracker, having the changelog that I've been
using will help me for sure.

Again, i'm not criticizing anybody, i'm just in favour of start doing
the things better and better, and i've had several packages that were
updated by someother devs/tus (and I am grateful with them) but, they
miss the part to fill the ChangeLog which makes me wonder what they
did on the packages (for sure, i've read a lot and now i'm confident
of what they did, but this makes me waste a whole morning reading
mails, bugtracker, and reading the logs of the svn).

That said, Have a nice weekend, i will try to smash bugs and update
some of my packages in order to be up to date the next week.


- --
Angel Velásquez
angvp @ irc.freenode.net
Arch Linux Developer / Trusted User
Linux Counter: #359909
http://www.angvp.com
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQEcBAEBAgAGBQJPEESDAAoJEEKh2xXsEzutKYYIAJdCmHudJS 8ga+rGsyuYrzBR
OfN9dHZw60YAJ651V/Vo+kxFovRv2z7WY5PscyJnTJg2e8y25p27S9kk5A6rO8nW
mG3zLJDA/L5SdPbWUjmGByA5PfokMXpD6awPRrinyV4G8PEII6XUjzDQ9ow 3wImx
QluY4gEnui8FGz2oZ8KcEei5PDBpeIAn1dM6NdsxI9eMm4ceYm BcrfUrixNm3ONg
Px7OtN7mpI3y1sCjeWG8oYL7SKeGwhKYJyYI0JknjwgzY7W3/wreatv43mphvmpi
DlfqGdyVSIJ91R752b6HYKI9fE9Xy9wizggunU7pZxsUcyYg4k rV4hn5Db+hOns=
=zKc9
-----END PGP SIGNATURE-----
 
Old 01-13-2012, 02:02 PM
Lukas Fleischer
 
Default ChangeLog usage ..

On Fri, Jan 13, 2012 at 11:49:39AM -0300, Angel Velásquez wrote:
> Hi,
>
> For some packages that i've been maintaining over months I have to
> keep a ChangeLog .. since it's supported with pacman, and give us
> (devs and tus) some resume, also this resume give to our users the
> idea of what is being applied in this release/version of a package.
>
> I usually do that on critical packages, and packages that have a
> previous ChangeLog file.
>
> So, a good practice is, if you're doing the favour to other dev to
> maintain or rebuild his package, and this guy added a ChangeLog .. the
> correct way to proceed is to write something in it, maybe this can
> sound you like zomfg this is not kiss! .. but stuff like this bring us
> quality IMHO. For example, I have been busy those months, and maybe i
> will continue to be busy a few months more, but trust me, in my real
> spare time, i dedicate sometime to the project, and when I saw that my
> packages were updated I would like to know who and what change he did
> instead to diff + look at the bugtracker + look at the rebuilds + look
> at the mailing list .. as i've said, sometimes the free time is like 2
> hours or less per day, so i loose some much time just seing commit
> logs and checking the bug tracker, having the changelog that I've been
> using will help me for sure.
>
> Again, i'm not criticizing anybody, i'm just in favour of start doing
> the things better and better, and i've had several packages that were
> updated by someother devs/tus (and I am grateful with them) but, they
> miss the part to fill the ChangeLog which makes me wonder what they
> did on the packages (for sure, i've read a lot and now i'm confident
> of what they did, but this makes me waste a whole morning reading
> mails, bugtracker, and reading the logs of the svn).

I'm all for writing useful (and detailed, if necessary) commit messages
instead of writing ChangeLog entries. We use a VCS for some reason.
Using proper commit messages makes changes damn easy to follow without
having to maintain these inconvenient ChangeLog files.

>
> That said, Have a nice weekend, i will try to smash bugs and update
> some of my packages in order to be up to date the next week.

P.S.: You should probably CC mails to aur-general if they affect TUs as
well.

>
>
> --
> Angel Velásquez
> angvp @ irc.freenode.net
> Arch Linux Developer / Trusted User
> Linux Counter: #359909
> http://www.angvp.com
 
Old 01-13-2012, 03:30 PM
Stéphane Gaudreault
 
Default ChangeLog usage ..

Le 13 janvier 2012 11:49:39 Angel Velásquez a écrit :
> Hi,
>
> For some packages that i've been maintaining over months I have to
> keep a ChangeLog .. since it's supported with pacman, and give us
> (devs and tus) some resume, also this resume give to our users the
> idea of what is being applied in this release/version of a package.
>
> I usually do that on critical packages, and packages that have a
> previous ChangeLog file.
>
> So, a good practice is, if you're doing the favour to other dev to
> maintain or rebuild his package, and this guy added a ChangeLog .. the
> correct way to proceed is to write something in it, maybe this can
> sound you like zomfg this is not kiss! .. but stuff like this bring us
> quality IMHO. For example, I have been busy those months, and maybe i
> will continue to be busy a few months more, but trust me, in my real
> spare time, i dedicate sometime to the project, and when I saw that my
> packages were updated I would like to know who and what change he did
> instead to diff + look at the bugtracker + look at the rebuilds + look
> at the mailing list .. as i've said, sometimes the free time is like 2
> hours or less per day, so i loose some much time just seing commit
> logs and checking the bug tracker, having the changelog that I've been
> using will help me for sure.
>
> Again, i'm not criticizing anybody, i'm just in favour of start doing
> the things better and better, and i've had several packages that were
> updated by someother devs/tus (and I am grateful with them) but, they
> miss the part to fill the ChangeLog which makes me wonder what they
> did on the packages (for sure, i've read a lot and now i'm confident
> of what they did, but this makes me waste a whole morning reading
> mails, bugtracker, and reading the logs of the svn).
>
> That said, Have a nice weekend, i will try to smash bugs and update
> some of my packages in order to be up to date the next week.

This may just be a matter of taste, but personally I found the svn commit logs
more informative than Changelog files that are incomplete most of the time. If
you are looking for a one stop place to look what changed in your package, the
commit logs are probably the right place IMO.

Stéphane
 
Old 01-13-2012, 05:44 PM
Seblu
 
Default ChangeLog usage ..

On Fri, Jan 13, 2012 at 4:02 PM, Lukas Fleischer
<archlinux@cryptocrack.de> wrote:
> On Fri, Jan 13, 2012 at 11:49:39AM -0300, Angel Velásquez wrote:
> I'm all for writing useful (and detailed, if necessary) commit messages
> instead of writing ChangeLog entries. We use a VCS for some reason.
> Using proper commit messages makes changes damn easy to follow without
> having to maintain these inconvenient ChangeLog files.
It's more easy to read a human changelog, (shipped with packages which
don't needs to connect to archlinux.org), than developer oriented
commits.
We can make the synthesis of several commit in the changelog to make
it more understandable. And still try to make atomic commits.

In addition separates VCS message and package history, let's it
independant from vcs tools (svn/git/hg) we choose at a time.
--
Sébastien Luttringer
www.seblu.net
 
Old 01-13-2012, 09:51 PM
Lukas Fleischer
 
Default ChangeLog usage ..

On Fri, Jan 13, 2012 at 07:44:31PM +0100, Seblu wrote:
> On Fri, Jan 13, 2012 at 4:02 PM, Lukas Fleischer
> <archlinux@cryptocrack.de> wrote:
> > On Fri, Jan 13, 2012 at 11:49:39AM -0300, Angel Velásquez wrote:
> > I'm all for writing useful (and detailed, if necessary) commit messages
> > instead of writing ChangeLog entries. We use a VCS for some reason.
> > Using proper commit messages makes changes damn easy to follow without
> > having to maintain these inconvenient ChangeLog files.
> It's more easy to read a human changelog, (shipped with packages which
> don't needs to connect to archlinux.org), than developer oriented
> commits.

I don't really see any big difference here. Commit messages should be
detailed and comprehensible as well. I'm not sure what you mean by
"developer oriented" but if your commit messages cannot be understood by
any user, you're probably doing something wrong

Check [1] for an example of how a commit message should look like.

> We can make the synthesis of several commit in the changelog to make
> it more understandable. And still try to make atomic commits.

Yes, separate changelogs make sense if we do summarize changes that are
spread over a lot of commits (like the "NEWS" file in pacman). We
usually don't have such changes to our packages, though (99% of changes
are made in a single commit). Please let me know if I'm wrong...

>
> In addition separates VCS message and package history, let's it
> independant from vcs tools (svn/git/hg) we choose at a time.

Proper VCS support importing history from others (check git-svn(1) and
git-cvsimport(1) for Git). And even if it cannot not be done, we could
still convert commit history to a text file later.

> --
> Sébastien Luttringer
> www.seblu.net

[1] http://projects.archlinux.org/svntogit/community.git/commit/?id=77c0210bce1365115811f4cbb37485dc64b7f15f

Sat Jan 14 01:30:01 2012
Return-path: <devel-bounces@lists.fedoraproject.org>
Envelope-to: tom@linux-archive.org
Delivery-date: Sat, 14 Jan 2012 00:52:49 +0200
Received: from bastion01.fedoraproject.org ([209.132.181.2]:41814 heloºstion.fedoraproject.org)
by s2.java-tips.org with esmtp (Exim 4.69)
(envelope-from <devel-bounces@lists.fedoraproject.org>)
id 1RlpzN-0006eL-L9
for tom@linux-archive.org; Sat, 14 Jan 2012 00:52:49 +0200
Received: from lists.fedoraproject.org (collab03.vpn.fedoraproject.org [192.168.1.70])
by bastion01.phx2.fedoraproject.org (Postfix) with ESMTP id 6C18621368;
Fri, 13 Jan 2012 22:52:55 +0000 (UTC)
Received: from collab03.fedoraproject.org (localhost [127.0.0.1])
by lists.fedoraproject.org (Postfix) with ESMTP id E785B41F6A;
Fri, 13 Jan 2012 22:52:54 +0000 (UTC)
X-Original-To: devel@lists.fedoraproject.org
Delivered-To: devel@lists.fedoraproject.org
Received: from smtp-mm03.fedoraproject.org (vm4.fedora.ibiblio.org
[152.19.134.143])
by lists.fedoraproject.org (Postfix) with ESMTP id 3DAF941F6A
for <devel@lists.fedoraproject.org>;
Fri, 13 Jan 2012 22:52:24 +0000 (UTC)
Received: from mail-ww0-f51.google.com (mail-ww0-f51.google.com [74.125.82.51])
by smtp-mm03.fedoraproject.org (Postfix) with ESMTP id 3A1BC4036B
for <devel@lists.fedoraproject.org>;
Fri, 13 Jan 2012 22:52:23 +0000 (UTC)
Received: by wgbdq12 with SMTP id dq12so283032wgb.20
for <devel@lists.fedoraproject.org>;
Fri, 13 Jan 2012 14:52:22 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
h=message-id:date:from:user-agent:mime-version:to:subject:references
:in-reply-to:content-type;
bh=+sTaqKsZEtK6fOHce5NFijFoOpLdTPilXbYTR4pky1U=;
b=nIYLEubTeA+/dD3x/JOtzxoSx6+wIUdsCJrepUJNo1XAkIVq1T5XLYcEl7IRtnsBXz
IG7kanZqccmzzpEsmNOSQNEJfuKXyI3WIZb/NWXVJmX4cxWspcka5hhpNlWAUhxgMwRw
uBx8v6jdByPIfAXuT8+E8q5QixnDZ55v/QyuQReceived: by 10.180.100.234 with SMTP id fb10mr15229wib.5.1326495142585;
Fri, 13 Jan 2012 14:52:22 -0800 (PST)
Received: from localhost.localdomain (85-220-55-128.dsl.dynamic.simnet.is.
[85.220.55.128])
by mx.google.com with ESMTPS id 8sm299508wbz.6.2012.01.13.14.52.21
(version=SSLv3 cipher=OTHER); Fri, 13 Jan 2012 14:52:22 -0800 (PST)
Message-ID: <4F10B572.2030900@gmail.com>
Date: Fri, 13 Jan 2012 22:51:30 +0000
From: =?UTF-8?B?IkrDs2hhbm4gQi4gR3XDsG11bmRzc29uIg==? <johannbg@gmail.com>
User-Agent: Mozilla/5.0 (X11; Linux x86_64;
rv:9.0) Gecko/20111222 Thunderbird/9.0
MIME-Version: 1.0
To: Development discussions related to Fedora <devel@lists.fedoraproject.org>
Subject: Re: Removing SysV Init Scripts
References: <FB37B844-EDED-472E-AB61-895D77B68330@5dollarwhitebox.org>
<CAN3TeO1Mu+jsyVeftcAiKjnc6RwjDsZ_zc9Kuy3S27q7fR7r Qw@mail.gmail.com>
In-Reply-To: <CAN3TeO1Mu+jsyVeftcAiKjnc6RwjDsZ_zc9Kuy3S27q7fR7r Qw@mail.gmail.com>
X-BeenThere: devel@lists.fedoraproject.org
X-Mailman-Version: 2.1.12
Precedence: list
Reply-To: Development discussions related to Fedora
<devel@lists.fedoraproject.org>
List-Id: Development discussions related to Fedora
<devel.lists.fedoraproject.org>
List-Unsubscribe: <https://admin.fedoraproject.org/mailman/options/devel>,
<mailto:devel-request@lists.fedoraproject.org?subject=unsubscrib e>
List-Archive: <http://lists.fedoraproject.org/pipermail/devel/>
List-Post: <mailto:devel@lists.fedoraproject.org>
List-Help: <mailto:devel-request@lists.fedoraproject.org?subject=help>
List-Subscribe: <https://admin.fedoraproject.org/mailman/listinfo/devel>,
<mailto:devel-request@lists.fedoraproject.org?subject=subscribe>
Content-Type: multipart/mixed; boundary="==============)39434556449169287=="
Sender: devel-bounces@lists.fedoraproject.org
Errors-To: devel-bounces@lists.fedoraproject.org

This is a multi-part message in MIME format.
--==============)39434556449169287=Content-Type: multipart/alternative;
boundary="------------030205090408030503090904"

This is a multi-part message in MIME format.
--------------030205090408030503090904
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit

On 01/13/2012 10:39 PM, Richard Shaw wrote:
> I'm sure someone will correct me if I mis-speak, but I don't think
> your bug is currently valid. There's currently no requirement that you
> convert to systemd, although I would highly recommend it. There was
> some talk about forcing conversion at some point.

I'm not so sure how you figure out that this bug is not valid and how
you come to the conclusion that it's not a requirement to switch to
native systemd units and still shipping legacy sysv init script is
already considered obsolete [1]


"Older versions of Fedora supported SystemV-style initscripts, but they
are now considered obsolete for Fedora 15+."

And since this is the attitude we should be forcing that migration this
release cycle maintainers have already had two full release cycles to
migrate...

JBG

1.http://fedoraproject.org/wiki/Packaging:Guidelines#Systemd


--------------030205090408030503090904
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: 7bit

<html>
<head>
<meta content="text/html; charset=UTF-8" http-equiv="Content-Type">
</head>
<body bgcolor="#FFFFFF" text="#000000">
On 01/13/2012 10:39 PM, Richard Shaw wrote:
<blockquote
cite="mid:CAN3TeO1Mu+jsyVeftcAiKjnc6RwjDsZ_zc9Kuy3 S27q7fR7rQw@mail.gmail.com"
type="cite">
<pre wrap="">I'm sure someone will correct me if I mis-speak, but I don't think
your bug is currently valid. There's currently no requirement that you
convert to systemd, although I would highly recommend it. There was
some talk about forcing conversion at some point.</pre>
</blockquote>
<br>
I'm not so sure how you figure out that this bug is not valid and
how you come to the conclusion that it's not a requirement to switch
to native systemd units and still shipping legacy sysv init script
is already considered obsolete [1]<br>
<h3><span class="mw-headline" id="Initscripts"></span></h3>
<p>"Older versions of Fedora supported SystemV-style initscripts,
but they are now considered obsolete for Fedora 15+."<br>
</p>
<p>And since this is the attitude we should be forcing that
migration this release cycle maintainers have already had two full
release cycles to migrate...<br>
</p>
<p>JBG<br>
</p>
<p>1.http://fedoraproject.org/wiki/Packaging:Guidelines#Systemd<br>
</p>
</body>
</html>

--------------030205090408030503090904--

--==============)39434556449169287=Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: base64
Content-Disposition: inline

LS0gCmRldmVsIG1haWxpbmcgbGlzdApkZXZlbEBsaXN0cy5mZW RvcmFwcm9qZWN0Lm9yZwpodHRw
czovL2FkbWluLmZlZG9yYXByb2plY3Qub3JnL21haWxtYW4vbG lzdGluZm8vZGV2ZWw
--==============)39434556449169287==--
 
Old 01-13-2012, 10:18 PM
Allan McRae
 
Default ChangeLog usage ..

On 14/01/12 08:51, Lukas Fleischer wrote:
> On Fri, Jan 13, 2012 at 07:44:31PM +0100, Seblu wrote:
>> On Fri, Jan 13, 2012 at 4:02 PM, Lukas Fleischer
>> <archlinux@cryptocrack.de> wrote:
>>> On Fri, Jan 13, 2012 at 11:49:39AM -0300, Angel Velásquez wrote:
>>> I'm all for writing useful (and detailed, if necessary) commit messages
>>> instead of writing ChangeLog entries. We use a VCS for some reason.
>>> Using proper commit messages makes changes damn easy to follow without
>>> having to maintain these inconvenient ChangeLog files.
>> It's more easy to read a human changelog, (shipped with packages which
>> don't needs to connect to archlinux.org), than developer oriented
>> commits.
>
> I don't really see any big difference here. Commit messages should be
> detailed and comprehensible as well. I'm not sure what you mean by
> "developer oriented" but if your commit messages cannot be understood by
> any user, you're probably doing something wrong
>
> Check [1] for an example of how a commit message should look like.

While I agree that a good commit message should be used, that is a side
point to the original email.

What was being asked was that if someone chooses to maintain a ChangeLog
for their package, then you should also update the ChangeLog file if you
make an update to that package.

Allan
 
Old 01-13-2012, 10:28 PM
Lukas Fleischer
 
Default ChangeLog usage ..

On Sat, Jan 14, 2012 at 09:18:06AM +1000, Allan McRae wrote:
> On 14/01/12 08:51, Lukas Fleischer wrote:
> > On Fri, Jan 13, 2012 at 07:44:31PM +0100, Seblu wrote:
> >> On Fri, Jan 13, 2012 at 4:02 PM, Lukas Fleischer
> >> <archlinux@cryptocrack.de> wrote:
> >>> On Fri, Jan 13, 2012 at 11:49:39AM -0300, Angel Velásquez wrote:
> >>> I'm all for writing useful (and detailed, if necessary) commit messages
> >>> instead of writing ChangeLog entries. We use a VCS for some reason.
> >>> Using proper commit messages makes changes damn easy to follow without
> >>> having to maintain these inconvenient ChangeLog files.
> >> It's more easy to read a human changelog, (shipped with packages which
> >> don't needs to connect to archlinux.org), than developer oriented
> >> commits.
> >
> > I don't really see any big difference here. Commit messages should be
> > detailed and comprehensible as well. I'm not sure what you mean by
> > "developer oriented" but if your commit messages cannot be understood by
> > any user, you're probably doing something wrong
> >
> > Check [1] for an example of how a commit message should look like.
>
> While I agree that a good commit message should be used, that is a side
> point to the original email.
>
> What was being asked was that if someone chooses to maintain a ChangeLog
> for their package, then you should also update the ChangeLog file if you
> make an update to that package.

Agreed, and I'm also for keeping the maintainer's PKGBUILD formatting if
you update a package (unless it breaks something, of course).

Sorry for being slightly off-topic and turning this into a "ChangeLog
vs. commit log" discussion.

>
> Allan
 

Thread Tools




All times are GMT. The time now is 04:18 AM.

VBulletin, Copyright ©2000 - 2014, Jelsoft Enterprises Ltd.
Content Relevant URLs by vBSEO ©2007, Crawlability, Inc.
Copyright ©2007 - 2008, www.linux-archive.org