move the advice about smart, readattr, and sec* to before the command

list, since it doesn;t make sense to put these in any one single
command description (nor indeed to repeat them for every command);

ok grange

1 files changed, 25 insertions, 32 deletions

diff --git a/sbin/atactl/atactl.8 b/sbin/atactl/atactl.8
index 9c941495963..6a6a65f0e94 100644
--- a/sbin/atactl/atactl.8
+++ b/sbin/atactl/atactl.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: atactl.8,v 1.33 2006/10/03 14:36:29 jmc Exp $
+.\"	$OpenBSD: atactl.8,v 1.34 2006/10/03 19:05:10 jmc Exp $
 .\"	$NetBSD: atactl.8,v 1.5 1999/02/24 18:49:14 jwise Exp $
 .\"
 .\" Copyright (c) 1998 The NetBSD Foundation, Inc.
@@ -61,7 +61,7 @@ apmdisable,
 apmset,
 checkpower,
 dump,
-identify,
+identify (the default),
 idle,
 poddisable,
 podenable,
@@ -92,12 +92,29 @@ writecachedisable,
 and
 writecacheenable.
 .Pp
-If
-.Ar command
-is not specified,
-the
+Support for
+Self-Monitoring, Analysis, and Reporting Technology (SMART) functionality
+is indicated by the device with
+.Sq SMART feature set
+in the output of the
 .Li identify
-command is implied.
+command.
+SMART commands and the
+.Li readattr
+command are for experts only.
+.Pp
+Support for
+Security Mode functionality
+is indicated by the device with
+.Sq Security Mode feature set
+in the output of the
+.Li identify
+command.
+.Em Be very careful
+while playing with these commands:
+loss of the user and master passwords for the device will result
+in an inaccessible device.
+.Pp
 A full description of the commands follows:
 .Pp
 .Bl -tag -width xxxxxxx -compact
@@ -162,6 +179,7 @@ The log buffer is cleared after extraction.
 .It Li identify
 Identify the specified device, displaying the device's vendor, product,
 revision strings, supported capabilities and enabled capabilities.
+This command is the default.
 .Pp
 .It Li idle
 Place the specified device into Idle mode.
@@ -232,27 +250,11 @@ even models, so don't rely on it.
 SMART must be enabled while executing this command or the device will return
 an error.
 .Pp
-SMART commands and
-.Li readattr
-command are for experts only.
-.Pp
 .It Li secdisablepass Ar user\*(Bamaster
 Disables the lock mode for the specified device with user or master password.
 This command won't change the master password.
 The master password will be reactivated when a user password is set.
 .Pp
-Support for the security commands is indicated by the device with
-.Sq Security Mode feature set
-in the output of the
-.Li identify
-command.
-.Pp
-.Em WARNING
-.br
-Be very careful while playing with these commands.
-Loss of the user and master passwords for the device will result
-in an inaccessible device.
-.Pp
 .It Li secerase Ar user\*(Bamaster Op Ar enhanced
 Erases all user data and unlocks the specified device.
 Execution of this command with the master password is the only way to unlock a
@@ -364,15 +366,6 @@ Enables SMART (Self-Monitoring, Analysis, and Reporting Technology) on the
 specified device (if supported).
 This causes the device to record information
 for prediction of device degradation and/or faults.
-Support for SMART is indicated by the device with
-.Sq SMART feature set
-in the output of the
-.Li identify
-command.
-.Pp
-SMART commands and
-.Li readattr
-command are for experts only.
 .Pp
 .It Li smartoffline Ar subcommand
 Causes the specified device to immediately initiate the optional set of