--- a/doc/upgrading.txt	Wed Mar 06 22:50:28 2024 -0500
+++ b/doc/upgrading.txt	Sat Mar 09 22:17:42 2024 -0500
@@ -1159,7 +1159,7 @@
 Another way that should be faster, but is untested is to use mysql
 dump to dump the database.
 https://makandracards.com/makandra/595-dumping-and-importing-from-to-mysql-in-an-utf-8-safe-way
-recommends::
+recommends:
 
    Note that when your MySQL server is not set to UTF-8 you need to do
    mysqldump --default-character-set=latin1 (!) to get a correctly
@@ -1238,6 +1238,8 @@
 tracker's html directory, you *must* set this to 0. Otherwise you will
 see the error:
 
+.. code-block:: text
+
   Form is corrupted, missing: opaqueregister.
 
 If set to 0, the rate limit check is disabled.
@@ -1630,6 +1632,8 @@
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 If you get an error:
 
+.. code-block:: text
+
   AttributeError: 'list' object has no attribute 'value'
 
 in handle_csrf, you have more than one @csrf token for the form. This
@@ -2150,7 +2154,7 @@
 Changes to property permissions
 -------------------------------
 
-If you create a permission:
+If you create a permission::
 
     db.security.addPermission(name='View', klass='user',
        properties=['theme'], check=own_record,
@@ -2177,7 +2181,7 @@
 the code properly checks for duplicate search names, the user should
 stay on the search page if there is an error. To add this to your
 existing issue.search.html page, add the following line after the
-hidden field @old-queryname:
+hidden field ``@old-queryname``::
 
   <input type="hidden" name="@template" value="index|search"/>