On Mon, May 15, 2006 at 04:02:15PM -0400, pryzbyj wrote:
> On Mon, May 15, 2006 at 10:00:33PM +0200, Michael Kerrisk wrote:
> > Justin,
> >
> > > Please make at least one other manual page reference a64l.3. Lacking
> > > better ideas, I suggest strfry.3 and memfrob.3, since they are
> > > neighbors in glibc-doc.
> >
> > This mention of what glibc-doc is not a compelling reason for a
> > change. Reasons for changes need to be obvious, or well explained.
> As I say, lacking better ideas. I'll leave this opened until I have
> some..
I looked at the more general problem of "manpages which are not
referenced by other manpages". Some of these are trivial to fix, and
others take more thought, others still are too special purpose to be
referenced all (or I don't know enough of the obscure manpages):
sk98lin, units, koi8-r...
time { for f in `dpkg -L manpages{,-dev} |grep -o 'man[^/]*/[^/]*\.gz$'`; do
mkdir -p $f; cd $f; zcat /usr/share/man/$f |sed -ne '/^\.SH "SEE ALSO"$/,$ p;'
|grep -Ew '^\.BR' >`basename $f`; cd ../../; done; } &
time { for f in `dpkg -L manpages{,-dev} |grep '\.gz$'`; do test -L $f &&
continue; f=`basename $f .gz |sed -re 's/\.([0-9])$/.*\1/'`; grep -iqr "$f" .
|| echo $f; done >not-referenced; }
Included is a list of 143 unreferenced pages, and a patch for some.
Let me know if this is useful.
Justin
--- - 2006-05-15 20:24:19.920890000 -0400
+++ /tmp/fopen3.gz.22896 2006-05-15 20:24:19.000000000 -0400
@@ -249,4 +249,5 @@
.SH "SEE ALSO"
.BR open (2),
.BR fclose (3),
+.BR popen (3),
.BR fileno (3)
--- - 2006-05-15 20:24:20.364734000 -0400
+++ /tmp/getsid2.gz.22908 2006-05-15 20:24:20.000000000 -0400
@@ -65,4 +65,5 @@
for some integer \fIn\fP larger than or equal to 500.
.SH "SEE ALSO"
.BR getpgid (2),
+.BR tcgetsid (3),
.BR setsid (2)
--- - 2006-05-15 20:24:20.808634000 -0400
+++ /tmp/isascii3.gz.22920 2006-05-15 20:24:20.000000000 -0400
@@ -171,4 +171,5 @@
.BR tolower (3),
.BR toupper (3),
.BR ascii (7),
+.BR toascii (3),
.BR locale (7)
--- - 2006-05-15 20:24:21.257739000 -0400
+++ /tmp/rcmd3.gz.22932 2006-05-15 20:24:21.000000000 -0400
@@ -197,6 +197,7 @@
.Xr rsh 1 ,
.Xr intro 2 ,
.Xr rexec 3 ,
+.Xr rtime 3 ,
.Xr rexecd 8 ,
.Xr rlogind 8 ,
.Xr rshd 8
--- - 2006-05-15 20:24:21.708147000 -0400
+++ /tmp/rexec3.gz.22944 2006-05-15 20:24:21.000000000 -0400
@@ -120,6 +120,7 @@
although you may be able to get its attention by using out-of-band data.
.Sh SEE ALSO
.Xr rcmd 3 ,
+.Xr rtime 3 ,
.Xr rexecd 8
.Sh HISTORY
The
--- - 2006-05-15 20:24:22.602800000 -0400
+++ /tmp/strcpy3.gz.22968 2006-05-15 20:24:22.000000000 -0400
@@ -73,4 +73,5 @@
.BR memcpy (3),
.BR memmove (3),
.BR wcscpy (3),
-.BR wcsncpy (3)
+.BR wcsncpy (3),
+.BR stpcpy (3)
--- - 2006-05-15 20:24:23.047482000 -0400
+++ /tmp/usleep3.gz.22980 2006-05-15 20:24:23.000000000 -0400
@@ -116,4 +116,5 @@
.BR nanosleep (2),
.BR select (2),
.BR setitimer (2),
+.BR ualarm (3),
.BR sleep (3)
intro.*1
intro.*2
intro.*3
dsp56k.*4
full.*4
hd.*4
intro.*4
lp.*4
mouse.*4
rtc.*4
sk98lin.*4
st.*4
mem.*4
random.*4
dir_colors.*5
elf.*5
host.conf.*5
intro.*5
mailname.*5
nologin.*5
termcap.*5
acct.*5
hosts.equiv.*5
securetty.*5
intro.*6
arp.*7
icmp.*7
intro.*7
koi8-r.*7
missing.*7
netdevice.*7
operator.*7
suffixes.*7
units.*7
uri.*7
x25.*7
LDP.*7
intro.*8
tzselect.*8
ksoftirqd.*9
HOWTOHELP
Changes.old
changelog.Debian
arch_prctl.*2
cacheflush.*2
exit_group.*2
getdtablesize.*2
gethostid.*2
idle.*2
io_cancel.*2
io_destroy.*2
io_getevents.*2
io_setup.*2
io_submit.*2
lookup_dcookie.*2
mbind.*2
msgop.*2
outb.*2
personality.*2
pivot_root.*2
readv.*2
reboot.*2
sigreturn.*2
socketcall.*2
sstk.*2
swapon.*2
sysfs.*2
sysinfo.*2
uselib.*2
ustat.*2
access.*2
alloc_hugepages.*2
get_mempolicy.*2
nfsservctl.*2
pciconfig_read.*2
readahead.*2
remap_file_pages.*2
sigpause.*2
undocumented.*2
vhangup.*2
__setfpucw.*3
a64l.*3
basename.*3
bindresvport.*3
ffs.*3
fts.*3
ftw.*3
j0.*3
cfree.*3
conj.*3
dysize.*3
envz_add.*3
ether_aton.*3
fdim.*3
getdirentries.*3
getline.*3
getloadavg.*3
getlogin.*3
getopt.*3
getspnam.*3
gsignal.*3
insque.*3
mbsinit.*3
pow10.*3
profil.*3
re_comp.*3
rexec.*3
setaliasent.*3
setnetgrent.*3
significand.*3
sincos.*3
timegm.*3
wctob.*3
argz_add.*3
byteorder.*3
clock_getres.*3
confstr.*3
cproj.*3
ctermid.*3
daemon.*3
des_crypt.*3
drand48_r.*3
fmemopen.*3
getfsent.*3
getgrouplist.*3
getrpcport.*3
getumask.*3
key_setsecret.*3
PATCHED:
popen.*3
rcmd.*3
rtime.*3
tcgetsid.*3
toascii.*3
ualarm.*3
stpcpy.*3
TODO:
queue.*3
stdarg.*3
stdin.*3
nextafter.*3
--- - 2006-05-15 20:24:19.920890000 -0400
+++ /tmp/fopen3.gz.22896 2006-05-15 20:24:19.000000000 -0400
@@ -249,4 +249,5 @@
.SH "SEE ALSO"
.BR open (2),
.BR fclose (3),
+.BR popen (3),
.BR fileno (3)
--- - 2006-05-15 20:24:20.364734000 -0400
+++ /tmp/getsid2.gz.22908 2006-05-15 20:24:20.000000000 -0400
@@ -65,4 +65,5 @@
for some integer \fIn\fP larger than or equal to 500.
.SH "SEE ALSO"
.BR getpgid (2),
+.BR tcgetsid (3),
.BR setsid (2)
--- - 2006-05-15 20:24:20.808634000 -0400
+++ /tmp/isascii3.gz.22920 2006-05-15 20:24:20.000000000 -0400
@@ -171,4 +171,5 @@
.BR tolower (3),
.BR toupper (3),
.BR ascii (7),
+.BR toascii (3),
.BR locale (7)
--- - 2006-05-15 20:24:21.257739000 -0400
+++ /tmp/rcmd3.gz.22932 2006-05-15 20:24:21.000000000 -0400
@@ -197,6 +197,7 @@
.Xr rsh 1 ,
.Xr intro 2 ,
.Xr rexec 3 ,
+.Xr rtime 3 ,
.Xr rexecd 8 ,
.Xr rlogind 8 ,
.Xr rshd 8
--- - 2006-05-15 20:24:21.708147000 -0400
+++ /tmp/rexec3.gz.22944 2006-05-15 20:24:21.000000000 -0400
@@ -120,6 +120,7 @@
although you may be able to get its attention by using out-of-band data.
.Sh SEE ALSO
.Xr rcmd 3 ,
+.Xr rtime 3 ,
.Xr rexecd 8
.Sh HISTORY
The
--- - 2006-05-15 20:24:22.602800000 -0400
+++ /tmp/strcpy3.gz.22968 2006-05-15 20:24:22.000000000 -0400
@@ -73,4 +73,5 @@
.BR memcpy (3),
.BR memmove (3),
.BR wcscpy (3),
-.BR wcsncpy (3)
+.BR wcsncpy (3),
+.BR stpcpy (3)
--- - 2006-05-15 20:24:23.047482000 -0400
+++ /tmp/usleep3.gz.22980 2006-05-15 20:24:23.000000000 -0400
@@ -116,4 +116,5 @@
.BR nanosleep (2),
.BR select (2),
.BR setitimer (2),
+.BR ualarm (3),
.BR sleep (3)
