From f9d8d64f454f02803bd023fdc3facd6c03202421 Mon Sep 17 00:00:00 2001
From: Brooks Davis <brooks@FreeBSD.org>
Date: Thu, 20 Oct 2005 19:23:16 +0000
Subject: [PATCH] Mention the possibility of non-interactive scripts for EDITOR
 and add a BUGS section mentioning the requirement that such scripts run
 "sleep 1" or equivalent to work reliably.

---
 usr.sbin/vipw/vipw.8 | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/usr.sbin/vipw/vipw.8 b/usr.sbin/vipw/vipw.8
index 19eafaf640f3..2e063212c51d 100644
--- a/usr.sbin/vipw/vipw.8
+++ b/usr.sbin/vipw/vipw.8
@@ -92,6 +92,8 @@ The editor specified by the string
 .Ev EDITOR
 will be invoked instead of the default editor
 .Xr vi 1 .
+This can be used to allow a script to non-interactively modify the
+password file.
 .It Ev PW_SCAN_BIG_IDS
 See
 .Xr pwd_mkdb 8 .
@@ -108,3 +110,10 @@ The
 .Nm
 utility appeared in
 .Bx 4.0 .
+.Sh BUGS
+The mechanism for checking for password file modifications requires that
+.Ev EDITOR
+run for at least one second.
+Non-interactive editor scripts should invoke
+.Xr sleep 1
+or equivalent to insure this happens.