Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 14 Mar 2002 23:43:38 +0100
From:      Udo Erdelhoff <ue@nathan.ruhr.de>
To:        "Bruce A. Mah" <bmah@freebsd.org>
Cc:        freebsd-sparc@freebsd.org, freebsd-doc@freebsd.org
Subject:   Re: FreeBSD/sparc64 install document active in -CURRENT
Message-ID:  <20020314224338.GV90154@nathan.ruhr.de>
In-Reply-To: <20020314222604.GU90154@nathan.ruhr.de>
References:  <200203140543.g2E5hek56478@bmah.dyndns.org> <20020314185648.GO90154@nathan.ruhr.de> <200203142134.g2ELY8O23997@bmah.dyndns.org> <20020314222604.GU90154@nathan.ruhr.de>

next in thread | previous in thread | raw e-mail | index | archive | help

--U+BazGySraz5kW0T
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline

On Thu, Mar 14, 2002 at 11:26:05PM +0100, Udo Erdelhoff wrote:
> The third version of the patch is included.

Ok, let's try this again
a) write message
b) attach file
c) send
-- 
There's more than one way to skin a cat:
        Way number 15 -- Krazy Glue and a toothbrush.

--U+BazGySraz5kW0T
Content-Type: text/plain; charset=us-ascii
Content-Disposition: attachment; filename="install.3"

Index: Makefile
===================================================================
RCS file: /home/ncvs/src/release/doc/en_US.ISO8859-1/installation/sparc64/Makefile,v
retrieving revision 1.1
diff -u -r1.1 Makefile
--- Makefile	5 Mar 2002 23:22:08 -0000	1.1
+++ Makefile	14 Mar 2002 22:13:31 -0000
@@ -14,5 +14,9 @@
 SRCS+=	../common/install.sgml
 SRCS+=	../common/layout.sgml
 
+# Needed for the callouts
+IMAGES_LIB=     callouts/1.png
+IMAGES_LIB+=    callouts/2.png
+
 .include "${RELN_ROOT}/share/mk/doc.relnotes.mk"
 .include "${DOC_PREFIX}/share/mk/doc.project.mk"
Index: install.sgml
===================================================================
RCS file: /home/ncvs/src/release/doc/en_US.ISO8859-1/installation/sparc64/install.sgml,v
retrieving revision 1.7
diff -u -r1.7 install.sgml
--- install.sgml	14 Mar 2002 01:40:47 -0000	1.7
+++ install.sgml	14 Mar 2002 22:19:54 -0000
@@ -56,7 +56,7 @@
       <para>This section describes the files you will need for a
 	&os;/&arch; installation.  The links in this document point to
 	the main &os; FTP server.  Please use a mirror site instead if
-	possible.
+	possible.</para>
 
       <important>
 	<para>The URLs in this section are provisional and subject to
@@ -139,12 +139,29 @@
 	on the keyboard, or send a
         <command>BREAK</command> over the serial console (using for
         example <command>~#</command> in &man.tip.1; or &man.cu.1;) to
-        get to the PROM prompt.  It looks like
+        get to the PROM prompt.  It looks like this:</para>
 
-        <screen>ok </screen>
-        or
-        <screen>ok {0} </screen>
-        (on SMP systems).</para>
+      <screenco>
+        <areaspec>
+	  <area id="prompt-single" coords="1 5">
+
+	  <area id="prompt-smp" coords="2 5">
+        </areaspec>
+        <screen><prompt>ok     </prompt>                            
+<prompt>ok {0} </prompt>                   </screen>
+
+        <calloutlist>
+	  <callout arearefs="prompt-single">
+	    <para>This is the prompt used on systems with just
+	      one CPU.</para>
+          </callout>
+
+	  <callout arearefs="prompt-smp">
+	    <para>This is the prompt used on SMP systems, the digit
+	      indicates the number of the active CPU.</para>
+	  </callout>
+        </calloutlist>
+      </screenco>
     </sect3>
   </sect2>
     
@@ -242,7 +259,7 @@
   :rp="<replaceable>tftp-server-ip-address</replaceable>:<replaceable>nfs-root-directory</replaceable>":\
   :sm=<replaceable>ip-netmask</replaceable>
 
-&lt;name of the entry>:\
+<replaceable>name-of-the-entry</replaceable>:\
   ha=<replaceable>sparc64-ethernet-address</replaceable>:ip=<replaceable>sparc64-ip-address</replaceable>:tc=.default</programlisting>
 
         <para>The Ethernet address must be the same as the one in the
@@ -287,7 +304,7 @@
            <literal>option host-name</literal> is resolvable, i.e. has
            a DNS entry or is associated with an address in
            <filename>/etc/hosts</filename>, the
-           <literal>fixed-address</literal> specification can be omitted.
+           <literal>fixed-address</literal> specification can be omitted.</para>
       </sect4>
     </sect3>
 
@@ -396,18 +413,22 @@
     <para>To create a disk label, the following procedure is the
       easiest:</para>
 
-    <para>First, use:
-<screen>&prompt.root; <userinput>disklabel -w -r &lt;device&gt; auto</userinput></screen>
-      This will create a basic disk label. The third argument you need
+    <procedure>
+      <step>
+    <para>Run
+<command>disklabel -w -r <replaceable>device</replaceable> auto</command>
+      to create a basic disk label. The third argument you need
       specify here is just the name of the device, not the complete
       path to the device node (e.g. <devicename>ad0</devicename> for
       the first ATA disk).</para>
+      </step>
 
+      <step>
     <para>
-      Now, use:
-<screen>&prompt.root; <userinput>disklabel -e &lt;device&gt; auto</userinput></screen>
-      This will open an editor in which you can edit the disk
-      label. The information presented to you should look like:
+      Use
+<command>disklabel -e <replaceable>device</replaceable></command>
+      to open an editor in which you can edit the disk
+      label. The information presented to you should look like:</para>
 
 <screen># /dev/ad6c:
 type: unknown
@@ -430,10 +451,9 @@
 
 8 partitions:
 #        size   offset    fstype   [fsize bsize bps/cpg]
-  c: 80418240        0    unused        0     0         # (Cyl.    0 - 79779)
-</screen>
+  c: 80418240        0    unused        0     0         # (Cyl.    0 - 79779)</screen>
 
-      You can now add new partitions in the same format as the already
+      <para>You can now add new partitions in the same format as the already
       present line. Using <literal>*</literal> in the offset field makes the procedure
       easier; please refer to the &man.disklabel.8; manual page for more
       information.</para>
@@ -451,7 +471,9 @@
       this disk must have their respective partition entries in the
       old and new label match <emphasis>exactly</emphasis>, or they
       will be lost.</para></warning>
+      </step>
 
+      <step>
     <para>Use <command>disklabel -B</command> if you want to make the
       disk bootable for &os;/&arch;.</para>
 
@@ -467,6 +489,8 @@
       <ulink
       url="ftp://ftp.FreeBSD.org/pub/FreeBSD/development/sparc64/loader-ufs.gz"></ulink>;
     </para>
+      </step>
+    </procedure>
 
   </sect2>
    
@@ -491,19 +515,19 @@
 
     <para>To create file systems and to install the base system, boot
       from CDROM or via NFS and create a disk label as described in
-      <xref linkend="creating-disk-label">.
+      <xref linkend="creating-disk-label">.</para>
 
     <para>When booting the first time and you have not entered your
       root partition into <filename>/etc/fstab</filename> yet, you may
       need to specify your root partition on the mountroot prompt when
       booting (use a format like
-      <command>ufs:&lt;disk>&lt;partition></command>, i.e. leave the
+      <command>ufs:<replaceable>disk</replaceable><replaceable>partition</replaceable></command>, i.e. leave the
       slice specification out). If the kernel does automatically
       attempt to boot from another file system, press a key other than
       <keycap>Enter</keycap> on the <application>loader</application>
-      prompt:
+      prompt:</para>
 <screen>Hit [Enter] to boot immediately, or any other key for command prompt.</screen>
-      Then, boot the kernel using <command>boot -a -s</command>, which
+      <para>Then, boot the kernel using <command>boot -a -s</command>, which
       will cause the kernel to ask you for the root partition and
       then boot into single-user mode. Once the root file system has
       been entered into <filename>/etc/fstab</filename>, it should be

--U+BazGySraz5kW0T--

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-sparc" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020314224338.GV90154>