Thu Mar 8 12:11:55 2012 UTC ()
>From Bug Hunting:
add_todo.1:
- improve wording;
- update doc/TODO example;
- remove trailing white space.

obsolete_todo.1:
- improve wording;
- add a missing empty line;
- fix macro usage.

Further changes by myself, including date bump.


(wiz)
diff -r1.1.1.1 -r1.2 pkgsrc/pkgtools/pkgsrc-todo/files/add_todo.1
diff -r1.1.1.1 -r1.2 pkgsrc/pkgtools/pkgsrc-todo/files/obsolete_todo.1
cvs diff -r1.1.1.1 -r1.2 pkgsrc/pkgtools/pkgsrc-todo/files/add_todo.1 (expand / switch to unified diff)

--- pkgsrc/pkgtools/pkgsrc-todo/files/add_todo.1 2009/08/30 10:40:34 1.1.1.1
+++ pkgsrc/pkgtools/pkgsrc-todo/files/add_todo.1 2012/03/08 12:11:55 1.2
@@ -1,40 +1,40 @@ @@ -1,40 +1,40 @@
1.\" $NetBSD: add_todo.1,v 1.1.1.1 2009/08/30 10:40:34 wiz Exp $ 1.\" $NetBSD: add_todo.1,v 1.2 2012/03/08 12:11:55 wiz Exp $
2.\" 2.\"
3.Dd August 30, 2009 3.Dd March 8, 2012
4.Dt ADD_TODO 1 4.Dt ADD_TODO 1
5.Sh NAME 5.Sh NAME
6.Nm add_todo 6.Nm add_todo
7.Nd add entries to pkgsrc/doc/TODO 7.Nd add entries to pkgsrc/doc/TODO
8.Sh SYNOPSIS 8.Sh SYNOPSIS
9.Nm add_todo 9.Nm add_todo
10.Op Fl f 10.Op Fl f
11.Ar package 11.Ar package
12.Sh DESCRIPTION 12.Sh DESCRIPTION
13.Nm 13.Nm
14adds an entry for 14adds an entry for
15.Ar package 15.Ar package
16to the 16to the
17.Pa pkgsrc/doc/TODO 17.Pa pkgsrc/doc/TODO
18file. 18file.
19The 19The
20.Ar package 20.Ar package
21argument needs to of the form 21argument needs to be of the form
22.Dq PKGNAME-PKGVERSION , 22.Dq PKGNAME-PKGVERSION ,
23e.g. 23e.g.
24.Dq pkgsrc-todo-1.0 . 24.Dq pkgsrc-todo-1.1 .
25.Nm 25.Nm
26checks if the package exists in pkgsrc by looking for an entry for it 26checks if the package exists in pkgsrc by looking for an entry for it
27in the  27in the
28.Pa CHANGES-* 28.Pa CHANGES-*
29files (to catch typos). 29files (to catch typos).
30.Nm 30.Nm
31also checks if the update was already committed, i.e. if an entry for 31also checks if the update was already committed, i.e. if an entry for
32it or a newer version exists in any 32it or a newer version exists in any
33.Pa CHANGES-* 33.Pa CHANGES-*
34files. 34files.
35This second check can be overridden by using the 35This second check can be overridden by using the
36.Fl f 36.Fl f
37flag. 37flag.
38.Pp 38.Pp
39.Nm 39.Nm
40assumes that the contents of 40assumes that the contents of
cvs diff -r1.1.1.1 -r1.2 pkgsrc/pkgtools/pkgsrc-todo/files/obsolete_todo.1 (expand / switch to unified diff)

--- pkgsrc/pkgtools/pkgsrc-todo/files/obsolete_todo.1 2009/08/30 10:40:34 1.1.1.1
+++ pkgsrc/pkgtools/pkgsrc-todo/files/obsolete_todo.1 2012/03/08 12:11:55 1.2
@@ -1,28 +1,28 @@ @@ -1,28 +1,28 @@
1.\" $NetBSD: obsolete_todo.1,v 1.1.1.1 2009/08/30 10:40:34 wiz Exp $ 1.\" $NetBSD: obsolete_todo.1,v 1.2 2012/03/08 12:11:55 wiz Exp $
2.\" 2.\"
3.Dd August 30, 2009 3.Dd March 8, 2012
4.Dt OBSOLETE_TODO 1 4.Dt OBSOLETE_TODO 1
5.Sh NAME 5.Sh NAME
6.Nm obsolete_todo 6.Nm obsolete_todo
7.Nd remove obsolete entries from pkgsrc/doc/TODO 7.Nd remove obsolete entries from pkgsrc/doc/TODO
8.Sh SYNOPSIS 8.Sh SYNOPSIS
9.Nm obsolete_todo 9.Nm obsolete_todo
10.Sh DESCRIPTION 10.Sh DESCRIPTION
11.Nm 11.Nm
12removes entries from 12removes entries from
13.Pa pkgsrc/doc/TODO 13.Pa pkgsrc/doc/TODO
14which were already handled, i.e. that or newer versions already exist 14which were already handled, i.e. that or a newer version
15in pkgsrc. 15already exists in pkgsrc.
16.Nm 16.Nm
17does this by checking the entries in 17does this by checking the entries in
18.Pa pkgsrc/doc/TODO 18.Pa pkgsrc/doc/TODO
19against the entries in the various 19against the entries in the various
20.Pa pkgsrc/doc/CHANGES-* 20.Pa pkgsrc/doc/CHANGES-*
21files. 21files.
22.Pp 22.Pp
23.Nm 23.Nm
24assumes that the contents of 24assumes that the contents of
25.Pa pkgsrc/doc 25.Pa pkgsrc/doc
26are up-to-date. 26are up-to-date.
27The 27The
28.Pa TODO 28.Pa TODO
@@ -38,36 +38,32 @@ removes entries to this file. @@ -38,36 +38,32 @@ removes entries to this file.
38.Nm 38.Nm
39compares against these files for finding entries to remove. 39compares against these files for finding entries to remove.
40.El 40.El
41.Sh AUTHORS 41.Sh AUTHORS
42.An Thomas Klausner Aq wiz@NetBSD.org 42.An Thomas Klausner Aq wiz@NetBSD.org
43.Sh BUGS 43.Sh BUGS
44.Nm 44.Nm
45removes too many entries, so please don't directly commit the result 45removes too many entries, so please don't directly commit the result
46of 46of
47.Nm ! 47.Nm !
48Currently, the following entries are removed even though they 48Currently, the following entries are removed even though they
49shouldn't be: 49shouldn't be:
50.Bl -tag 50.Bl -tag
51.It bonnie++-1.96 51.It lapack-3.4.0
52.It drscheme-4.0.2 52.It ldapsdk-6.0.7
53.It exempi-2.0.2 
54.It fixesproto-4.1 
55.It lapack-3.2.1 
56.It ldapsdk-6.0.2 
57.It libixp-0.5 53.It libixp-0.5
58.It libssh-0.3.3 54.It libssh-0.5.2
59.It lmbench-2.5 55.It lmbench-2.5
60.It oto-0.5 56.It oto-0.5
61.It sch-3.8.3 
62.It zenicb-1.31 57.It zenicb-1.31
63.El 58.El
 59.Pp
64There are three reasons: 60There are three reasons:
65.Bl -enumerate 61.Bl -enum
66.It 62.It
67matching errors (bonnie vs. bonnie++) 63matching errors (bonnie vs. bonnie++)
68.It 64.It
69downgraded packages (exempi, fixesproto, oto, libixp) 65downgraded packages (libixp, oto)
70.It 66.It
71changes in versioning schemes (drscheme, lapack, ldapsdk, libssh, 67changes in versioning schemes (lapack, ldapsdk, libssh,
72lmbench, sch, zenicb) 68lmbench, zenicb)
73.El 69.El