fix some build errors

source/development/how-tos/kernel_debugging.rst

@@ -53,7 +53,7 @@ With the build finished, we should have a kernel package on the build machine av
 
 Copy this package to the test vm and install it using our :code:`opnsense-update` command:
 
-.. code-block::
+.. code-block:: sh
 
       opnsense-update -ikfr [version] -l /location/from/
 
@@ -70,14 +70,14 @@ To be able to connect to the test machine using :code:`kgdb`, you need to make s
 
 Edit :code:`/boot/device.hints` and change or add :code:`hint.uart.0.flags` to the following:
 
-.. code-block::
+.. code-block:: sh
 
     hint.uart.0.flags="0xc0"
 
 
 Also /boot/loader.conf.local should have a baud-rate configured for the serial device:
 
-.. code-block::
+.. code-block:: sh
 
     comconsole_speed="115200"
 

source/manual/how-tos/serial_access.rst

@@ -43,11 +43,12 @@ The device name can differ per system and per serial device. Examples of names a
 * COM1, COM2, ... (Windows)
 
 .. Note::
-    If you have multiple devices of the same type like shown here:
-    ::
-        ls /dev/ttyUSB*
-        /dev/ttyUSB0  /dev/ttyUSB1
-    
+    If you have multiple devices of the same type  like shown here:
+
+        :code:`# ls /dev/ttyUSB*`
+
+        :code:`/dev/ttyUSB0  /dev/ttyUSB1`
+
     You can disconnect one of them to see which one is left or you can read the ``dmesg`` log to get the vendor information
     for the device node.
     You can search for a message containing "now attached to ttyUSB1" to find out which device it is. Afterwards you can
@@ -65,7 +66,7 @@ the serial console thus involves opening a terminal and executing the following
 .. Note::
     Access to the device is likely to be access restricted. You should run the command as root because running it as
     a user may lead to an access denied error on Linux / BSD.
-  
+
 If OPNsense is running, you will now be asked for your username and password if authentication is enabled. Otherwise
 the menu is displayed (at least after pressing enter). The credentials are the same as those used for SSH.
 

source/manual/install.rst

@@ -422,7 +422,7 @@ Minimum installation actions
     In case of a minimum install setup (i.e. on CF cards), OPNsense can
     be run with all standard features, expect for the ones that require
     disk writes, e.g. a caching proxy like Squid. Do not create a swap
-    slice, but a RAM Disk instead. In the GUI enable :menuselection:`System --> Settings --> Miscellaneous --> RAM Disk Settings`*
+    slice, but a RAM Disk instead. In the GUI enable :menuselection:`System --> Settings --> Miscellaneous --> RAM Disk Settings`
     and set the size to 100-128 MB or more, depending on your available RAM.
     Afterwards reboot.