On Wed, 2006-10-04 at 15:44, ext Guillem Jover wrote: > On Wed, 2006-10-04 at 14:36:24 +0300, ext Kimmo Hämäläinen wrote: > > On Wed, 2006-10-04 at 14:04, ext Murray Cumming wrote: > > > On Wed, 2006-10-04 at 13:45 +0300, Kimmo Hämäläinen wrote: > > > > Yes, it does not tell the reasons for the changes (they are in > > > > debian/changelog), but I'm too lazy to put those since you seem to be > > > > the only one who is interested about Libosso changes ;) > > I consider those two serve different purposes, ChangeLog (as in upstream) > explains in detail up to the function and variable level what has been > changed. And debian/changelog describes the packaging changes, and a > summary of upstream changes if it's native package.
I knew this, but if I only edit one file, then it's debian/changelog. There is no upstream in this case, not even other developers... > > > At the moment, nobody (me included) knows what on earth libosso is. The > > > README is empty, for instance. > > > > It's there just because automake complains otherwise. > > That's because automake defaults to gnu strictness, if you are not > following the GCS[0] you probably want: > > AM_INIT_AUTOMAKE([foreign]) > > > 98% of Debian packages the README file is totally useless anyway. > > On this one I disagree, if you have specific examples, please tell me > or file bug reports. I'm not that bored. > > > ChangeLogs are one way to introduce people to what a module does and how > > > it works, and how it is evolving. Not doing ChangeLogs because nobody > > > cares about them would be almost a circular argument. > > [ This snipped reordered ] > > The code and API should be pretty self-explaining (yes, they're not, > > that's why I'm working on new API). > > > Well, just try to use the diff. The code is so simple that manually > > writing some ChangeLog just seems stupid to me. > > It's not about the code being simple, it's about having an offline > history of what has been changed and how the code evolved. That's > pretty useful when tracking down bugs for example. I think this 'offline usage' is rare enough use case to ignore (especially with Libosso). The bugs are pretty simple to spot if the code is simple and short (especially if you have access to SVN). BR; Kimmo > > > [0] <http://www.gnu.org/prep/standards/standards.html> > > regards, > guillem > _______________________________________________ > maemo-developers mailing list > maemo-developers@maemo.org > https://maemo.org/mailman/listinfo/maemo-developers _______________________________________________ maemo-developers mailing list maemo-developers@maemo.org https://maemo.org/mailman/listinfo/maemo-developers
