-fix awful formatting

1 files changed, 56 insertions, 20 deletions

diff --git a/taler-exchange-setup-guide.rst b/taler-exchange-setup-guide.rst
index 816ee063..3ce23301 100644
--- a/taler-exchange-setup-guide.rst
+++ b/taler-exchange-setup-guide.rst
@@ -899,42 +899,78 @@ a merchant backend is not required, as the wallet acts as a merchant.
   # of taler coins.
   $ taler-wallet-cli advanced withdraw-manually --exchange $EXCHANGE_URL --amount EUR:10.50
 
-  # Show the status of the manual withdrawal operation.
+
+Show the status of the manual withdrawal operation.
+
+.. code-block:: shell-session
+
   $ taler-wallet-cli transactions
 
-  #
-  # At this point, a bank transfer to the exchange's bank account
-  # needs to be made with the correct subject / remittance information
-  # as instructed by the wallet after the first step.
-  #
+At this point, a bank transfer to the exchange's bank account
+needs to be made with the correct subject / remittance information
+as instructed by the wallet after the first step.  With the
+above configuration, it should take about 5 minutes after the
+wire transfer for the incoming transfer to be observed by the
+Nexus.
+
+Run the following command to check whether the exchange received
+an incoming bank transfer:
+
+.. code-block:: shell-session
+
+  [root@exchange-online]# taler-exchange-wire-gateway-client \
+     --section exchange-accountcredentials-1 --credit-history
+
+Once the transfer has been made, try completing the withdrawal
+using:
 
-  # Check whether the exchange received an incoming bank transfer.
-  [root@exchange-online]# taler-exchange-wire-gateway-client --section exchange-accountcredentials-1 --credit-history
+.. code-block:: shell-session
 
-  # Once the transfer has been made, try completing the withdrawal.
   $ taler-wallet-cli run-pending
 
-  # Check status of transactions and show balance.
+Afterwards, check the status of transactions and show the
+current wallet balance:
+
+.. code-block:: shell-session
+
   $ taler-wallet-cli transactions
   $ taler-wallet-cli balance
 
-  # Now, directly deposit coins with the exchange into a target account.
-  # (Usually, a payment is made via a merchant.  The wallet provides
-  # this functionality for testing.)
+
+Now, we can directly deposit coins via the exchange into a target
+account.  (Usually, a payment is made via a merchant.  The wallet
+provides this functionality for testing.)
+
+.. code-block:: shell-session
+
   $ taler-wallet-cli deposit create EUR:5 payto://sepa/$IBAN
 
-  # Check if transaction was successful.
-  # (If not, fix issue with exchange and run "run-pending" command again)
+
+Check if this transaction was successful (from the perspective
+of the wallet). If not, fix any open issue(s) with exchange and
+run the "run-pending" command again:
+
+.. code-block:: shell-session
+
   $ taler-wallet-cli transactions
 
-  # The wallet can also track if the exchange wired the money to the merchant account.
-  # The "deposit group id" can be found in the output of the transactions list.
+The wallet can also track if the exchange wired the money to the merchant
+account.  The "deposit group id" can be found in the output of the
+transactions list.
+
+.. code-block:: shell-session
+
   $ taler-wallet-cli deposit track $DEPOSIT_GROUP_ID
 
-  # Check whether the exchange sent an outgoing transfer.
-  [root@exchange-online]# taler-exchangewire-gateway-client --section exchange-account-1 --debit-history
+You can also check using the exchange-tools whether the exchange sent
+the an outgoing transfer:
+
+.. code-block:: shell-session
+
+  [root@exchange-online]# taler-exchange-wire-gateway-client \
+    --section exchange-account-1 --debit-history
 
-  # After enough time has passed, the money should arrive at the specified IBAN.
+After enough time has passed, the money should arrive at the specified IBAN.
 
 
 FIXMEs