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
[-- Attachment #1 --]
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.
[-- Attachment #2 --]
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>
-<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 <device> 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 <device> 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:<disk><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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020314224338.GV90154>