On Thu, Apr 06, 2017 at 08:35:02PM +0200, Anton Lindqvist wrote: > Hi, > The bioctl man-page uses the phrase "The following command, executed > from the command line, ..." in the examples section. A convention I > haven't seen before. I would argue that mentioning the command line is > redundant since it's implied by the actual examples and could therefore > be removed. > > Thoughts? >
agreed, it is needlessly chatty. i went a bit further though and committed the diff below. thanks for the mail. jmc Index: bioctl.8 =================================================================== RCS file: /cvs/src/sbin/bioctl/bioctl.8,v retrieving revision 1.103 diff -u -r1.103 bioctl.8 --- bioctl.8 27 Nov 2016 18:04:18 -0000 1.103 +++ bioctl.8 6 Apr 2017 18:54:19 -0000 @@ -279,16 +279,14 @@ This option cannot be used during the initial creation of the crypto volume. .El .Sh EXAMPLES -The following command, executed from the command line, would configure -the device softraid0 with 4 special devices -(/dev/sd2e, /dev/sd3e, /dev/sd4e, /dev/sd5e) and -a RAID level of 1: +Configure softraid0 with 4 special devices +(/dev/sd2e, /dev/sd3e, /dev/sd4e, /dev/sd5e) +and a RAID level of 1: .Bd -literal -offset 3n # bioctl -c 1 -l /dev/sd2e,/dev/sd3e,/dev/sd4e,/dev/sd5e softraid0 .Ed .Pp -The following command, executed from the command line, would configure the -device softraid0 with one special device (/dev/sd2e) and an encrypting +Configure softraid0 with one special device (/dev/sd2e) and an encrypting volume: .Bd -literal -offset 3n # bioctl -c C -l /dev/sd2e softraid0 @@ -302,8 +300,7 @@ .Xr fdisk 8 or .Xr disklabel 8 -don't get confused by the random data that appears on the new disk. -This can be done with the following command (assuming the new disk is sd3): +don't get confused by the random data that appears on the new disk: .Bd -literal -offset 3n # dd if=/dev/zero of=/dev/rsd3c bs=1m count=1 .Ed @@ -314,7 +311,7 @@ # bioctl -d sd2 .Ed .Pp -The following command starts a rebuild of the degraded softraid volume sd0 +Start a rebuild of the degraded softraid volume sd0 using a new chunk on wd0d: .Bd -literal -offset 3n # bioctl -R /dev/wd0d sd0
