[Openswan dev] problems in several man pages you maintain

[D. Hugh Redelmeier]

-----BEGIN PGP SIGNED MESSAGE-----


| From: esr at thyrsus.com
| To: dev at openswan.org
| 
| This is automatically generated email about problems in a man page for which
| you appear to be responsible.  If you are not the right person or list, tell
| me and I will attempt to correct my database.

I am not the maintainer of these documents, but I did write some of
them.

Thanks for your report.  Cleaning up is an important thankless task.

Your report was enormous.  Mostly because of duplication.  I passed
your email through
	egrep '^Problems' | sort | uniq -c
and got the following.  Could you adjust your script so as not to
duplicate the reports so many times?

     56	Problems with ipsec_addrbytesof.3:
     53	Problems with ipsec_addrbytesptr.3:
     54	Problems with ipsec_addrcmp.3:
     52	Problems with ipsec_addrinsubnet.3:
     51	Problems with ipsec_addrlenof.3:
     50	Problems with ipsec_addrtoa.3:
     49	Problems with ipsec_addrtosubnet.3:
     48	Problems with ipsec_addrtot.3:
     55	Problems with ipsec_addrtypeof.3:
     82	Problems with ipsec_anyaddr.3:
     46	Problems with ipsec_atoaddr.3:
     45	Problems with ipsec_atoasr.3:
     44	Problems with ipsec_atosubnet.3:
     43	Problems with ipsec_bitstomask.3:
     42	Problems with ipsec_broadcastof.3:
     41	Problems with ipsec_copyright_notice.3:
     40	Problems with ipsec_goodmask.3:
     39	Problems with ipsec_hostof.3:
     38	Problems with ipsec_initaddr.3:
     37	Problems with ipsec_initsaid.3:
     36	Problems with ipsec_initsubnet.3:
     34	Problems with ipsec_isanyaddr.3:
     33	Problems with ipsec_isloopbackaddr.3:
     32	Problems with ipsec_isunspecaddr.3:
     31	Problems with ipsec_loopbackaddr.3:
      1	Problems with ipsec_mailkey.8:
     30	Problems with ipsec_maskof.3:
     29	Problems with ipsec_masktobits.3:
     28	Problems with ipsec_masktocount.3:
     27	Problems with ipsec_networkof.3:
      2	Problems with ipsec_newhostkey.8:
     58	Problems with ipsec_pluto.8:
     26	Problems with ipsec_portof.3:
     25	Problems with ipsec_prng.3:
     24	Problems with ipsec_rangetoa.3:
      1	Problems with ipsec_rsasigkey.8:
     23	Problems with ipsec_sameaddr.3:
     22	Problems with ipsec_sameaddrtype.3:
     21	Problems with ipsec_samesaid.3:
     20	Problems with ipsec_samesubnet.3:
     19	Problems with ipsec_samesubnettype.3:
     18	Problems with ipsec_satot.3:
     17	Problems with ipsec_setportof.3:
     16	Problems with ipsec_sockaddrlenof.3:
     15	Problems with ipsec_sockaddrof.3:
     14	Problems with ipsec_subnetinsubnet.3:
     13	Problems with ipsec_subnetishost.3:
     12	Problems with ipsec_subnetof.3:
     11	Problems with ipsec_subnettoa.3:
     10	Problems with ipsec_subnettot.3:
      9	Problems with ipsec_subnettypeof.3:
      8	Problems with ipsec_tnatoaddr.3:
      7	Problems with ipsec_ttoaddr.3:
      6	Problems with ipsec_ttosa.3:
      1	Problems with ipsec_ttosubnet.3:
      5	Problems with ipsec_unspecaddr.3:
      4	Problems with ipsec_version.3:
      3	Problems with ipsec_version_code.3:
      2	Problems with ipsec_version_string.3:
     57	Problems with ipsec_whack.8:

Note that there are even more duplicates when you realize that many of
these files are just symlinks to others.  It is conventional in man
pages to document related entries in one page but have several names
for that page; I take it that docbook is incapable of handling this
useful convention.

I have some more substantive comments, but I will await a revised
report from you.

Thanks again,

Hugh Redelmeier
hugh at mimosa.com  voice: +1 416 482-8253

-----BEGIN PGP SIGNATURE-----
Version: 2.6.3ia
Charset: noconv

iQCVAwUBQbIBOMFAuQPManGZAQGAvgP+Iefo9XGaVXhYV6rjmJg5Rokd1q3TPFkZ
8Q9wNQ504jun1ppbpKB8vpS+Cj5Ryc6+Yfu4GTd534fFjqkkTCgoD4YR2BrZSAGM
OOtToONWnWXQtnrLvQTBbj6ppNOauXLlamsqWm63nqHaluCLcG8YopZCJAvz3tpZ
iogZhFCRDrA=
=oaPc
-----END PGP SIGNATURE-----