Index: documentation/content/en/books/handbook/basics/_index.adoc =================================================================== --- documentation/content/en/books/handbook/basics/_index.adoc +++ documentation/content/en/books/handbook/basics/_index.adoc @@ -1138,12 +1138,12 @@ If man:ls[1] is used to view the contents of this directory, it will show two subdirectories, `A1` and `A2`. The directory tree looks like this: -image::example-dir1.png[] +image::example-dir1.png[Directory tree with the root directory and two subdirectories, A1 and A2] A file system must be mounted on to a directory in another file system. When mounting file system `B` on to the directory `A1`, the root directory of `B` replaces `A1`, and the directories in `B` appear accordingly: -image::example-dir2.png[] +image::example-dir2.png[Directory tree with the root directory and two subdirectories, A1 and A2. And more subdirectories, B1 and B2 hanging from A1] Any files that are in the `B1` or `B2` directories can be reached with the path [.filename]#/A1/B1# or [.filename]#/A1/B2# as necessary. Any files that were in [.filename]#/A1# have been temporarily hidden. @@ -1151,18 +1151,18 @@ If `B` had been mounted on `A2` then the diagram would look like this: -image::example-dir3.png[] +image::example-dir3.png[Directory tree with the root directory and two subdirectories, A1 and A2. And more subdirectories, B1 and B2 hanging from A2] and the paths would be [.filename]#/A2/B1# and [.filename]#/A2/B2# respectively. File systems can be mounted on top of one another. Continuing the last example, the `C` file system could be mounted on top of the `B1` directory in the `B` file system, leading to this arrangement: -image::example-dir4.png[] +image::example-dir4.png[A complex directory tree. With different subdirectories hanging from root.] Or `C` could be mounted directly on to the `A` file system, under the `A1` directory: -image::example-dir5.png[] +image::example-dir5.png[A complex directory tree. With different subdirectories hanging from root.] It is entirely possible to have one large root file system, and not need to create any others. There are some drawbacks to this approach, and one advantage. @@ -1298,7 +1298,7 @@ Partition `a` is used for the root file system, `d` for [.filename]#/var/#, `e` for [.filename]#/tmp/#, and `f` for [.filename]#/usr/#. Partition letter `c` refers to the entire slice, and so is not used for ordinary partitions. -image::disk-layout.png[] +image::disk-layout.png[Image showing the layout of a shared drive between Windows and FreeBSD] ==== [[mount-unmount]] Index: documentation/content/en/books/handbook/bsdinstall/_index.adoc =================================================================== --- documentation/content/en/books/handbook/bsdinstall/_index.adoc +++ documentation/content/en/books/handbook/bsdinstall/_index.adoc @@ -362,7 +362,7 @@ [[bsdinstall-newboot-loader-menu]] .FreeBSD Boot Loader Menu -image::bsdinstall-newboot-loader-menu.png[] +image::bsdinstall-newboot-loader-menu.png[FreeBSD boot loader menu] By default, the menu will wait ten seconds for user input before booting into the FreeBSD installer or, if FreeBSD is already installed, before booting into FreeBSD. To pause the boot timer in order to review the selections, press kbd:[Space]. @@ -378,7 +378,7 @@ [[bsdinstall-boot-options-menu]] .FreeBSD Boot Options Menu -image::bsdinstall-boot-options-menu.png[] +image::bsdinstall-boot-options-menu.png[FreeBSD boot options menu] The boot options menu is divided into two sections. The first section can be used to either return to the main boot menu or to reset any toggled options back to their defaults. @@ -398,7 +398,7 @@ [[bsdinstall-choose-mode]] .Welcome Menu -image::bsdinstall-choose-mode.png[] +image::bsdinstall-choose-mode.png[FreeBSD installation welcome menu] Press kbd:[Enter] to select the default of btn:[Install] to enter the installer. The rest of this chapter describes how to use this installer. @@ -428,7 +428,7 @@ [[bsdinstall-keymap-loading]] .Keymap Loading -image::bsdinstall-keymap-loading.png[] +image::bsdinstall-keymap-loading.png[Keymap loading] After the keymaps have been loaded, bsdinstall displays the menu shown in <>. Use the up and down arrows to select the keymap that most closely represents the mapping of the keyboard attached to the system. @@ -436,7 +436,7 @@ [[bsdinstall-keymap-10]] .Keymap Selection Menu -image::bsdinstall-keymap-10.png[] +image::bsdinstall-keymap-10.png[Keymap selection menu showing all supported keyboards] [NOTE] ==== @@ -448,7 +448,7 @@ [[bsdinstall-keymap-testing]] .Keymap Testing Menu -image::bsdinstall-keymap-testing.png[] +image::bsdinstall-keymap-testing.png[Keymap testing menu] [[bsdinstall-hostname]] === Setting the Hostname @@ -457,7 +457,7 @@ [[bsdinstall-config-hostname]] .Setting the Hostname -image::bsdinstall-config-hostname.png[] +image::bsdinstall-config-hostname.png[Setting the hostname] Type in a hostname that is unique for the network. It should be a fully-qualified hostname, such as `machine3.example.com`. @@ -469,7 +469,7 @@ [[bsdinstall-config-components]] .Selecting Components to Install -image::bsdinstall-config-components.png[] +image::bsdinstall-config-components.png[Different components that can be installed. Example: base-dbg, lib32, ports, etc.] Deciding which components to install will depend largely on the intended use of the system and the amount of disk space available. The FreeBSD kernel and userland, collectively known as the _base system_, are always installed. @@ -500,7 +500,7 @@ [[bsdinstall-netinstall-notify]] .Installing from the Network -image::bsdinstall-netinstall-files.png[] +image::bsdinstall-netinstall-files.png[Indicates that certain components have not been found and will be downloaded using the network.] [[bsdinstall-partitioning]] == Allocating Disk Space @@ -509,7 +509,7 @@ [[bsdinstall-zfs-partmenu]] .Partitioning Choices -image::bsdinstall-zfs-partmenu.png[] +image::bsdinstall-zfs-partmenu.png[Shows the different partition options. Example: Manual, Shell, etc.] bsdinstall gives the user four methods for allocating disk space: @@ -569,7 +569,7 @@ [[bsdinstall-part-guided-disk]] .Selecting from Multiple Disks -image::bsdinstall-part-guided-disk.png[] +image::bsdinstall-part-guided-disk.png[Shows the list of disks on which FreeBSD can be installed] Once the disk is selected, the next menu prompts to install to either the entire disk or to create a partition using free space. If btn:[Entire Disk] is chosen, a general partition layout filling the whole disk is automatically created. @@ -577,13 +577,13 @@ [[bsdinstall-part-entire-part]] .Selecting Entire Disk or Partition -image::bsdinstall-part-entire-part.png[] +image::bsdinstall-part-entire-part.png[Menu asking the user if he wants to use all the available space on the disk or wants to make a partition] After btn:[Entire Disk] is chosen, bsdinstall displays a dialog indicating that the disk will be erased. [[bsdinstall-ufs-warning]] .Confirmation -image::bsdinstall-ufs-warning.png[] +image::bsdinstall-ufs-warning.png[Menu indicating the user that all data on the disk will be deleted and asking for confirmation] The next menu shows a list with the available partition scheme types. GPT is usually the most appropriate choice for amd64 computers. @@ -593,7 +593,7 @@ [[bsdinstall-ufs-scheme]] .Select Partition Scheme -image::bsdinstall-part-manual-partscheme.png[] +image::bsdinstall-part-manual-partscheme.png[Menu showing the user the different the different types of partition that exist and requesting one of them] After the partition layout has been created, review it to ensure it meets the needs of the installation. Selecting btn:[Revert] will reset the partitions to their original values. Pressing btn:[Auto] will recreate the automatic FreeBSD partitions. @@ -602,7 +602,7 @@ [[bsdinstall-part-review]] .Review Created Partitions -image::bsdinstall-part-review.png[] +image::bsdinstall-part-review.png[Menu showing the created layout and giving the user the options to modify, revert, finish, etc.] Once the disks are configured, the next menu provides the last chance to make changes before the selected drives are formatted. If changes need to be made, select btn:[Back] to return to the main partitioning menu. @@ -611,7 +611,7 @@ [[bsdinstall-ufs-final-confirmation]] .Final Confirmation -image::bsdinstall-final-confirmation.png[] +image::bsdinstall-final-confirmation.png[Menu indicating to the user that all changes will be written to disk and informing that if he decides to continue the existing data will be permanently deleted] To continue with the installation process, go to <>. Index: documentation/content/en/books/handbook/mail/_index.adoc =================================================================== --- documentation/content/en/books/handbook/mail/_index.adoc +++ documentation/content/en/books/handbook/mail/_index.adoc @@ -910,12 +910,12 @@ If no mails are found, mutt will wait for commands from the user. The example below shows mutt displaying a list of messages: -image::mutt1.png[] +image::mutt1.png[mutt email client showing a list of messages] To read an email, select it using the cursor keys and press kbd:[Enter]. An example of mutt displaying email can be seen below: -image::mutt2.png[] +image::mutt2.png[mutt email client displaying an email] Similar to man:mail[1], mutt can be used to reply only to the sender of the message as well as to all recipients. To reply only to the sender of the email, press kbd:[r]. @@ -935,7 +935,7 @@ In order to send the mail, press kbd:[y]. An example of the summary screen can be seen below: -image::mutt3.png[] +image::mutt3.png[mutt email client showing the summary screen] mutt contains extensive help which can be accessed from most of the menus by pressing kbd:[?]. The top line also displays the keyboard shortcuts where appropriate. @@ -965,7 +965,7 @@ Alternatively, press kbd:[E] to exit the greeting without sending an anonymous message. An example of the greeting page is shown below: -image::pine1.png[] +image::pine1.png[alpine email client showing the greeting page] The main menu is then presented, which can be navigated using the cursor keys. This main menu provides shortcuts for the composing new mails, browsing mail directories, and administering address book entries. @@ -974,25 +974,25 @@ The default directory opened by alpine is [.filename]#inbox#. To view the message index, press kbd:[I], or select the [.guimenuitem]#MESSAGE INDEX# option shown below: -image::pine2.png[] +image::pine2.png[alpine email client showing the default directory] The message index shows messages in the current directory and can be navigated by using the cursor keys. Highlighted messages can be read by pressing kbd:[Enter]. -image::pine3.png[] +image::pine3.png[alpine email client showing the message index] In the screenshot below, a sample message is displayed by alpine. Contextual keyboard shortcuts are displayed at the bottom of the screen. An example of one of a shortcut is kbd:[r], which tells the MUA to reply to the current message being displayed. -image::pine4.png[] +image::pine4.png[alpine showing an email] Replying to an email in alpine is done using the pico editor, which is installed by default with alpine. pico makes it easy to navigate the message and is easier for novice users to use than man:vi[1] or man:mail[1]. Once the reply is complete, the message can be sent by pressing kbd:[Ctrl+X]. alpine will ask for confirmation before sending the message. -image::pine5.png[] +image::pine5.png[alpine showing the message compose window] alpine can be customized using the [.guimenuitem]#SETUP# option from the main menu. Consult http://www.washington.edu/alpine/[http://www.washington.edu/alpine/] for more information. Index: documentation/content/en/books/handbook/virtualization/_index.adoc =================================================================== --- documentation/content/en/books/handbook/virtualization/_index.adoc +++ documentation/content/en/books/handbook/virtualization/_index.adoc @@ -85,30 +85,30 @@ The first step in installing FreeBSD on Parallels is to create a new virtual machine for installing FreeBSD. Select [.guimenuitem]#FreeBSD# as the menu:Guest OS Type[] when prompted: -image::parallels-freebsd1.png[] +image::parallels-freebsd1.png[Parallels setup wizard showing FreeBSD as chosen OS] Choose a reasonable amount of disk and memory depending on the plans for this virtual FreeBSD instance. 4GB of disk space and 512MB of RAM work well for most uses of FreeBSD under Parallels: -image::parallels-freebsd2.png[] +image::parallels-freebsd2.png[Parallels setup wizard showing the amount of RAM allocated] -image::parallels-freebsd3.png[] +image::parallels-freebsd3.png[Parallels setup wizard showing the disk menu] -image::parallels-freebsd4.png[] +image::parallels-freebsd4.png[Parallels setup wizard showing the menu for setting the disk size and type] -image::parallels-freebsd5.png[] +image::parallels-freebsd5.png[Parallels setup wizard showing the menu for setting the disk location] Select the type of networking and a network interface: -image::parallels-freebsd6.png[] +image::parallels-freebsd6.png[Parallels setup wizard showing the network menu] -image::parallels-freebsd7.png[] +image::parallels-freebsd7.png[Parallels setup wizard showing the menu with the network type options] Save and finish the configuration: -image::parallels-freebsd8.png[] +image::parallels-freebsd8.png[Parallels setup wizard showing the menu to configure the name of the machine and the directory where to save the configuration] -image::parallels-freebsd9.png[] +image::parallels-freebsd9.png[Parallels setup wizard indicating that the configuration is complete and asking the user if he wants to start guest OS installation] After the FreeBSD virtual machine has been created, FreeBSD can be installed on it. This is best done with an official FreeBSD CD/DVD or with an ISO image downloaded from an official FTP site. @@ -116,21 +116,21 @@ Click on the disc icon in the bottom right corner of the FreeBSD Parallels window. This will bring up a window that can be used to associate the CD-ROM drive in the virtual machine with the ISO file on disk or with the real CD-ROM drive. -image::parallels-freebsd11.png[] +image::parallels-freebsd11.png[Parallels showing a summary of the newly created machine with information and actions to execute on the machine] Once this association with the CD-ROM source has been made, reboot the FreeBSD virtual machine by clicking the reboot icon. Parallels will reboot with a special BIOS that first checks if there is a CD-ROM. -image::parallels-freebsd10.png[] +image::parallels-freebsd10.png[Parallels showing the BIOS running] In this case it will find the FreeBSD installation media and begin a normal FreeBSD installation. Perform the installation, but do not attempt to configure Xorg at this time. -image::parallels-freebsd12.png[] +image::parallels-freebsd12.png[Parallels showing a snippet of the FreeBSD installation process] When the installation is finished, reboot into the newly installed FreeBSD virtual machine. -image::parallels-freebsd13.png[] +image::parallels-freebsd13.png[Parallels showing the boot of FreeBSD] [[virtualization-guest-parallels-configure]] === Configuring FreeBSD on Parallels