Google Groups no longer supports new Usenet posts or subscriptions. Historical content remains viewable.
Dismiss

What the proper way to update debian/changelog

2 views
Skip to first unread message

T o n g

unread,
May 23, 2013, 12:20:01 AM5/23/13
to
Hi,

What the proper way to update debian/changelog, to increase the least
significant version # and add my change comment, and my id??

should I use the dch before "dpkg-source -x *.dsc" or after, to
streamline version # updating?

If after, how about the directory already created by dpkg-source?

Thanks



--
To UNSUBSCRIBE, email to debian-ment...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listm...@lists.debian.org
Archive: http://lists.debian.org/knk50o$9t0$1...@ger.gmane.org

Prach Pongpanich

unread,
May 23, 2013, 12:30:02 AM5/23/13
to
On Thu, May 23, 2013 at 11:13 AM, T o n g <mlist4...@yahoo.com> wrote:
> Hi,
>
> What the proper way to update debian/changelog, to increase the least
> significant version # and add my change comment, and my id??
>
> should I use the dch before "dpkg-source -x *.dsc" or after, to
> streamline version # updating?
>
> If after, how about the directory already created by dpkg-source?

$ dpkg-source -x foo-oldversion.dsc
$ cd foo-oldversion
$ dch

See also http://www.debian.org/doc/manuals/maint-guide/update.en.html

Cheers,

Prach


--
To UNSUBSCRIBE, email to debian-ment...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listm...@lists.debian.org
Archive: http://lists.debian.org/CAF=n8MLvPVcfBOpQ7aCw71uiMn...@mail.gmail.com

T o n g

unread,
May 23, 2013, 12:40:02 AM5/23/13
to
On Thu, 23 May 2013 04:13:12 +0000, T o n g wrote:

> What the proper way to update debian/changelog, to increase the least
> significant version # and add my change comment, and my id?

Please bear in mind that you'd be explaining to someone who has never
maintained a debian package before, and is only "testing-the-water"
through reading.

Thanks


--
To UNSUBSCRIBE, email to debian-ment...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listm...@lists.debian.org
Archive: http://lists.debian.org/knk634$38o$1...@ger.gmane.org

Eriberto

unread,
May 23, 2013, 9:00:02 AM5/23/13
to
Hi Tong,

You can try make a test, put your package in mentors.debian.net and
send us the link, asking for a revision. I and others can help you to
understand the process.

You should do what Prach Pongpanich said. And you can see what other
people done in their packages. A tip:

$ find /usr/share/doc/ -name 'changelog.Debian.gz' -exec zcat {} \; >
~/changelog.Debian

Have a nice day!!!

Regards,

Eriberto - Brazil


2013/5/23 T o n g <mlist4...@yahoo.com>:
> Please bear in mind that you'd be explaining to someone who has never
> maintained a debian package before, and is only "testing-the-water"
> through reading.


--
To UNSUBSCRIBE, email to debian-ment...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listm...@lists.debian.org
Archive: http://lists.debian.org/CAP+dXJd2HAnMU_cXY6AaC9VfW1J2+6ayOwmmv-Gq+=m_+d...@mail.gmail.com

T o n g

unread,
May 23, 2013, 9:40:01 PM5/23/13
to
On Thu, 23 May 2013 09:55:06 -0300, Eriberto wrote:

> You should do what Prach Pongpanich said. And you can see what other
> people done in their packages. A tip: . . .

Thanks Prach & Eriberto for your answers.

I posted my OP, then I thought, since this is the first time I'm posting
here, better make it clear, so I posted the second message, didn't
realized that Prach has already answered.

I was totally unprepared for a turn around answer that fast. Sorry Prach,
it looked like I was ignoring you, but actually I didn't know.

Thanks again for your helps.




--
To UNSUBSCRIBE, email to debian-ment...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listm...@lists.debian.org
Archive: http://lists.debian.org/knmg9k$m39$1...@ger.gmane.org

T o n g

unread,
May 23, 2013, 10:20:01 PM5/23/13
to
On Thu, 23 May 2013 09:55:06 -0300, Eriberto wrote:

> You can try make a test, put your package in mentors.debian.net and send
> us the link, asking for a revision. I and others can help you to
> understand the process.

I really appreciate the mentoring, and understand that each case would be
difference. And the best approach to handle the situation is to deal it
in case-by-case bases.

However, I'm a system learner. I.e., I learn through build up my overall
knowledge first, before rolling up my sleeves and dive in. While trying
to learn to maintain debian packages, I realized that there are A LOT to
learn, which is hard. And I found what makes it even harder is that I
have to learn such practical things bits by bits here and there. I.e., if
such practical issues has been written out clearly, my life would be much
easier.

Not complaining, Debian has lot of good documents. Just that they are not
to my taste. :-) They are written in the reference book style, whereas I
more prefer a cook book style. :-) Still not complaining -- We've got to
appreciate what we already have so far.



--
To UNSUBSCRIBE, email to debian-ment...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listm...@lists.debian.org
Archive: http://lists.debian.org/knmief$m39$2...@ger.gmane.org

T o n g

unread,
May 24, 2013, 12:10:02 AM5/24/13
to
On Fri, 24 May 2013 02:14:39 +0000, T o n g wrote:

> I'm a system learner. I.e., I learn through build up my overall
> knowledge first, before rolling up my sleeves and dive in. While trying
> to learn to maintain debian packages, I realized that there are A LOT to
> learn, which is hard. And I found what makes it even harder is that I
> have to learn such practical things bits by bits here and there. I.e.,
> if such practical issues has been written out clearly, my life would be
> much easier.

I had always been trying to maintain some useful debian packages that are
orphaned. More than 10 years ago, when glimpse was removed from the repo
[1], I told myself it was time to learn to maintain debian packages, so
that I could maintain glimpse (IMHO, glimpse is so far still the best
*personal* searching tool, and I still think it is more a 'political'
decision for it to be removed).

[1] http://lists.debian.org/debian-user/2001/09/msg00312.html

But I have to admit that maintaining debian/ubuntu packages is convoluted
to me, even though I've tried to pick it up many times. I was always
defeated merely by reading through the overwhelmingly vast information,
and made only half way through. So it never happened.

More than 10 years later, now I'm hoping to do it with a different
approach. In stead of starting background reading from the start over and
over again and never able to make it to the end, I'm going to start with
the easiest step that I can think of -- try to build and upload a
orphaned/removed package as the first step.

So I found the glimpse dsc file at
ftp://ftp.cstone.net/debian/pool/non-free/g/glimpse/glimpse_4.18.5-1.dsc

Can anyone explain me in simple commands how I can build and test upload
this glimpse package please? Of course, starting from to get it, and then
properly update the debian/changelog, all the way to test upload, in as
few steps as possible.

Maybe "increase the least significant version # and add my change
comment, and my id" can be handled by a single properly parameterized dch
command, or maybe not. But proper commands always speaks for themselves.

Thanks



--
To UNSUBSCRIBE, email to debian-ment...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listm...@lists.debian.org
Archive: http://lists.debian.org/knmojm$cem$1...@ger.gmane.org

Russ Allbery

unread,
May 24, 2013, 12:20:01 AM5/24/13
to
T o n g <mlist4...@yahoo.com> writes:

> So I found the glimpse dsc file at
> ftp://ftp.cstone.net/debian/pool/non-free/g/glimpse/glimpse_4.18.5-1.dsc

> Can anyone explain me in simple commands how I can build and test upload
> this glimpse package please? Of course, starting from to get it, and then
> properly update the debian/changelog, all the way to test upload, in as
> few steps as possible.

> Maybe "increase the least significant version # and add my change
> comment, and my id" can be handled by a single properly parameterized
> dch command, or maybe not. But proper commands always speaks for
> themselves.

% export DEBEMAIL=mlist4...@yahoo.com
% export DEBFULLNAME="T o n g" # or whatever you want to use
% dget ftp://ftp.cstone.net/debian/pool/non-free/g/glimpse/glimpse_4.18.5-1.dsc
% cd glimpse-4.18.5
# make required changes to the package
# change Maintainer in debian/control to match DEB* settings above
% dch -i
# add descriptions of your changes using your editor, opened by dch
# save and exit
% debuild
# if build is successful, *.deb packages will be left up one level
# install packages, test, iterate as needed
% cd ..
% debsign *.changes
# the previous step requires you have a GnuPG key set up

They're now ready to upload, which you probably want to do with dput. If
you're uploading it to mentors, see the mentors documentation for the
correct dput configuration and target.

--
Russ Allbery (r...@debian.org) <http://www.eyrie.org/~eagle/>


--
To UNSUBSCRIBE, email to debian-ment...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listm...@lists.debian.org
Archive: http://lists.debian.org/874ndt5...@windlord.stanford.edu

Vincent Cheng

unread,
May 24, 2013, 12:20:01 AM5/24/13
to
Fetch the source tarball and debian diff:
$ dget ftp://ftp.cstone.net/debian/pool/non-free/g/glimpse/glimpse_4.18.5-1.dsc
$ cd glimpse-4.18.5
Add new changelog entry:
$ dch -i
Build (an unsigned) package:
$ dpkg-buildpackage -rfakeroot -us -uc
Upload to ftpmaster.d.o (but there's no point in doing this if you're
not a DD/DM):
$ dput glimpse_$VERSION_$ARCH.changes

There's obviously more to it, e.g. working with a patch system (quilt,
or a VCS), running lintian, building in a clean environment with tools
like pbuilder/sbuild, etc., but that'll get you started. One word of
advice: pick a package that's more modern to learn from. Modern,
short-hand dh is generally easier to work with (especially for simple
packages) than classic debhelper.

Regards,
Vincent


--
To UNSUBSCRIBE, email to debian-ment...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listm...@lists.debian.org
Archive: http://lists.debian.org/CACZd_tCJcX65r0HJ9OxHwC_4...@mail.gmail.com

Charles Plessy

unread,
May 24, 2013, 12:30:02 AM5/24/13
to
Le Fri, May 24, 2013 at 02:14:39AM +0000, T o n g a �crit :
>
> Not complaining, Debian has lot of good documents. Just that they are not
> to my taste. :-) They are written in the reference book style, whereas I
> more prefer a cook book style. :-) Still not complaining -- We've got to
> appreciate what we already have so far.

Hi,

have you considered the following tutorial ?

http://www.debian.org/doc/devel-manuals#packaging-tutorial

Cheers,

--
Charles Plessy
Tsurumi, Kanagawa, Japan


--
To UNSUBSCRIBE, email to debian-ment...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listm...@lists.debian.org
Archive: http://lists.debian.org/2013052404...@falafel.plessy.net

Robert J. Clay

unread,
May 24, 2013, 8:00:02 AM5/24/13
to
On Thu, May 23, 2013 at 11:59 PM, T o n g <mlist4...@yahoo.com> wrote:
> On Fri, 24 May 2013 02:14:39 +0000, T o n g wrote:
>
> So I found the glimpse dsc file at
> ftp://ftp.cstone.net/debian/pool/non-free/g/glimpse/glimpse_4.18.5-1.dsc

Something I always check in similar situations is if the package is
available at snapshot.debian.org. I primaraily use git these days,
and if what I want to work on is available there (like glimpse is) I
like to use something like 'git-import-dscs --debsnap ...' in order to
create an initial code repository to work with.





--
Robert J. Clay
rjc...@gmail.com
ja...@rocasa.us


--
To UNSUBSCRIBE, email to debian-ment...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listm...@lists.debian.org
Archive: http://lists.debian.org/CAL4BjXmUYAJC=8SNPSRcnc0j=v+teLKdjOs+1...@mail.gmail.com

T o n g

unread,
May 25, 2013, 12:30:02 AM5/25/13
to
On Fri, 24 May 2013 03:59:51 +0000, T o n g wrote:

> Can anyone explain me in simple commands how I can build and test upload
> this glimpse package please?

Hi, Thanks everyone who helped, including Charles.

You see, I didn't even know where to look for the old packages and didn't
know that step by step practical guide.

Your answers really help. Thanks.


--
To UNSUBSCRIBE, email to debian-ment...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listm...@lists.debian.org
Archive: http://lists.debian.org/knpe4a$cem$2...@ger.gmane.org

T o n g

unread,
May 26, 2013, 9:30:02 AM5/26/13
to
On Sat, 25 May 2013 04:19:22 +0000, T o n g wrote:

>> Can anyone explain me in simple commands how I can build and test
>> upload this glimpse package please?
>
> Hi, Thanks everyone who helped, including Charles...

Hi again,

I know it is recommended to always summarise after you get answers to
your question. So I did, and it is here.
http://sfxpt.wordpress.com/2013/05/24/debian-packages-building/

I.e., I compiled/summarised all your input into a single document, and
added comments. Hope via doing so, all your efforts will not just stopped
right here, and might help somebody else some day.

Thanks again, and feel free to comment on the blog please.



--
To UNSUBSCRIBE, email to debian-ment...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listm...@lists.debian.org
Archive: http://lists.debian.org/knt2jc$p1f$1...@ger.gmane.org
0 new messages