--- undocumented.7.orig	2007-01-31 18:47:51.490493836 -0800
+++ undocumented.7	2007-01-31 19:31:23.753233157 -0800
@@ -54,24 +54,44 @@
 The most important and time-consuming task is to collect the
 information to be put in the new manpage.
 
-Try the following options if you want more information.
-
-foo \-\-help, foo \-h, foo \-?
-.PP 
-info foo
-.PP 
-whatis foo, apropos foo
-.PP 
-check directories /usr/share/doc/foo, /usr/lib/foo
-.PP 
-dpkg \-\-listfiles foo, dpkg \-\-search foo
+.SH DIAGNOSTICS
 .PP
-locate '*foo*'
+It is possible that the man page for the command you specified is installed
+and that your manual page index caches are out of sync. You should try
+running
+.BR mandb (8).
 .PP
-find / \-name '*foo*'
+Try the following options if you want more information:
+.IP
+.B foo
+.BR \-\-help ,
+.B foo
+.BR \-h ,
+.B foo \-?
+.IP 
+.B info foo
+.IP 
+.B whatis
+.BR foo ,
+.B apropos foo
+.IP 
+.B dpkg \-\-listfiles
+.BR foo ,
+.B dpkg \-\-search foo
+.IP
+.B locate '*foo*'
+.IP
+.B find / \-name '*foo*'
+.IP
+check directories
+.IR /usr/share/doc/foo ,
+.I /usr/lib/foo
 .PP
 The documentation might be in a package starting with the same
-name as the package the software belongs to, but ending with -doc or -docs.
+name as the package the software belongs to, but ending with
+.I -doc
+or
+.IR -docs .
 .PP
 If you still didn't find the information you are looking for you might
 consider posting a call for help to
@@ -86,4 +106,5 @@
 .BR updatedb (1),
 .BR undocumented (2),
 .BR man (7),
+.BR mandb (8),
 .BR missing (7).