--- wikisrc/ports/evbarm/install_using_sysinst.mdwn	2018/11/19 14:03:19	1.2
+++ wikisrc/ports/evbarm/install_using_sysinst.mdwn	2018/11/19 20:08:42	1.3
@@ -16,11 +16,16 @@ external media (SATA hard disk, USB stic
 
 *TODOleot*: Document all sysinst(8) "screenshot"!
 
+Now that the SD card is populated with `armv7.img` we can login as `root` (by
+default the password is empty) and run `sysinst`:
 
 ````
 # sysinst
 ````
 
+The first menu is about the system type (Respberry PI or Other), we select the
+latter ("Other"):
+
 ````
 
 
@@ -50,6 +55,9 @@ external media (SATA hard disk, USB stic
 
 ````
 
+We want to install NetBSD/evbarm on the hard disk so let's select
+"Install NetBSD to hard disk":
+
 ````
 
  NetBSD/evbarm 8.0
@@ -79,6 +87,10 @@ external media (SATA hard disk, USB stic
 
 ````
 
+Before proceeding with the installation, if the hard disk had any important data
+it is better to stop and doing a backup before proceeding. If it is empty and/or
+we can safetely remove its data we can proceed:
+
 ````
 
  You have chosen to install NetBSD on your hard disk.  This will change
@@ -108,6 +120,9 @@ external media (SATA hard disk, USB stic
 
 ````
 
+Now we can see all the available disks. The hard disk attached via SATA is a
+120GB SSD recognized as `wd0`:
+
 ````
 
  On which disk do you want to install NetBSD?
@@ -137,6 +152,10 @@ external media (SATA hard disk, USB stic
 
 ````
 
+We now need to edit MBR partition table. We will create two MBR partitions: the
+first one a FAT32 for `/boot` and the other for NetBSD. We select "Edit the MBR
+partition table":
+
 ````
 
  We are now going to install NetBSD on the disk wd0.
@@ -166,6 +185,8 @@ external media (SATA hard disk, USB stic
 
 ````
 
+First we select the second entry ("b"), set the "type:" to "NetBSD":
+
 ````
 
  The Current MBR partition table is shown below.
@@ -195,6 +216,11 @@ external media (SATA hard disk, USB stic
 
 ````
 
+We reserve for the NetBSD MBR partition all the end of the disk,
+starting at 92MB (1MB that will be empty and 91MB that will be for
+the FAT32), we also select to make it active ("active: Yes") and
+we will use it to install NetBSD ("install: Yes"):
+
 ````
 
  The Current MBR partition table is shown below.
@@ -224,6 +250,10 @@ external media (SATA hard disk, USB stic
 
 ````
 
+We now select the first partition ("a") and create a "Windows FAT32", starting
+at 1MB and ending at 92MB before the "NetBSD" partition. We also make it active
+("active: Yes"):
+
 ````
 
  The Current MBR partition table is shown below.
@@ -253,6 +283,8 @@ external media (SATA hard disk, USB stic
 
 ````
 
+Here the final MBR partition table:
+
 ````
 
  The Current MBR partition table is shown below.
@@ -282,6 +314,9 @@ external media (SATA hard disk, USB stic
 
 ````
 
+Now that the MBR partition table is written we can proceed to set
+sizes of NetBSD partitions:
+
 ````
 
  NetBSD uses a BSD disklabel to carve up the NetBSD portion of the disk into
@@ -311,6 +346,8 @@ external media (SATA hard disk, USB stic
 
 ````
 
+We set the swap size to 4G and we reserve the rest of the space for "/":
+
 ````
 
  You can now change the sizes for the system partitions.  The default is to
@@ -340,6 +377,8 @@ external media (SATA hard disk, USB stic
 
 ````
 
+The summary of the current BSD disklabel is:
+
 ````
 
  We now have your BSD disklabel partitions as:
@@ -369,6 +408,11 @@ external media (SATA hard disk, USB stic
 
 ````
 
+We can adjust the disklabel, for example we can use FFSv2 for "/"
+and for the disklabel "e" set its mount point to "/boot" in order
+that an `/etc/fstab` entry will be populated (please note
+that "/boot" will not be automatically mounted by default):
+
 ````
 
  We now have your BSD disklabel partitions as:
@@ -398,6 +442,13 @@ external media (SATA hard disk, USB stic
 
 ````
 
+We have finally ready to proceed with
+[[!template id=man name="sysinst" section="8"]] as usual and install
+the installation sets.  If you choose to install via FTP/HTTP please
+note that the "Binary set directory" needs to be adjusted from
+`/evbarm/binary/sets` to `/evbarm-earmv7hf/binary/sets` (it's
+missing an `-earmv7hf' due different evbarm-s):
+
 ````
 
  The following are the http site, directory, user, and password that will be
@@ -427,17 +478,18 @@ external media (SATA hard disk, USB stic
 
 ````
 
+The installation will proceed as usual and for more information
+please give a look to
+[The NetBSD Guide](https://www.netbsd.org/docs/guide/en/chap-exinst.html#exinst-choose-media).
+
+*TODOleot*: add information how to populate `/boot` and prepare `boot.cmd`,
+`boot.scr`.
+
 ````
 # mount /dev/wd0e /mnt
 # cp -r /boot/* /mnt/
 ````
 
-*TODOleot*: add a reference to The NetBSD Guide for further steps of the
-installation. 
-
-*TODOleot*: add information how to populate `/boot` and prepare `boot.cmd`,
-`boot.scr`.
-
 
 # References