[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: New upstream packages?



Hi,
On Sun, Dec 19, 2004 at 02:48:02AM +0200, Antti-Juhani Kaijanaho wrote:
> Like with many other things in Debian, how you do it doesn't matter as
> long as you don't break things.  Things that should be considered
> include:
> 
>  - Use a -1 Debian revision number for the new upstream release.
> 
>  - Preserve old changelog entries (sounds obvious, but there have been
>    incidents...)
> 
>  - Add an entry "New upstream release" to the changelog.
> 
>  - Upgrades to the new version should preferably be silent and
>    nonintrusive (existing users should not notice the upgrade except by
>    discovering that old bugs have been fixed and there perhaps are new
>    features)
> 
>  - When an upgrade is necessarily intrusive (eg. it will break existing
>    usage), the upgrade must be noisy (a note in README.Debian or other
>    documentation is generally not enough; NEWS.Debian note may become
>    okay once apt-listchanges with NEWS.Debian support becomes standard
>    operating practice)
> 
>  - Existing Debian changes need to be reevaluated; throw away stuff that
>    upstream has incorporated (in one form or another) and remember to
>    keep stuff that hasn't been incorporated by upstream, unless there is
>    compelling reason not to.
> 
> I'm probably forgetting something here.
> 
> It isn't really possible to give comprehensive generally useful
> procedures - the situation dictates what you need to do.  For many
> packages, for small upstream upgrades, uupdate (from devscripts) can
> make all necessary changes.  Even then, you should be cautious and read
> upstream release documentation, lurk in upstream user forums and bug
> tracking systems looking for problem reports, test, test, test and test
> again.

True but these post are good baseline.  I added this to maint-guide CVS.

  http://www.debian.org/doc/manuals/maint-guide/ch-update.en.html#s-newupstream-real


I think NM needs to know these more than current released maint-guide.

Osamu



Reply to: