>Number:         27250
>Category:       pkg
>Synopsis:       man page of pkgclean should explicitly say "working in background"
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    pkg-manager
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Wed Oct 13 12:26:00 UTC 2004
>Closed-Date:
>Last-Modified:
>Originator:     Ryo HAYASAKA
>Release:        NetBSD 2.99.9
>Organization:
Japan Advanced Institute of Science and Technology (JAIST)
>Environment:
System: NetBSD bonnie.jaist.ac.jp 2.99.9 NetBSD 2.99.9 (BONNIE) #508: Wed Oct 13 14:33:59 JST 2004 ryoh@bonnie.jaist.ac.jp:/sys/arch/i386/compile/BONNIE i386
Architecture: i386
Machine: i386
ryoh@bonnie$ pkg_info | fgrep pkgclean
pkgclean-20040622   Quickly clean up all work directories in pkgsrc

>Description:
The man page of pkgclean describes pkgclean as a fast alternative for
"cd /usr/pkgsrc && make clean", which waits for finishing the deletion
of all "work" directories.  When "make clean" finishes, all "work"
directories have been deleted.

In the meantime, pkgclean does not wait for finishing the deletion of
them, since it forks and its child processes actually do the job.
Although pkgclean finishes, many "rm" processes are still running.

The difference of the process in foreground for "make clean" and in
background for pkgclean is confusing.
	
>How-To-Repeat:
	
>Fix:
Say that pkgclean runs in background (like "cd /usr/pkgsrc && make clean
&"?) in the man page, or change pkgclean to wait for the termination of
all the child processes.
	
>Release-Note:
>Audit-Trail:
>Unformatted: