usr/src/man/ai_manifest.4
changeset 1763 ca9c641c8ec7
parent 1669 5889a0b7b4d6
--- a/usr/src/man/ai_manifest.4	Mon Aug 06 10:15:40 2012 -0700
+++ b/usr/src/man/ai_manifest.4	Wed Aug 08 15:25:24 2012 -0700
@@ -1,7 +1,6 @@
 '\" te
-.\" Copyright (c) 2008, 2012, Oracle and/or its
-.\" affiliates. All rights reserved.
-.TH ai_manifest 4 "03 May 2012" "SunOS 5.11" "File Formats"
+.\" Copyright (c) 2008, 2012, Oracle and/or its affiliates. All rights reserved.
+.TH ai_manifest 4 "26 Jun 2012" "SunOS 5.11" "File Formats"
 .SH NAME
 ai_manifest \- Automated installation manifest file format
 .SH SYNOPSIS
@@ -86,7 +85,7 @@
 Complementing the AI manifest are Service Management Facility (SMF) configuration profiles. These profiles specify the system configuration for the installed system such as hostname, networking, and root and initial user account settings.
 .sp
 .LP
-For more information about install services, AI manifests, and configuration profiles, see the installadm(1M) man page and Part\ III, \fIInstalling Using an Install Server,\fR in \fIInstalling Oracle Solaris 11 Systems\fR. For information about the configuration profile file format, see \fBsmf\fR(5).
+For more information about install services, AI manifests, and configuration profiles, see the \fBinstalladm\fR(1M) man page and Part\ III, \fIInstalling Using an Install Server,\fR in \fIInstalling Oracle Solaris 11.1 Systems\fR. For information about the configuration profile file format, see \fBsmf\fR(5).
 .SH AUTOMATED INSTALLATION SETTINGS
 .sp
 .LP
@@ -97,8 +96,8 @@
 .na
 \fB\fBname\fR\fR
 .ad
-.RS 15n
-.rt  
+.sp .6
+.RS 4n
 The name of this manifest instance.
 .RE
 
@@ -108,8 +107,8 @@
 .na
 \fB\fBhttp_proxy\fR\fR
 .ad
-.RS 15n
-.rt  
+.sp .6
+.RS 4n
 The HTTP proxy to use to access remote files during the installation. Examples of remote files accessed during installation are software packages in an Image Packaging System (IPS) package repository. The value of \fBhttp_proxy\fR is an HTTP URI such as \fBhttp://myproxy.mycompany.com:8080/\fR.
 .sp
 This attribute is not applicable when installing a non-global zone and is ignored if provided.
@@ -121,8 +120,8 @@
 .na
 \fB\fBauto_reboot\fR\fR
 .ad
-.RS 15n
-.rt  
+.sp .6
+.RS 4n
 The flag that specifies whether to automatically reboot after installation. The default value of \fBauto_reboot\fR is \fBfalse\fR. When \fBauto_reboot\fR is \fBfalse\fR, the installation waits for manual intervention to reboot.
 .sp
 When \fBauto_reboot\fR is \fBtrue\fR, on a successful installation, the machine automatically reboots into the newly installed boot environment.
@@ -137,10 +136,10 @@
 .in +2
 .nf
 <auto_install>
-    <ai_instance name='default' auto_reboot='true'
-      http_proxy='http://myproxy.mycompany.com:8080/'>
-    <!-- target and software sections -->
-    </ai_instance>
+  <ai_instance name='default' auto_reboot='true'
+    http_proxy='http://myproxy.mycompany.com:8080/'>
+  <!-- target and software sections -->
+  </ai_instance>
 </auto_install>
 .fi
 .in -2
@@ -190,14 +189,69 @@
 .nf
 <!-- zero or one target element -->
 <target>
-    <!-- zero or more disk elements -->
-    <disk ...>
-    </disk>
-    <logical ...>
-        <!-- zero or more zpool elements -->
-        <zpool ...>
-        </zpool>
-    </logical>
+  <!-- zero or more disk elements -->
+  <disk ...>
+    <!-- One of the following elements:
+             disk_name
+             disk_prop
+             disk_keyword
+             iscsi
+         Zero or more of the following elements:
+             gpt_partition
+             partition
+             slice
+         gpt_partition can have zero or one size element.
+         partition can have zero or one size element
+             followed by zero or more slice elements.
+         slice can have zero or one size element.
+    -->
+  </disk>
+  <!-- zero or one logical element -->
+  <logical ...>
+    <!-- zero or more zpool elements -->
+    <zpool ...>
+      <!-- zero or more vdev elements -->
+      <vdev ...>
+      </vdev>
+      <!-- zero or more filesystem elements
+           with zero or one options element
+      -->
+      <filesystem>
+        <options>
+          <option .../>
+        </options>
+      <!-- zero or more zvol elements
+           with zero or one options element
+           and one size element
+      -->
+      <zvol ...>
+        <options>
+          <option .../>
+        </options>
+        <size val="..."/>
+      </zvol>
+      <!-- zero or one pool_options element
+           with one or more option elements
+      -->
+      <pool_options>
+        <option .../>
+      </pool_options>
+      <!-- zero or one dataset_options element
+           with one or more option elements
+      -->
+      <dataset_options>
+        <option .../>
+      </dataset_options>
+      <!-- zero or one be element
+           with zero or one options elements
+      -->
+      <be>
+        <options>
+          <option .../>
+        </options>
+      </be>
+    </zpool>
+  </logical>
 </target>
 .fi
 .in -2
@@ -328,8 +382,8 @@
 .na
 \fB\fBname\fR\fR
 .ad
-.RS 13n
-.rt  
+.sp .6
+.RS 4n
 The \fBname\fR attribute specifies the name of the target device.
 .RE
 
@@ -339,8 +393,8 @@
 .na
 \fB\fBname_type\fR\fR
 .ad
-.RS 13n
-.rt  
+.sp .6
+.RS 4n
 The \fBname_type\fR attribute specifies the type of the target device name. The \fBname_type\fR attribute can have one of the following values:
 .sp
 .ne 2
@@ -427,7 +481,7 @@
 .ad
 .sp .6
 .RS 4n
-This is the receptacle value from a CRO (Chassis, Receptacle, Occupant) configuration as found in the output from the \fBcroinfo\fR(1M) command with the \fB-o cR\fR option.
+This is the receptacle value from a CRO (Chassis, Receptacle, Occupant) configuration as found in the output from the \fBcroinfo\fR(1M) command with the \fB-ocR\fR option.
 .sp
 .in +2
 .nf
@@ -449,8 +503,8 @@
 .na
 \fB\fBsource\fR\fR
 .ad
-.RS 23n
-.rt  
+.sp .6
+.RS 4n
 The \fBsource\fR attribute specifies the source of the iSCSI configuration data. The \fBsource\fR attribute can have the following values:
 .sp
 .ne 2
@@ -493,8 +547,8 @@
 .na
 \fB\fBtarget_ip\fR\fR
 .ad
-.RS 23n
-.rt  
+.sp .6
+.RS 4n
 The value of this attribute is the IP address of the iSCSI target. The target at this IP address must be online and accessible from this system. This attribute is required.
 .sp
 .in +2
@@ -511,8 +565,8 @@
 .na
 \fB\fBtarget_lun\fR\fR
 .ad
-.RS 23n
-.rt  
+.sp .6
+.RS 4n
 If an iSCSI target provides more than one LUN, specify which LUN to use by specifying an integer value for \fBtarget_lun\fR. LUN numbers are indexed from 0. To specify the first LUN, specify a \fBtarget_lun\fR value of 0.
 .sp
 If only one LUN is provided, this attribute can be omitted. If more than one LUN is provided by the iSCSI target, then this attribute is required.
@@ -524,8 +578,8 @@
 .na
 \fB\fBtarget_name\fR\fR
 .ad
-.RS 23n
-.rt  
+.sp .6
+.RS 4n
 The \fBtarget_name\fR attribute specifies the iSCSI Qualified Name (IQN) or the Extended Unique Identifier (EUI) of the iSCSI target, as shown in the following example:
 .sp
 .in +2
@@ -542,8 +596,8 @@
 .na
 \fB\fBtarget_port\fR\fR
 .ad
-.RS 23n
-.rt  
+.sp .6
+.RS 4n
 If not specified, the default \fBtarget_port\fR of 3260 (the iSCSI standard port) is used. This attribute enables you to specify an alternative port number.
 .RE
 
@@ -553,8 +607,8 @@
 .na
 \fB\fBinitiator_name\fR\fR
 .ad
-.RS 23n
-.rt  
+.sp .6
+.RS 4n
 The \fBinitiator_name\fR attribute specifies the IQN or the EUI of the iSCSI initiator.
 .RE
 
@@ -564,8 +618,8 @@
 .na
 \fBCHAP authentication\fR
 .ad
-.RS 23n
-.rt  
+.sp .6
+.RS 4n
 The following two attributes provide CHAP (Challenge-Handshake Authentication Protocol) authentication:
 .sp
 .ne 2
@@ -573,8 +627,8 @@
 .na
 \fB\fBchap_name\fR\fR
 .ad
-.RS 17n
-.rt  
+.sp .6
+.RS 4n
 The \fBchap_name\fR attribute specifies the CHAP username to be used for authentication.
 .RE
 
@@ -584,12 +638,12 @@
 .na
 \fB\fBchap_password\fR\fR
 .ad
-.RS 17n
-.rt  
+.sp .6
+.RS 4n
 The \fBchap_password\fR attribute specifies the CHAP password to be used for authentication.
 .RE
 
-SPARC clients can optionally set \fBchap-user\fR and \fBchap-password\fR at the Open Boot PROM (\fBok\fR) prompt. For more information, see "iSCSI Boot" in \fBboot\fR(1M).
+SPARC clients can optionally set \fBchap-user\fR and \fBchap-password\fR at the Open Boot PROM (\fBok\fR) prompt. For more information, see "iSCSI Boot" in the \fBboot\fR(1M) man page.
 .RE
 
 .sp
@@ -604,6 +658,9 @@
 .sp
 .LP
 Given this information, the iSCSI device is made available for installation.
+.sp
+.LP
+Because the network interface for the iSCSI device is configured early in the client boot process, you do not need to configure the \fBnetwork/install\fR service for this interface in any system configuration profile file for this installation.
 .SS "Target Device Properties"
 .sp
 .LP
@@ -648,7 +705,7 @@
 .ad
 .sp .6
 .RS 4n
-The chassis value from a CRO (Chassis, Receptacle, Occupant) configuration as found in the output from the \fBcroinfo\fR(1M) command with the \fB-o cA\fR option.
+The chassis value from a CRO (Chassis, Receptacle, Occupant) configuration as found in the output from the \fBcroinfo\fR(1M) command with the \fB-ocA\fR option.
 .sp
 .in +2
 .nf
@@ -716,8 +773,8 @@
 .na
 \fB\fBwhole_disk\fR\fR
 .ad
-.RS 14n
-.rt  
+.sp .6
+.RS 4n
 The default value of this attribute is \fBfalse\fR. When \fBwhole_disk\fR is \fBfalse\fR, partitions or slices must be defined. Any existing partitions or slices are retained unless you remove them by specifying the \fBdelete\fR value for the \fBaction\fR attribute of the partition or slice.
 .sp
 When \fBwhole_disk\fR is \fBtrue\fR, any existing partitions or slices are removed.
@@ -740,8 +797,8 @@
 .na
 \fB\fBin_zpool\fR\fR
 .ad
-.RS 14n
-.rt  
+.sp .6
+.RS 4n
 The \fBin_zpool\fR attribute links this disk to a ZFS pool defined in the \fBlogical\fR section of the AI manifest. The value of the \fBin_zpool\fR attribute must match the value of the \fBname\fR attribute of the corresponding \fBzpool\fR element.
 .sp
 If the \fBin_zpool\fR attribute is specified here, then do not specify \fBin_zpool\fR for any subordinate partitions or slices.
@@ -753,8 +810,8 @@
 .na
 \fB\fBin_vdev\fR\fR
 .ad
-.RS 14n
-.rt  
+.sp .6
+.RS 4n
 The \fBin_vdev\fR attribute links this disk to a virtual device defined in the \fBlogical\fR section of the AI manifest. The value of the \fBin_vdev\fR attribute must match the value of the \fBname\fR attribute of the corresponding \fBvdev\fR element.
 .sp
 If the \fBin_vdev\fR attribute is specified here, then do not specify \fBin_vdev\fR for any subordinate partitions or slices.
@@ -770,8 +827,8 @@
 .na
 \fB\fBname\fR\fR
 .ad
-.RS 13n
-.rt  
+.sp .6
+.RS 4n
 The \fBname\fR attribute is the GPT partition number. Values 0-7 are valid for Oracle Solaris.
 .sp
 The \fBname\fR attribute is required.
@@ -783,8 +840,8 @@
 .na
 \fB\fBaction\fR\fR
 .ad
-.RS 13n
-.rt  
+.sp .6
+.RS 4n
 The \fBaction\fR attribute can have the following values:
 .sp
 .ne 2
@@ -827,8 +884,8 @@
 .na
 \fB\fBpart_type\fR\fR
 .ad
-.RS 13n
-.rt  
+.sp .6
+.RS 4n
 The \fBpart_type\fR attribute specifies the GUID partition type. The value can be a supported GUID alias, such as \fBsolaris\fR, or an explicit GUID hexadecimal string value.
 .sp
 The \fBpart_type\fR attribute is required.
@@ -840,8 +897,8 @@
 .na
 \fB\fBin_zpool\fR\fR
 .ad
-.RS 13n
-.rt  
+.sp .6
+.RS 4n
 The \fBin_zpool\fR attribute links this partition to a ZFS pool defined in the \fBlogical\fR section of the AI manifest. The value of the \fBin_zpool\fR attribute must match the value of the \fBname\fR attribute of the corresponding \fBzpool\fR element.
 .sp
 If the \fBin_zpool\fR attribute is specified, then do not specify \fBin_zpool\fR for the associated \fBdisk\fR element or any subordinate \fBslice\fR elements.
@@ -853,8 +910,8 @@
 .na
 \fB\fBin_vdev\fR\fR
 .ad
-.RS 13n
-.rt  
+.sp .6
+.RS 4n
 The \fBin_vdev\fR attribute links this partition to a virtual device defined in the \fBlogical\fR section of the AI manifest. The value of the \fBin_vdev\fR attribute must match the value of the \fBname\fR attribute of the corresponding \fBvdev\fR element.
 .sp
 If the \fBin_vdev\fR attribute is specified, then do not specify \fBin_vdev\fR for the associated \fBdisk\fR element or any subordinate \fBslice\fR elements.
@@ -862,7 +919,7 @@
 
 .sp
 .LP
-GPT partitions can have a \fBsize\fR sub-element to specify the size of the partition. See the beginning of the "Disk Layout" section for details about how to use the \fBsize\fR element.
+GPT partitions can have a \fBsize\fR sub-element to specify the size of the partition. See the beginning of the "Disk Layout" section for details about how to use the \fBsize\fR element. If you specify a size for the partition, the \fBsize\fR sub-element must precede any \fBslice\fR sub-element in the \fBpartition\fR element.
 .SS "Legacy Partitions"
 .sp
 .LP
@@ -873,8 +930,8 @@
 .na
 \fB\fBname\fR\fR
 .ad
-.RS 13n
-.rt  
+.sp .6
+.RS 4n
 The \fBname\fR attribute is the \fBfdisk\fR partition number. Values 1, 2, 3, and 4 are primary partitions. If one of the primary partitions is an extended partition, values 5 through 32 can be specified for logical partitions.
 .sp
 The \fBname\fR attribute is required unless the specified \fBaction\fR is \fBuse_existing_solaris2\fR.
@@ -886,8 +943,8 @@
 .na
 \fB\fBaction\fR\fR
 .ad
-.RS 13n
-.rt  
+.sp .6
+.RS 4n
 The \fBaction\fR attribute can have the following values:
 .sp
 .ne 2
@@ -943,9 +1000,9 @@
 .na
 \fB\fBpart_type\fR\fR
 .ad
-.RS 13n
-.rt  
-The \fBpart_type\fR is the \fBfdisk\fR partition type. The default value is 191, which is the partition type for a Solaris2 partition. See the \fBfdisk\fR(1M) command for more information about possible partition types.
+.sp .6
+.RS 4n
+The \fBpart_type\fR is the \fBfdisk\fR partition type. The default value is 191, which is the partition type for a Solaris2 partition. See the \fBfdisk\fR(1M) man page for more information about possible partition types.
 .RE
 
 .sp
@@ -954,8 +1011,8 @@
 .na
 \fB\fBin_zpool\fR\fR
 .ad
-.RS 13n
-.rt  
+.sp .6
+.RS 4n
 The \fBin_zpool\fR attribute links this partition to a ZFS pool defined in the \fBlogical\fR section of the AI manifest. The value of the \fBin_zpool\fR attribute must match the value of the \fBname\fR attribute of the corresponding \fBzpool\fR element.
 .sp
 If the \fBin_zpool\fR attribute is specified, then do not specify \fBin_zpool\fR for the associated \fBdisk\fR element or any subordinate \fBslice\fR elements.
@@ -967,8 +1024,8 @@
 .na
 \fB\fBin_vdev\fR\fR
 .ad
-.RS 13n
-.rt  
+.sp .6
+.RS 4n
 The \fBin_vdev\fR attribute links this partition to a virtual device defined in the \fBlogical\fR section of the AI manifest. The value of the \fBin_vdev\fR attribute must match the value of the \fBname\fR attribute of the corresponding \fBvdev\fR element.
 .sp
 If the \fBin_vdev\fR attribute is specified, then do not specify \fBin_vdev\fR for the associated \fBdisk\fR element or any subordinate \fBslice\fR elements.
@@ -976,7 +1033,7 @@
 
 .sp
 .LP
-Partitions can have a \fBsize\fR sub-element to specify the size of the partition. See the beginning of the "Disk Layout" section for details about how to use the \fBsize\fR element.
+Partitions can have a \fBsize\fR sub-element to specify the size of the partition. See the beginning of the "Disk Layout" section for details about how to use the \fBsize\fR element. If you specify a size for the partition, the \fBsize\fR sub-element must precede any \fBslice\fR sub-element in the \fBpartition\fR element.
 .sp
 .LP
 The following example creates a 10 GB Solaris2 partition using default attribute values:
@@ -984,10 +1041,10 @@
 .in +2
 .nf
 <disk>
-    <disk_name name="c0t0d0" name_type="ctd"/>
-    <partition name="1">
-        <size val="10gb"/>
-    </partition>
+  <disk_name name="c0t0d0" name_type="ctd"/>
+  <partition name="1">
+    <size val="10gb"/>
+  </partition>
 </disk>
 .fi
 .in -2
@@ -1011,8 +1068,8 @@
 .na
 \fB\fBname\fR\fR
 .ad
-.RS 12n
-.rt  
+.sp .6
+.RS 4n
 The \fBname\fR attribute is the slice number. The value can be 0 through 7.
 .RE
 
@@ -1022,8 +1079,8 @@
 .na
 \fB\fBaction\fR\fR
 .ad
-.RS 12n
-.rt  
+.sp .6
+.RS 4n
 The \fBaction\fR attribute can have the following values:
 .sp
 .ne 2
@@ -1031,8 +1088,8 @@
 .na
 \fB\fBcreate\fR\fR
 .ad
-.RS 12n
-.rt  
+.sp .6
+.RS 4n
 This is the default action for a slice. The \fBcreate\fR action tells the installer to create a slice with the specified name. If a slice with the same name already exists, that existing slice is deleted first.
 .RE
 
@@ -1042,8 +1099,8 @@
 .na
 \fB\fBdelete\fR\fR
 .ad
-.RS 12n
-.rt  
+.sp .6
+.RS 4n
 The \fBdelete\fR action tells the installer to delete the named slice. If the named slice does not exist, the \fBdelete\fR action is skipped and a warning message is output.
 .RE
 
@@ -1053,8 +1110,8 @@
 .na
 \fB\fBpreserve\fR\fR
 .ad
-.RS 12n
-.rt  
+.sp .6
+.RS 4n
 The \fBpreserve\fR action tells the installer to leave the named slice untouched. This action is commonly used when data exists from a previous installation.
 .RE
 
@@ -1066,8 +1123,8 @@
 .na
 \fB\fBis_swap\fR\fR
 .ad
-.RS 12n
-.rt  
+.sp .6
+.RS 4n
 The default value of this attribute is \fBfalse\fR. When \fBis_swap\fR is \fBfalse\fR, the installer creates a swap volume in the root pool.
 .sp
 When \fBis_swap\fR is \fBtrue\fR, the named slice is used as a swap device. When \fBis_swap\fR is \fBtrue\fR, do not use the \fBin_zpool\fR or \fBin_vdev\fR attributes.
@@ -1079,8 +1136,8 @@
 .na
 \fB\fBforce\fR\fR
 .ad
-.RS 12n
-.rt  
+.sp .6
+.RS 4n
 The default value of this attribute is \fBfalse\fR.
 .sp
 When \fBforce\fR is \fBtrue\fR, the installer ignores any existing slice that might already be in use (for example, a slice that is used in an existing ZFS storage pool) and continues to perform the specified action on the named slice.
@@ -1092,8 +1149,8 @@
 .na
 \fB\fBin_zpool\fR\fR
 .ad
-.RS 12n
-.rt  
+.sp .6
+.RS 4n
 The \fBin_zpool\fR attribute links this slice to a ZFS pool defined in the \fBlogical\fR section of the AI manifest. The value of the \fBin_zpool\fR attribute must match the value of the \fBname\fR attribute of the corresponding \fBzpool\fR element.
 .sp
 If the \fBin_zpool\fR attribute is specified, then do not specify \fBin_zpool\fR for the associated \fBpartition\fR or \fBdisk\fR elements.
@@ -1105,8 +1162,8 @@
 .na
 \fB\fBin_vdev\fR\fR
 .ad
-.RS 12n
-.rt  
+.sp .6
+.RS 4n
 The \fBin_vdev\fR attribute links this slice to a virtual device defined in the \fBlogical\fR section of the AI manifest. The value of the \fBin_vdev\fR attribute must match the value of the \fBname\fR attribute of the corresponding \fBvdev\fR element.
 .sp
 If the \fBin_vdev\fR attribute is specified, then do not specify \fBin_vdev\fR for the associated \fBpartition\fR or \fBdisk\fR elements.
@@ -1122,13 +1179,13 @@
 .in +2
 .nf
 <disk>
-    <disk_name name="c0t0d0" name_type="ctd"/>
-    <slice name="0">
-        <size val="20gb"/>
-    </slice>
-    <slice name="1" is_swap="true">
-        <size val="4gb"/>
-    </slice>
+  <disk_name name="c0t0d0" name_type="ctd"/>
+  <slice name="0">
+    <size val="20gb"/>
+  </slice>
+  <slice name="1" is_swap="true">
+    <size val="4gb"/>
+  </slice>
 </disk>
 .fi
 .in -2
@@ -1140,15 +1197,15 @@
 .in +2
 .nf
 <disk>
-    <disk_name name="c0t0d0" name_type="ctd"/>
-    <partition name="1">
-        <slice name="0">
-            <size val="20gb"/>
-        </slice>
-        <slice name="1" is_swap="true">
-            <size val="4gb"/>
-        </slice>
-    </partition>
+  <disk_name name="c0t0d0" name_type="ctd"/>
+  <partition name="1">
+    <slice name="0">
+      <size val="20gb"/>
+    </slice>
+    <slice name="1" is_swap="true">
+      <size val="4gb"/>
+    </slice>
+  </partition>
 </disk>
 .fi
 .in -2
@@ -1175,8 +1232,8 @@
 .na
 \fB\fBnoswap\fR\fR
 .ad
-.RS 10n
-.rt  
+.sp .6
+.RS 4n
 The default value of this attribute is \fBfalse\fR. When \fBnoswap\fR is \fBfalse\fR, if space allows, the installer automatically creates a swap volume in the root pool.
 .sp
 When \fBnoswap\fR is \fBtrue\fR, no swap volume is automatically created.
@@ -1188,8 +1245,8 @@
 .na
 \fB\fBnodump\fR\fR
 .ad
-.RS 10n
-.rt  
+.sp .6
+.RS 4n
 The default value of this attribute is \fBfalse\fR. When \fBnodump\fR is \fBfalse\fR, if space allows, the installer automatically creates a dump volume in the root pool.
 .sp
 When \fBnodump\fR is \fBtrue\fR, no dump volume is automatically created.
@@ -1217,8 +1274,8 @@
 .na
 \fB\fBname\fR\fR
 .ad
-.RS 14n
-.rt  
+.sp .6
+.RS 4n
 This is the name of the new pool. This value must be a name that can be passed to the \fBzpool create\fR command.
 .sp
 This name could be used as the value of an \fBin_zpool\fR attribute of a \fBdisk\fR, \fBgpt_partition\fR, \fBpartition\fR, or \fBslice\fR element to define that disk, GPT partition, \fBfdisk\fR partition, or slice as a constituent device in the \fBzpool\fR.
@@ -1230,8 +1287,8 @@
 .na
 \fB\fBaction\fR\fR
 .ad
-.RS 14n
-.rt  
+.sp .6
+.RS 4n
 The \fBaction\fR attribute can have the following values:
 .sp
 .ne 2
@@ -1306,8 +1363,8 @@
 .na
 \fB\fBis_root\fR\fR
 .ad
-.RS 14n
-.rt  
+.sp .6
+.RS 4n
 The default value of this attribute is \fBfalse\fR. When \fBis_root\fR is \fBfalse\fR, a data pool is defined.
 .sp
 When \fBis_root\fR is \fBtrue\fR, the new boot environment is created in the named pool.
@@ -1319,8 +1376,8 @@
 .na
 \fB\fBmountpoint\fR\fR
 .ad
-.RS 14n
-.rt  
+.sp .6
+.RS 4n
 The \fBmountpoint\fR attribute specifies the mount point of the top level file system of the pool. The default mount point is \fB/\fIpoolname\fR\fR. The mount point must be an absolute path.
 .RE
 
@@ -1331,16 +1388,16 @@
 .in +2
 .nf
 <logical>
-    <zpool name="rpool" is_root="true">
-        <pool_options>
-            <option name="listsnaps" value="on"/>
-            <option name="delegation" value="off"/>
-        </pool_options>
-        <dataset_options>
-            <option name="atime" value="on"/>
-            <option name="compression" value="on"/>
-        </dataset_options>
-    </zpool>
+  <zpool name="rpool" is_root="true">
+    <pool_options>
+      <option name="listsnaps" value="on"/>
+      <option name="delegation" value="off"/>
+    </pool_options>
+    <dataset_options>
+      <option name="atime" value="on"/>
+      <option name="compression" value="on"/>
+    </dataset_options>
+  </zpool>
 </logical>
 .fi
 .in -2
@@ -1370,8 +1427,8 @@
 .na
 \fB\fBname\fR\fR
 .ad
-.RS 14n
-.rt  
+.sp .6
+.RS 4n
 This is the name of the new \fBvdev\fR.
 .sp
 This name should be used as the value of an \fBin_vdev\fR attribute of a \fBdisk\fR, \fBgpt_partition\fR, \fBpartition\fR, or \fBslice\fR element to define that disk, partition (GPT or \fBfdisk\fR), or slice as a constituent device in the \fBvdev\fR
@@ -1383,8 +1440,8 @@
 .na
 \fB\fBredundancy\fR\fR
 .ad
-.RS 14n
-.rt  
+.sp .6
+.RS 4n
 The \fBredundancy\fR attribute can have the following values:
 .sp
 .ne 2
@@ -1401,7 +1458,7 @@
 .ne 2
 .mk
 .na
-\fB\fBraidz\fR, \fBraidz1\fR,  \fBraidz2\fR, \fBraidz3\fR\fR
+\fB\fBraidz\fR, \fBraidz1\fR, \fBraidz2\fR, \fBraidz3\fR\fR
 .ad
 .sp .6
 .RS 4n
@@ -1474,15 +1531,15 @@
 .in +2
 .nf
 <disk whole_disk="true" in_zpool="rpool" in_vdev="mirrored">
-    <disk_name name="c0t0d0" name_type="ctd"/>
+  <disk_name name="c0t0d0" name_type="ctd"/>
 </disk>
 <disk whole_disk="true" in_zpool="rpool" in_vdev="mirrored">
-    <disk_name name="c1t0d0" name_type="ctd"/>
+  <disk_name name="c1t0d0" name_type="ctd"/>
 </disk>
 <logical>
-    <zpool name="rpool" is_root="true">
-        <vdev name="mirrored" redundancy="mirror"/>
-    </zpool>
+  <zpool name="rpool" is_root="true">
+    <vdev name="mirrored" redundancy="mirror"/>
+  </zpool>
 </logical>
 .fi
 .in -2
@@ -1503,8 +1560,8 @@
 .na
 \fB\fBname\fR\fR
 .ad
-.RS 14n
-.rt  
+.sp .6
+.RS 4n
 This is the name of the new \fBfilesystem\fR, relative to the \fBzpool\fR. For example, if the \fBfilesystem\fR is named \fBexport\fR within a \fBzpool\fR named \fBrpool\fR, the ZFS dataset name is \fBrpool/export\fR.
 .sp
 If the \fBin_be\fR attribute of the \fBfilesystem\fR is set to \fBtrue\fR, this name is relative to the root dataset of the boot environment.
@@ -1516,8 +1573,8 @@
 .na
 \fB\fBaction\fR\fR
 .ad
-.RS 14n
-.rt  
+.sp .6
+.RS 4n
 The \fBaction\fR attribute can have the following values:
 .sp
 .ne 2
@@ -1525,8 +1582,8 @@
 .na
 \fB\fBcreate\fR\fR
 .ad
-.RS 12n
-.rt  
+.sp .6
+.RS 4n
 This is the default action for a \fBfilesystem\fR. The \fBcreate\fR action tells the installer to create a file system with the specified name.
 .RE
 
@@ -1536,8 +1593,8 @@
 .na
 \fB\fBdelete\fR\fR
 .ad
-.RS 12n
-.rt  
+.sp .6
+.RS 4n
 The \fBdelete\fR action tells the installer to delete the named file system.
 .RE
 
@@ -1547,8 +1604,8 @@
 .na
 \fB\fBpreserve\fR\fR
 .ad
-.RS 12n
-.rt  
+.sp .6
+.RS 4n
 The \fBpreserve\fR action tells the installer to leave the named file system unmodified. If \fBpreserve\fR is specified for the \fBfilesystem\fR, then \fBpreserve\fR should be specified for the associated \fBzpool\fR.
 .RE
 
@@ -1560,8 +1617,8 @@
 .na
 \fB\fBmountpoint\fR\fR
 .ad
-.RS 14n
-.rt  
+.sp .6
+.RS 4n
 The \fBmountpoint\fR attribute specifies the mount point of the new file system. If a mount point is not specified, the file system inherits the mount point from its parent.
 .RE
 
@@ -1571,8 +1628,8 @@
 .na
 \fB\fBin_be\fR\fR
 .ad
-.RS 14n
-.rt  
+.sp .6
+.RS 4n
 The default value of this attribute is \fBfalse\fR. When \fBin_be\fR is \fBfalse\fR, the new dataset is shared among all boot environments.
 .sp
 When \fBin_be\fR is \fBtrue\fR, a separate copy of this new dataset is created within each boot environment. When \fBin_be\fR is \fBtrue\fR, the value of the \fBname\fR attribute is relative to the root dataset of the boot environment.
@@ -1585,14 +1642,14 @@
 .in +2
 .nf
 <logical>
-    <zpool name="rpool" is_root="true">
-        <filesystem name="export">
-            <options>
-                <option name="compression" value="off"/>
-                <option name="dedup" value="on"/>
-            <options>
-        </filesystem>
-    </zpool>
+  <zpool name="rpool" is_root="true">
+    <filesystem name="export">
+      <options>
+        <option name="compression" value="off"/>
+        <option name="dedup" value="on"/>
+      <options>
+    </filesystem>
+  </zpool>
 </logical>
 .fi
 .in -2
@@ -1613,8 +1670,8 @@
 .na
 \fB\fBname\fR\fR
 .ad
-.RS 10n
-.rt  
+.sp .6
+.RS 4n
 This is the name of the new ZFS volume.
 .RE
 
@@ -1624,8 +1681,8 @@
 .na
 \fB\fBaction\fR\fR
 .ad
-.RS 10n
-.rt  
+.sp .6
+.RS 4n
 The \fBaction\fR attribute can have the following values:
 .sp
 .ne 2
@@ -1633,8 +1690,8 @@
 .na
 \fB\fBcreate\fR\fR
 .ad
-.RS 16n
-.rt  
+.sp .6
+.RS 4n
 This is the default action for a \fBzvol\fR. The \fBcreate\fR action tells the installer to create a ZFS volume with the specified name.
 .RE
 
@@ -1644,8 +1701,8 @@
 .na
 \fB\fBdelete\fR\fR
 .ad
-.RS 16n
-.rt  
+.sp .6
+.RS 4n
 The \fBdelete\fR action tells the installer to delete the named volume.
 .RE
 
@@ -1655,8 +1712,8 @@
 .na
 \fB\fBpreserve\fR\fR
 .ad
-.RS 16n
-.rt  
+.sp .6
+.RS 4n
 The \fBpreserve\fR action tells the installer to leave the named \fBzvol\fR unmodified. If \fBpreserve\fR is specified for the \fBzvol\fR, then \fBpreserve\fR should be specified for the associated \fBzpool\fR.
 .RE
 
@@ -1666,9 +1723,9 @@
 .na
 \fB\fBuse_existing\fR\fR
 .ad
-.RS 16n
-.rt  
-If this value is specified for a swap or dump device, the existing volume is re-used. If \fBuse_existing\fR is specified for the \fBzvol\fR, then \fBpreserve\fR should be specified for the associated \fBzpool\fR.
+.sp .6
+.RS 4n
+If this value is specified for a swap or dump device, the existing volume is reused. If \fBuse_existing\fR is specified for the \fBzvol\fR, then \fBpreserve\fR should be specified for the associated \fBzpool\fR.
 .RE
 
 .RE
@@ -1679,8 +1736,8 @@
 .na
 \fB\fBuse\fR\fR
 .ad
-.RS 10n
-.rt  
+.sp .6
+.RS 4n
 The \fBuse\fR attribute can have the following values:
 .sp
 .ne 2
@@ -1688,8 +1745,8 @@
 .na
 \fB\fBnone\fR\fR
 .ad
-.RS 8n
-.rt  
+.sp .6
+.RS 4n
 This is the default value. When \fBuse\fR is \fBnone\fR, the \fBzvol\fR is created but not used during the installation.
 .RE
 
@@ -1699,8 +1756,8 @@
 .na
 \fB\fBswap\fR\fR
 .ad
-.RS 8n
-.rt  
+.sp .6
+.RS 4n
 When \fBuse\fR is \fBswap\fR, the \fBzvol\fR is created and used as a swap device. The \fBzvol\fR is also used as a swap device during the installation. The \fBsize\fR sub-element of the \fBzvol\fR element can have the value \fBmax\fR. When the \fBmax\fR keyword is specified, the size of the volume will be 90% of the free space on the pool on which the volume is created. Only one volume on a pool can specify a size of \fBmax\fR.
 .RE
 
@@ -1710,8 +1767,8 @@
 .na
 \fB\fBdump\fR\fR
 .ad
-.RS 8n
-.rt  
+.sp .6
+.RS 4n
 When \fBuse\fR is \fBdump\fR, the \fBzvol\fR is created and used as a dump device. The \fBzvol\fR is also used as a dump device during the installation.
 .RE
 
@@ -1719,7 +1776,7 @@
 
 .sp
 .LP
-Use the \fBsize\fR sub-element to specify the size of the \fBzvol\fR. See the beginning of the "Disk Layout" section for details about how to use the \fBsize\fR element.
+Use the \fBsize\fR sub-element to specify the size of the volume. See the beginning of the "Disk Layout" section for details about how to use the \fBsize\fR element. If you specify a size for the volume, the \fBsize\fR sub-element must follow any \fBoptions\fR sub-element in the \fBzvol\fR element, as shown in the example below.
 .sp
 .LP
 Use the \fBoptions\fR sub-element to set ZFS volume options on a \fBzvol\fR. Use of the \fBoptions\fR element for a \fBzvol\fR is similar to the use of the \fBdataset_options\fR element for a \fBzpool\fR, as shown in the following example:
@@ -1727,13 +1784,14 @@
 .in +2
 .nf
 <logical>
-    <zpool name="rpool" is_root="true">
-        <zvol name="swap">
-            <options>
-                <option name="compression" value="off"/>
-            <options>
-        </zvol>
-    </zpool>
+  <zpool name="rpool" is_root="true">
+    <zvol name="swap">
+      <options>
+        <option name="compression" value="off"/>
+      <options>
+      <size val="8gb"/>
+    </zvol>
+  </zpool>
 </logical>
 .fi
 .in -2
@@ -1766,14 +1824,14 @@
 .in +2
 .nf
 <logical>
-    <zpool name="rpool" is_root="true">
-        <be name="installed_be">
-            <options>
-                <option name="compression" value="on"/>
-                <option name="dedup" value="on"/>
-            <options>
-        </be>
-    </zpool>
+  <zpool name="rpool" is_root="true">
+    <be name="installed_be">
+      <options>
+        <option name="compression" value="on"/>
+        <option name="dedup" value="on"/>
+      <options>
+    </be>
+  </zpool>
 </logical>
 .fi
 .in -2
@@ -1878,30 +1936,31 @@
 .nf
 <!-- one or more software elements -->
 <software>
-    <!-- zero or one destination element
-         This element is only used when type is IPS or P5I.
+  <!-- zero or one destination element
+       Only used when type is IPS or P5I.
+  -->
+  <destination>
+    <!-- image properties and
+         optional software components
     -->
-    <destination>
-        <!-- image properties and
-             optional software components
+  </destination>
+  <!-- zero or one source element -->
+  <source>
+    <!-- one or more publisher or dir elements
+         IPS, P5I, and SVR4 types:
+             one or more publisher/origin elements
+         CPIO types: one or more dir elements
         -->
-    </destination>
-    <!-- zero or one source element -->
-    <source>
-        <!-- one or more publisher or dir elements
-             IPS, P5I, and SVR4 types:
-                 one or more publisher/origin elements
-             CPIO types: one or more dir elements
-        -->
-    </source>
-    <!-- zero or more software_data elements
-         At least one software_data element must have an
-             action of install.
-         P5I type: zero software_data elements
-    -->
-    <software_data>
-        <!-- one or more name elements -->
-    </software_data>
+  </source>
+  <!-- zero or more software_data elements
+       At least one software_data element must have
+           an action of install.
+       P5I type: zero software_data elements
+  -->
+  <software_data>
+    <!-- one or more name elements -->
+    <name>...</name>
+  </software_data>
 </software>
 .fi
 .in -2
@@ -1912,13 +1971,16 @@
 The default installation type if the \fBtype\fR attribute is not specified is \fBIPS\fR.
 .sp
 .LP
-Use the \fBsource\fR element to specify which publishers to use for installing the packages. Multiple publishers can be specified in one \fBsource\fR element. Each publisher must have at least one origin. Each publisher can have multiple origins and mirrors.
+Use the \fBsource\fR element to specify which publishers to use for installing the packages. In the \fBpublisher\fR element, the \fBname\fR attribute is required, and at least one \fBorigin\fR sub-element is required.
+.sp
+.LP
+Multiple publishers can be specified in one \fBsource\fR element. Each publisher must have at least one origin. Each publisher can have multiple origins and mirrors.
 .sp
 .LP
 The order in which publishers are defined in the AI manifest is the order in which the publishers are searched for IPS packages to install and the order in which the publishers are set in the installed image.
 .sp
 .LP
-When installing a non-global zone, the system repository is used by the zone. Any publishers specified in the AI manifest are added in the order in which they appear in the AI manifest, after the publishers provided by the system repository. See \fBpkg\fR(1) and \fBpkg.sysrepo\fR(1m) for more information about the system repository.
+When installing a non-global zone, the system repository is used by the zone. Any publishers specified in the AI manifest are added in the order in which they appear in the AI manifest, after the publishers provided by the system repository. See the \fBpkg\fR(1) and \fBpkg.sysrepo\fR(1M) man pages for more information about the system repository.
 .sp
 .LP
 The following example specifies multiple publishers, one of which has a mirror as well as an origin:
@@ -1941,17 +2003,19 @@
 
 .sp
 .LP
-Use the \fBsoftware_data\fR element to specify packages to install or uninstall. The \fBaction\fR attribute can have one of the following values:
+Use the \fBsoftware_data\fR element to specify packages to install, reject, avoid, unavoid, or uninstall. The \fBaction\fR attribute of the \fBsoftware_data\fR element can have one of the following values:
 .sp
 .ne 2
 .mk
 .na
 \fB\fBinstall\fR\fR
 .ad
-.RS 13n
-.rt  
+.sp .6
+.RS 4n
 Installs the IPS packages specified in the \fBname\fR sub-elements. This is the default if the \fBaction\fR attribute is not specified. At least one \fBsoftware_data\fR element must have an \fBaction\fR of \fBinstall\fR.
 .sp
+By default, the newest version of a named package available from the specified sources and compatible with other packages in the image is installed. To install other versions of a package, use the version string in the package FMRI. For example, \fBpkg:/[email protected]\fR is more precise than \fBpkg:/mypkg\fR. If the specified version is not compatible with other packages in the image, the installation fails. If the specified version is not available from any of the specified sources, the installation fails. Use the keyword \fBlatest\fR (for example, \fBpkg:/mypkg@latest\fR) to install the newest version available from the specified sources that is compatible with other packages in the image.
+.sp
 Packages specified in \fBname\fR sub-elements might install other packages that are not explicitly named. If one of those packages is a package that you do not want to install, you can specify the name of the package that you do not want to install in a \fBreject\fR sub-element.
 .sp
 The \fBreject\fR sub-element only applies to the \fBinstall\fR section in which the \fBreject\fR sub-element appears. If a package is the value of a \fBreject\fR sub-element in one \fBinstall\fR section, but is only installed in a different \fBinstall\fR section, then the package is installed and not rejected.
@@ -1965,8 +2029,8 @@
 .na
 \fB\fBavoid\fR\fR
 .ad
-.RS 13n
-.rt  
+.sp .6
+.RS 4n
 Adds the IPS packages in the \fBname\fR sub-elements to the avoid list.
 .sp
 Packages on the avoid list are not installed if they are the target of a group dependency.
@@ -1982,8 +2046,8 @@
 .na
 \fB\fBunavoid\fR\fR
 .ad
-.RS 13n
-.rt  
+.sp .6
+.RS 4n
 Removes the IPS packages in the \fBname\fR sub-elements from the avoid list.
 .RE
 
@@ -1993,8 +2057,8 @@
 .na
 \fB\fBuninstall\fR\fR
 .ad
-.RS 13n
-.rt  
+.sp .6
+.RS 4n
 Removes the IPS packages specified in the \fBname\fR sub-elements. Uninstalled packages that are the target of group dependencies are placed on the avoid list. See the \fBavoid\fR action above.
 .RE
 
@@ -2008,15 +2072,14 @@
 .in +2
 .nf
 <software_data action="avoid">
-    <name>pkg:/to/avoid</name>
+  <name>pkg:/to/avoid</name>
 </software_data>
 <software_data action="install">
-    <name>pkg:/entire</name>
-    <name>pkg:/group/system/solaris-large-server</name>
-    <reject>pkg:/to/reject</reject>
+  <name>pkg:/to/install</name>
+  <reject>pkg:/to/reject</reject>
 </software_data>
 <software_data action="uninstall">
-    <name>pkg:/unwanted/pkg</name>
+  <name>pkg:/unwanted/pkg</name>
 </software_data>
 .fi
 .in -2
@@ -2032,12 +2095,12 @@
 .in +2
 .nf
 <software type="P5I">
-    <source>
-        <publisher>
-            <origin name="/somewhere/image1.p5i"/>
-            <origin name="/somewhere/image2.p5i"/>
-        </publisher>
-    </source>
+  <source>
+    <publisher>
+      <origin name="/somewhere/image1.p5i"/>
+      <origin name="/somewhere/image2.p5i"/>
+    </publisher>
+  </source>
 </software>
 .fi
 .in -2
@@ -2056,11 +2119,11 @@
 .in +2
 .nf
 <software type="SVR4">
-    <source>
-        <publisher>
-            <origin name="/somedir"/>
-        </publisher>
-    </source>
+  <source>
+    <publisher>
+      <origin name="/somedir"/>
+    </publisher>
+  </source>
 </software>
 .fi
 .in -2
@@ -2074,8 +2137,8 @@
 .na
 \fB\fBinstall\fR\fR
 .ad
-.RS 13n
-.rt  
+.sp .6
+.RS 4n
 Copies the files from the source to the new boot environment. This is the default if the \fBaction\fR attribute is not specified. At least one \fBsoftware_data\fR element must have an action of install.
 .RE
 
@@ -2085,8 +2148,8 @@
 .na
 \fB\fBuninstall\fR\fR
 .ad
-.RS 13n
-.rt  
+.sp .6
+.RS 4n
 Removes the files from the new boot environment.
 .RE
 
@@ -2097,18 +2160,18 @@
 .in +2
 .nf
 <software type="SVR4">
-    <source>
-        <publisher>
-            <origin name="/somedir"/>
-        </publisher>
-    </source>
-    <software_data> <!-- defaults to install action -->
-        <name>ORGpackage1</name>
-        <name>ORGpackage2</name>
-    </software_data>
-    <software_data action="uninstall">
-        <name>ORGpackage8</name>
-    </software_data>
+  <source>
+    <publisher>
+      <origin name="/somedir"/>
+    </publisher>
+  </source>
+  <software_data> <!-- defaults to install action -->
+    <name>ORGpackage1</name>
+    <name>ORGpackage2</name>
+  </software_data>
+  <software_data action="uninstall">
+    <name>ORGpackage8</name>
+  </software_data>
 </software>
 .fi
 .in -2
@@ -2121,9 +2184,9 @@
 .in +2
 .nf
 <software type="CPIO">
-    <source>
-        <dir path="/somedir"/>
-    </source>
+  <source>
+    <dir path="/somedir"/>
+  </source>
 </software>
 .fi
 .in -2
@@ -2137,8 +2200,8 @@
 .na
 \fB\fBinstall\fR\fR
 .ad
-.RS 13n
-.rt  
+.sp .6
+.RS 4n
 Copies the files from the source to the new boot environment. This is the default if the \fBaction\fR attribute is not specified. At least one \fBsoftware_data\fR element must have an action of install.
 .sp
 Use the \fBname\fR element to specify the files or directories to be copied. Paths specified in the \fBname\fR element are relative to the source.
@@ -2161,8 +2224,8 @@
 .na
 \fB\fBuninstall\fR\fR
 .ad
-.RS 13n
-.rt  
+.sp .6
+.RS 4n
 Removes files from the new boot environment.
 .sp
 Use the \fBname\fR element to specify the files or directories to be removed. Paths specified in the \fBname\fR element are relative to the destination.
@@ -2170,7 +2233,7 @@
 .in +2
 .nf
 <software_data action="uninstall">
-    <name>path/relative/to/destination</name>
+  <name>path/relative/to/destination</name>
 </software_data>
 .fi
 .in -2
@@ -2212,8 +2275,8 @@
 .na
 \fB\fBssl_key\fR\fR
 .ad
-.RS 12n
-.rt  
+.sp .6
+.RS 4n
 This attribute maps to the following \fBpkg\fR command:
 .sp
 .in +2
@@ -2231,8 +2294,8 @@
 .na
 \fB\fBssl_cert\fR\fR
 .ad
-.RS 12n
-.rt  
+.sp .6
+.RS 4n
 This attribute maps to the following \fBpkg\fR command:
 .sp
 .in +2
@@ -2265,16 +2328,16 @@
 .in +2
 .nf
 <destination>
-    <image>
-        <!-- de-select all locales -->
-        <facet set="false">facet.locale.*</facet>
-        <!-- specify specific locales to install -->
-        <!-- install German and English only -->
-        <facet set="true">facet.locale.de</facet>
-        <facet set="true">facet.locale.de_DE</facet>
-        <facet set="true">facet.locale.en</facet>
-        <facet set="true">facet.locale.en_US</facet>
-    </image>
+  <image>
+    <!-- de-select all locales -->
+    <facet set="false">facet.locale.*</facet>
+    <!-- specify specific locales to install -->
+    <!-- install German and English only -->
+    <facet set="true">facet.locale.de</facet>
+    <facet set="true">facet.locale.de_DE</facet>
+    <facet set="true">facet.locale.en</facet>
+    <facet set="true">facet.locale.en_US</facet>
+  </image>
 </destination>
 .fi
 .in -2
@@ -2315,8 +2378,8 @@
 .na
 \fB\fBtitle\fR\fR
 .ad
-.RS 11n
-.rt  
+.sp .6
+.RS 4n
 The value of the \fBtitle\fR attribute is the base title of boot entries specified by \fBboot_entry\fR sub-elements of this \fBboot_mods\fR element. This attribute value overrides the name automatically generated from the first line of \fB/etc/release\fR or from the install media.
 .RE
 
@@ -2326,8 +2389,8 @@
 .na
 \fB\fBtimeout\fR\fR
 .ad
-.RS 11n
-.rt  
+.sp .6
+.RS 4n
 The value of the \fBtimeout\fR attribute is the number of seconds to wait before the default \fBboot_entry\fR of this \fBboot_mods\fR element is selected.
 .RE
 
@@ -2346,8 +2409,8 @@
 .na
 \fB\fBdefault_entry\fR\fR
 .ad
-.RS 17n
-.rt  
+.sp .6
+.RS 4n
 If this boolean value is set to \fBtrue\fR, then this menu item is the default option selected on boot. The default value of this attribute is \fBfalse\fR.
 .sp
 If multiple \fBboot_entry\fR elements have \fBdefault_entry\fR set to \fBtrue\fR, then the last such entry is the default option selected on boot.
@@ -2359,8 +2422,8 @@
 .na
 \fB\fBinsert_at\fR\fR
 .ad
-.RS 17n
-.rt  
+.sp .6
+.RS 4n
 This attribute can be set to one of the following two values:
 .sp
 .ne 2
@@ -2395,8 +2458,8 @@
 .na
 \fB\fBtitle_suffix\fR\fR
 .ad
-.RS 16n
-.rt  
+.sp .6
+.RS 4n
 This element is required. This element defines text to be added to the end of the title specified in the \fBboot_mods\fR element.
 .RE
 
@@ -2406,8 +2469,8 @@
 .na
 \fB\fBkernel_args\fR\fR
 .ad
-.RS 16n
-.rt  
+.sp .6
+.RS 4n
 This element is optional. This element is a string of values passed to the kernel by the boot loader.
 .RE
 
@@ -2418,9 +2481,9 @@
 .in +2
 .nf
 <boot_mods title="Boot Testing" timeout="20">
-    <boot_entry default_entry="true">
-        <title_suffix>Default Boot Entry</title_suffix>
-    </boot_entry>
+  <boot_entry default_entry="true">
+    <title_suffix>Default Boot Entry</title_suffix>
+  </boot_entry>
 </boot_mods>
 .fi
 .in -2
@@ -2472,13 +2535,13 @@
 .in +2
 .nf
 <configuration type="zone" name="zone1"
-    source="http://myserver.com/configs/zone1/config"/>
+  source="http://myserver.com/configs/zone1/config"/>
 .fi
 .in -2
 
 .sp
 .LP
-For more information about configuring and installing zones, see Chapter 12, \fIInstalling and Configuring Zones,\fR in \fIInstalling Oracle Solaris 11 Systems\fR.
+For more information about configuring and installing zones, see Chapter 12, \fIInstalling and Configuring Zones,\fR in \fIInstalling Oracle Solaris 11.1 Systems\fR.
 .SH FILES
 .sp
 .ne 2
@@ -2510,7 +2573,7 @@
 .ad
 .sp .6
 .RS 4n
-A template AI manifest with details commented out. This file provides examples of some customizations that can be performed. This file is provided on the system for reference only. To create a new AI manifest, use the copy of this file from the relevant install service image.  See the "Description" section for information about copying this file from an install service.
+A template AI manifest with details commented out. This file provides examples of some customizations that can be performed. This file is provided on the system for reference only. To create a new AI manifest, use the copy of this file from the relevant install service image. See the "Description" section for information about copying this file from an install service.
 .RE
 
 .SH ATTRIBUTES
@@ -2537,7 +2600,7 @@
 .SH SEE ALSO
 .sp
 .LP
-installadm(1M), \fBbeadm\fR(1M), \fBpkg\fR(1), \fBgrub\fR(5), \fBprtconf\fR(1M), \fBformat\fR(1M), \fBzfs\fR(1M), \fBzpool\fR(1M), \fBpkg.sysrepo\fR(1m), \fBsmf\fR(5), \fBzoneadm\fR(1M), \fBzonecfg\fR(1M)
+\fBpkg\fR(1), \fBbeadm\fR(1M), \fBboot\fR(1M), \fBcroinfo\fR(1M), \fBfdisk\fR(1M), \fBformat\fR(1M), \fBinstalladm\fR(1M), \fBiostat\fR(1M), \fBiscsiadm\fR(1M), \fBpkg.sysrepo\fR(1M), \fBprtconf\fR(1M), \fBzfs\fR(1M), \fBzoneadm\fR(1M), \fBzonecfg\fR(1M), \fBzpool\fR(1M), \fBgrub\fR(5), \fBsmf\fR(5)
 .sp
 .LP
-Part\ III, \fIInstalling Using an Install Server,\fR in \fIInstalling Oracle Solaris 11 Systems\fR
+Part\ III, \fIInstalling Using an Install Server,\fR in \fIInstalling Oracle Solaris 11.1 Systems\fR