git: e82b013ea6 - main - Handbook-add alternative text to images to improve the accessibility

From: Sergio Carlavilla Delgado <>
Date: Wed, 15 Mar 2023 20:59:22 UTC
The branch main has been updated by carlavilla:


commit e82b013ea69c53d77c5c567382e28467f4065563
Author:     Sergio Carlavilla Delgado <>
AuthorDate: 2023-03-15 20:55:13 +0000
Commit:     Sergio Carlavilla Delgado <>
CommitDate: 2023-03-15 20:55:13 +0000

    Handbook-add alternative text to images to improve the accessibility
    Reviewed by:            grahamperrin@, bcr@
    Differential Revision:
 .../content/en/books/handbook/mail/_index.adoc     | 16 ++++++-------
 .../en/books/handbook/virtualization/_index.adoc   | 26 +++++++++++-----------
 2 files changed, 21 insertions(+), 21 deletions(-)

diff --git a/documentation/content/en/books/handbook/mail/_index.adoc b/documentation/content/en/books/handbook/mail/_index.adoc
index e4a832e8b1..aa05ce5dc2 100644
--- a/documentation/content/en/books/handbook/mail/_index.adoc
+++ b/documentation/content/en/books/handbook/mail/_index.adoc
@@ -909,12 +909,12 @@ mutt will automatically read and display the contents of the user mailbox in [.f
 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[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[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].
@@ -934,7 +934,7 @@ mutt will resume, displaying a summary screen of the mail that is to be delivere
 In order to send the mail, press kbd:[y].
 An example of the summary screen can be seen below:
+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.
@@ -964,7 +964,7 @@ To send this anonymous message, press kbd:[Enter].
 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[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.
@@ -973,25 +973,25 @@ Below the main menu, relevant keyboard shortcuts to perform functions specific t
 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[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[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[alpine email client 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[alpine email client showing the message compose window]
 alpine can be customized using the [.guimenuitem]#SETUP# option from the main menu.
 Consult[] for more information.
diff --git a/documentation/content/en/books/handbook/virtualization/_index.adoc b/documentation/content/en/books/handbook/virtualization/_index.adoc
index f5223e72bd..6d4067d786 100644
--- a/documentation/content/en/books/handbook/virtualization/_index.adoc
+++ b/documentation/content/en/books/handbook/virtualization/_index.adoc
@@ -84,30 +84,30 @@ Once Parallels has been installed on macOS(R), the user must configure a virtual
 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[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[Parallels setup wizard showing the amount of RAM allocated]
+image::parallels-freebsd3.png[Parallels setup wizard showing the disk menu]
+image::parallels-freebsd4.png[Parallels setup wizard showing the menu for setting the disk size and type]
+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[Parallels setup wizard showing the network menu]
+image::parallels-freebsd7.png[Parallels setup wizard showing the menu with the network type options]
 Save and finish the configuration:
+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[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.
@@ -115,21 +115,21 @@ Copy the appropriate ISO image to the local Mac(R) filesystem or insert a CD/DVD
 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[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[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[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[Parallels showing the boot of FreeBSD]
 === Configuring FreeBSD on Parallels