Wed Mar 14 14:34:39 2012 UTC ()
Bug Hunting:
- remove unneeded consecutive argument for `.Nm' macro;
- improve wording.


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

--- pkgsrc/pkgtools/pkgsrc-todo/files/add_todo.1 2012/03/08 12:11:55 1.2
+++ pkgsrc/pkgtools/pkgsrc-todo/files/add_todo.1 2012/03/14 14:34:39 1.3
@@ -1,44 +1,43 @@ @@ -1,44 +1,43 @@
1.\" $NetBSD: add_todo.1,v 1.2 2012/03/08 12:11:55 wiz Exp $ 1.\" $NetBSD: add_todo.1,v 1.3 2012/03/14 14:34:39 wiz Exp $
2.\" 2.\"
3.Dd March 8, 2012 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
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 be 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.1 . 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 30It also 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 31it or a newer version exists in any
33.Pa CHANGES-* 32.Pa CHANGES-*
34files. 33files.
35This second check can be overridden by using the 34This second check can be overridden by using the
36.Fl f 35.Fl f
37flag. 36flag.
38.Pp 37.Pp
39.Nm 38.Nm
40assumes that the contents of 39assumes that the contents of
41.Pa pkgsrc/doc 40.Pa pkgsrc/doc
42are up-to-date. 41are up-to-date.
43The 42The
44.Pa TODO 43.Pa TODO
cvs diff -r1.2 -r1.3 pkgsrc/pkgtools/pkgsrc-todo/files/obsolete_todo.1 (expand / switch to unified diff)

--- pkgsrc/pkgtools/pkgsrc-todo/files/obsolete_todo.1 2012/03/08 12:11:55 1.2
+++ pkgsrc/pkgtools/pkgsrc-todo/files/obsolete_todo.1 2012/03/14 14:34:39 1.3
@@ -1,30 +1,29 @@ @@ -1,30 +1,29 @@
1.\" $NetBSD: obsolete_todo.1,v 1.2 2012/03/08 12:11:55 wiz Exp $ 1.\" $NetBSD: obsolete_todo.1,v 1.3 2012/03/14 14:34:39 wiz Exp $
2.\" 2.\"
3.Dd March 8, 2012 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 
10.Sh DESCRIPTION 
11.Nm 9.Nm
12removes entries from 10.Sh DESCRIPTION
13.Pa pkgsrc/doc/TODO 
14which were already handled, i.e. that or a newer version 
15already exists in pkgsrc. 
16.Nm 11.Nm
17does this by checking the entries in 12removes obsoleted entries from
 13.Pa pkgsrc/doc/TODO ,
 14i.e., entries for packages that already exist
 15in pkgsrc in either the version from the entry or a higher one.
 16It does this by checking the entries in
18.Pa pkgsrc/doc/TODO 17.Pa pkgsrc/doc/TODO
19against the entries in the various 18against the entries in the various
20.Pa pkgsrc/doc/CHANGES-* 19.Pa pkgsrc/doc/CHANGES-*
21files. 20files.
22.Pp 21.Pp
23.Nm 22.Nm
24assumes that the contents of 23assumes that the contents of
25.Pa pkgsrc/doc 24.Pa pkgsrc/doc
26are up-to-date. 25are up-to-date.
27The 26The
28.Pa TODO 27.Pa TODO
29file needs to be committed manually afterwards, but read 28file needs to be committed manually afterwards, but read
30.Sx BUGS 29.Sx BUGS