doc: boards: Amazon Kindle 4/5: apply some more formatting

Signed-off-by: Roland Hieber <rohieb@rohieb.name>
Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>

1 files changed, 25 insertions, 14 deletions

diff --git a/Documentation/boards/imx/amazon-kindle-4-5.rst b/Documentation/boards/imx/amazon-kindle-4-5.rst
index 1e71cd26ba..bc6bf2609b 100644
--- a/Documentation/boards/imx/amazon-kindle-4-5.rst
+++ b/Documentation/boards/imx/amazon-kindle-4-5.rst
@@ -18,24 +18,32 @@ are shipped with a vendor modified u-boot imximage based on u-boot v2009.08.
 To upload and run a new bootloader the older devices can be put into
 USB-downloader mode by the SOC microcode when a specific key is pressed during
 startup:
+
 * the fiveway down button on the model D01100
 * the home button on model D01200
+
 A new USB device "NS Blank CODEX" should appear, barebox may be uploaded using
-$ scripts/imx/imx-usb-loader barebox-kindle-d01100.img
-$ scripts/imx/imx-usb-loader barebox-kindle-d01200.img
+
+::
+
+        $ scripts/imx/imx-usb-loader barebox-kindle-d01100.img
+        $ scripts/imx/imx-usb-loader barebox-kindle-d01200.img
+
 Hint: keep the select button pressed down to get the barebox USB console.
 
 Barebox may be used as drop-in replacement for the shipped bootloader, when
 the imximg fits into 258048 bytes. When installing the barebox imximg on
-the eMMC take care not to overwrite the vendor supplied serial numbers stored
-on the eMMC.
-e.g. for the D01100 just write the imx-header and the application section:
-loady -t usbserial
-memcpy -b -s barebox-kindle-d01100.img -d /dev/disk0.boot0.imx_header 1024 0 2048
-memcpy -b -s barebox-kindle-d01100.img -d /dev/disk0.boot0.self 4096 0 253952
+the eMMC, take care not to overwrite the vendor supplied serial numbers stored
+on the eMMC,
+e.g. for the D01100 just write the imx-header and the application section::
+
+        loady -t usbserial
+        memcpy -b -s barebox-kindle-d01100.img -d /dev/disk0.boot0.imx_header 1024 0 2048
+        memcpy -b -s barebox-kindle-d01100.img -d /dev/disk0.boot0.self 4096 0 253952
 
 Note: a USB serial ACM console will be launched by a barebox init script
 when
+
 * the cursor select key is pressed during startup of model D01100
 * the home button is pressed within a second after startup of model D01200.
   If you press the home button during startup, you will enter USB boot mode.
@@ -47,12 +55,15 @@ power consumption to a few milliamps of battery power, after some minutes
 the power consumption is further reduced to about 550 microamps. Switching
 on iomux pullups may significantly reduce your standby-time.
 
-Hints to reduce the build image size.
+Hints to reduce the build image size
+------------------------------------
+
 Note that a drop-in replacement barebox imximage must not exceed 258048 bytes
 since the space behind it is in use. Hence, don't build in drivers and FS
-that are not required, e.g.:
-  NET, DISK_AHCI, DISK_INTF_PLATFORM_IDE, DISK_ATA, VIDEO, PWM, LED,
-  USB_STORAGE, USB_ULPI, NAND, MTD_UBI, FS_UBIFS, MFD_MC34704, MFD_MC9SDZ60,
-  MFD_STMPE, EEPROM_AT25, EEPROM_AT24, KEYBOARD_GPIO, PARTITION_DISK_EFI
+that are not required, e.g.
+``NET, DISK_AHCI, DISK_INTF_PLATFORM_IDE, DISK_ATA, VIDEO, PWM, LED,
+USB_STORAGE, USB_ULPI, NAND, MTD_UBI, FS_UBIFS, MFD_MC34704, MFD_MC9SDZ60,
+MFD_STMPE, EEPROM_AT25, EEPROM_AT24, KEYBOARD_GPIO, PARTITION_DISK_EFI``
+
 Also unselect support for other boards to get rid of their dependencies.
-Further select IMAGE_COMPRESSION_XZKERN
+Further select ``IMAGE_COMPRESSION_XZKERN``.