[5535] in Athena Bugs
vax 7.0F: /usr/lib/makewhatis
daemon@ATHENA.MIT.EDU (krishna@ATHENA.MIT.EDU)
Fri Jul 13 12:06:50 1990
From: krishna@ATHENA.MIT.EDU
To: bugs@ATHENA.MIT.EDU
Cc: rel-eng@ATHENA.MIT.EDU, krishna@ATHENA.MIT.EDU
Date: Fri, 13 Jul 90 12:06:27 EDT
System name: tabetha
Type and version: CVAXSTAR 7.0F (1 update(s) to same version)
Display type: SM
What were you trying to do?
Run makewhatis to see if it generates apropos information correctly for
mh manual pages.
What's wrong:
It takes lines like:
.TH DP 8 MH [mh.6] dp \- parse dates 822\-style
.TH INSTALL-MH 8 MH [mh.6] install\-mh \- initialize the MH environment
.TH MH\-FORMAT 5 MH [mh.6] mh\-format \- format file for MH message system
and produces them into:
dp (8) - parse dates 822\-style
install(8) -mh \- initialize the MH environment
mh\(5) -format \- format file for MH message system
What should have happened:
makewhatis should be more intelligent about changing \- to - , and about
parsing the .TH line correctly in order to prevent commands with dashes in the
names from being split.
A fixed version of makewhatis is available via
attach docsourc
cd /mit/docsourc/manrelease/manrelease.new/Man/krishna/MailHandler/
more makewhatis
I ran this on the entire current set of manual pages
(/afs/testers.athena.mit.edu/system/vax_bsd43/srvd/usr/man/...), and the only
differences I got were:
% diff -btw /{usr,tmp}/man/whatis
23,24c23,24
< L(5) -devices - UUCP device description file
< L(5) -dialcodes - UUCP phone number index file
---
> L-devices (5) - UUCP device description file
> L-dialcodes (5) - UUCP phone number index file
557c557
< inetd (8) - internet ``super\-server''
---
> inetd (8) - internet ``super-server''
896c896
< sabertool (1) - Saber-C programming environment for the SunView window system .br xsaber \- Saber-C programming environment for the X11 window system
---
> sabertool - Saber-C programming environment for the SunView window system .br xsaber (1) - Saber-C programming environment for the X11 window system
This alteration managed to fix the L-devices, L-dialcodes and inetd entries,
and partially fixed the xsaber entry.
The following manual pages don't have descriptions, or have incorrect formats
for the NAME section:
% egrep -v '[^I ]-' /tmp/man/whatis
MIT X Consortium(1)
X Standards(1)
XtCreatePopupShell(3Xt)
mr_connect, mr_host, mr_auth, mr_disconnect, mr_noop, mr_access, mr_query, mr_do_update, mr_motd, mr_set_alternate_input, format_filesys_type, parse_filesys_type, canonicalize_hostname, strsave, strtrim, sq_create, sq_destroy, sq_get_data,sq_remove_data, sq_empty, sq_save_args, sq_save_data, sq_save_unique_data, sq_save_unique_string(3)
resolver configuration file(5)
rkinit, rkinit_errmsg(3)
xditview \(em display ditroff DVI files(1)
Here is a diff of the two makewhatis files:
*** /usr/lib/makewhatis Thu May 3 13:45:01 1990
--- makewhatis Fri Jul 13 04:26:26 1990
***************
*** 24,35 ****
fi
done >/tmp/whatisx.$$
sed </tmp/whatisx.$$ >/tmp/whatis$$ \
! -e 's/\\-/-/' \
! -e 's/\\\*-/-/' \
-e 's/ VAX-11//' \
-e 's/\\f[PRIB0123]//g' \
-e 's/\\s[-+0-9]*//g' \
! -e 's/.TH [^ ]* \([^ ]*\).* \([^-]*\)/\2(\1) /' \
-e 's/ / /g'
/usr/ucb/expand -24,28,32,36,40,44,48,52,56,60,64,68,72,76,80,84,88,92,96,100 \
/tmp/whatis$$ | sort | /usr/ucb/unexpand -a > whatis
--- 24,36 ----
fi
done >/tmp/whatisx.$$
sed </tmp/whatisx.$$ >/tmp/whatis$$ \
! -e 's/\\-/-/g' \
! -e 's/\\\*-/-/g' \
-e 's/ VAX-11//' \
-e 's/\\f[PRIB0123]//g' \
-e 's/\\s[-+0-9]*//g' \
! -e 's/.TH [^ ]* \([^ ]*\).* \(.* \)-/\2(\1) -/' \
! -e 's/.TH [^ ]* \([^ ]*\).* \(.*\)$/\2(\1)/' \
-e 's/ / /g'
/usr/ucb/expand -24,28,32,36,40,44,48,52,56,60,64,68,72,76,80,84,88,92,96,100 \
/tmp/whatis$$ | sort | /usr/ucb/unexpand -a > whatis
This should be installed if at all possible, because it will allow correct
inclusion of the MH manual pages in the whatis listing. Richard Basch examined
these changes and found them to be correct.
Please describe any relevant documentation references:
Krishna Sethuraman
krishna@athena.mit.edu
