===================================================================
RCS file: /cvsrepo/anoncvs/cvs/src/etc/rc,v
retrieving revision 1.482
retrieving revision 1.483
diff -u -r1.482 -r1.483
--- src/etc/rc	2016/05/26 16:29:51	1.482
+++ src/etc/rc	2016/05/27 16:49:08	1.483
@@ -1,4 +1,4 @@
-#	$OpenBSD: rc,v 1.482 2016/05/26 16:29:51 deraadt Exp $
+#	$OpenBSD: rc,v 1.483 2016/05/27 16:49:08 rpe Exp $
 
 # System startup script run by init on autoboot or after single-user.
 # Output and error are redirected to console by init, and the console is the
@@ -158,6 +158,7 @@
 	ssh-keygen -A
 }
 
+# Re-link libraries, placing the objects in a random order.
 reorder_libs() {
 	local _l _liba _libas _tmpdir _remount=false
 	local _dkdev=/dev/$(stat -L -f '%Sd' /usr/lib)
@@ -214,6 +215,8 @@
 	echo ' done.'
 }
 
+# Run rc.* script and email output to root.
+# Usage: run_upgrade_script firsttime|sysmerge
 run_upgrade_script() {
 	local _suffix=$1
 	[[ -n $_suffix ]] || return 1