From nobody@FreeBSD.ORG Sat Jul  3 04:43:45 1999
Return-Path: <nobody@FreeBSD.ORG>
Received: by hub.freebsd.org (Postfix, from userid 32767)
	id 4D8DD14E35; Sat,  3 Jul 1999 04:43:45 -0700 (PDT)
Message-Id: <19990703114345.4D8DD14E35@hub.freebsd.org>
Date: Sat,  3 Jul 1999 04:43:45 -0700 (PDT)
From: jmonroy@email.com
Sender: nobody@FreeBSD.ORG
To: freebsd-gnats-submit@freebsd.org
Subject: (23) canidate whatis(1) entries for docs/12486
X-Send-Pr-Version: www-1.0

>Number:         12494
>Category:       docs
>Synopsis:       (23) canidate whatis(1) entries for docs/12486
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Jul  3 04:50:01 PDT 1999
>Closed-Date:    Sat Jul 3 05:09:59 PDT 1999
>Last-Modified:  Sat Jul  3 05:30:00 PDT 1999
>Originator:     Jesus Monroy
>Release:        3.1-RELEASE
>Organization:
Digital Marshalls
>Environment:
FreeBSD vidi.mozie.com 3.1-RELEASE FreeBSD 3.1-RELEASE #0: Mon Jan  1 03:20:27 PST 1996     root@vidi.dnull.com:/usr/src/sys/compile/VIDI  i386
>Description:
Whatis(1) candidates for 23 of 56 entires in docs/12486.
Any other questions?
>How-To-Repeat:
#!/bin/sh
#
#  written by Jesus Monroy, Jr. (thepinkpages@email.com
#  date: 1999.07.02
#  purpose: extract canidate for whatis(1) entry from manpage
#
D="/bin /sbin /usr/bin /usr/sbin"
P="/usr/home/your-dir/perl-script-below"

# for every list item; do
for DIR in $D ; do
    cd $DIR
    echo ----------
    echo $DIR
    echo ----------
    L=`ls -1`
    # iterate over list
    for U in $L; do
        R=`whatis $U | grep "nothing"`
        # check for empty return string
        if [ X"$R" != X"" ] ; then
            R2=`man $U 2> /dev/null`
            # check exit status value
            if [ $? -eq 0 ] ; then
                echo -n "$U: "
                man $U | col -b | perl $P
            fi
        fi
    done
done 
###################################################
#  PERL PROGRAM - output requires cleaning
###################################################
#!/usr/bin/perl
while (<>) {
    if (/name/i) {$g++ ; next}
    chop;
    if ($g > 0 ) { print $_; print "\n"; $l++ }
    last if ($l > 1);
}  

>Fix:
----------
/bin
----------
[:      test - condition evaluation utility
----------
/sbin
----------
fastboot:      reboot, halt - stopping and restarting the system
fasthalt:      reboot, halt - stopping and restarting the system
rdump:      dump - filesystem backup
rrestore:      restore - restore files or file systems from backups made with dump
----------
/usr/bin
----------
byacc:      yacc - an LALR(1) parser generator
captoinfo:      tconv - convert between termcap, terminfo source and terminfo binary
cc:        gcc, g++ - GNU project C and C++ Compiler (v2.7)
flex++:        flex - fast lexical analyzer generator
gzcat:        gzip, gunzip, zcat - compress or expand files
lex:        flex - fast lexical analyzer generator
lex++:        flex - fast lexical analyzer generator
nex:        ex, vi, view - text editors
nvi:        ex, vi, view - text editors
nview:        ex, vi, view - text editors
ree:      ee - easy editor
sendbug:        send-pr -  send  problem report (PR) to a central support site
sum:      cksum - display file checksums and block counts
tic:      tconv - convert between termcap, terminfo source and terminfo binary
zegrep:        grep, egrep, fgrep, zgrep - print lines matching a pattern
zfgrep:        grep, egrep, fgrep, zgrep - print lines matching a pattern
----------
/usr/sbin
----------
ctm_dequeue:      ctm_smail, ctm_rmail - send and receive ctm deltas via mail
pmap_set:        rpc - library routines for remote procedure calls 


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: mpp 
State-Changed-When: Sat Jul 3 05:09:59 PDT 1999 
State-Changed-Why:  
See my response to PR docs/12493. 

From: Mike Pritchard <mpp@mpp.pro-ns.net>
To: jmonroy@email.com
Cc: freebsd-gnats-submit@FreeBSD.ORG
Subject: Re: docs/12494: (23) canidate whatis(1) entries for docs/12486
Date: Sat, 3 Jul 1999 07:27:07 -0500 (CDT)

 > >Synopsis:       (23) canidate whatis(1) entries for docs/12486
 > /usr/sbin
 > ----------
 > ctm_dequeue:      ctm_smail, ctm_rmail - send and receive ctm deltas via mail
 
 And if you are going to keep submitting PRs like this, please
 keep track of the cvs-commit mail.  I've already fixed some of the cases
 you mentioned in your original PR, ctm_dequeue being one of them.
 That was fixed a week ago.
 -- 
 Mike Pritchard
 mpp@FreeBSD.ORG or mpp@mpp.pro-ns.net
 
>Unformatted:
