making glossary nicer

1 files changed, 17 insertions, 39 deletions

diff --git a/glossary.rst b/glossary.rst
index 023a0caa..c4906aef 100644
--- a/glossary.rst
+++ b/glossary.rst
@@ -22,44 +22,35 @@ Taler Glossary
 
 .. glossary::
 
-.. _auditor:
   auditor
       trusted third party that verifies that the exchange is operating correctly
 
-.. _bank:
   bank
-      traditional financial service provider who offers wire transfers between accounts
+      traditional financial service provider who offers wire :transfers: between accounts
 
-.. _coin:
   coin
-      coins are individual token representing a certain amount of value, also known as the denomination of the coin
+      coins are individual token representing a certain amount of value, also known as the :denomination: of the coin
 
-.. _contract:
   contract
       specification of the details of a transaction, specifies the payment obligations for the customer (i.e. the amount), the deliverables of the merchant and other related information, such as deadlines or locations
 
-.. _denomination:
   denomination
-      unit of currency, specifies both the currency and the face value of a coin
+      unit of currency, specifies both the currency and the face value of a :coin:
 
   denomination key
-      RSA key used by the exchange to certify that a given coin is valid and of a particular denomination
+      RSA key used by the exchange to certify that a given :coin: is valid and of a particular :denomination:
 
-.. _deposit:
   deposit
-      operation by which a merchant passes coins to an exchange, expecting the exchange to credit his bank account in the future using a wire transfer
+      operation by which a merchant passes coins to an exchange, expecting the exchange to credit his :bank: account in the future using a wire :transfer:
 
-.. _dirty:
   dirty coin
-     a coin is dirty if its public key may be known to an entity other than the customer, thereby creating the danger of some entity being able to link multiple transactions of coin's owner if the coin is not refreshed first
+     a :coin: is dirty if its public key may be known to an entity other than the customer, thereby creating the danger of some entity being able to link multiple transactions of coin's owner if the coin is not refreshed first
 
-.. _extension:
   extension
-     implementation of a wallet for browsers
+     implementation of a :wallet: for browsers
 
-.. _fresh:
   fresh coin
-     a coin is fresh if its public key is only known to the customer
+     a :coin: is fresh if its public key is only known to the customer
 
   master key
      offline key used by the exchange to certify denomination keys and message signing keys
@@ -67,60 +58,47 @@ Taler Glossary
   message signing key
      key used by the exchange to sign online messages, other than coins
 
-.. _owner:
   owner
-     a coin is owned by the entity that knows the private key of the coin
+     a :coin: is owned by the entity that knows the private key of the coin
 
-.. _proof:
   proof
      message that cryptographically demonstrates that a particular claim is correct
 
-.. _reserve:
   reserve
-     funds set aside for future use; either the balance of a customer at the exchange ready for withdrawal, or the funds kept in the exchange's bank account to cover obligations from coins in circulation
+     funds set aside for future use; either the balance of a customer at the exchange ready for :withdrawal:, or the funds kept in the exchange's bank account to cover obligations from coins in circulation
 
-.. _refresh:
   refreshing
-     operation by which a dirty coin is converted into one or more fresh coins
+     operation by which a :dirty: :coin: is converted into one or more :fresh: coins
 
-.. _refund:
   refund
-     operation by which a merchant steps back from the right to funds that he obtained from a deposit operation, giving the right to the funds back to the customer
+     operation by which a merchant steps back from the right to funds that he obtained from a :deposit: operation, giving the right to the funds back to the customer
 
-.. _sharing:
   sharing
-     users can share ownership of a coin by sharing access to the coin's private key, thereby allowing all co-owners to spend the coin at any time.
+     users can share ownership of a :coin: by sharing access to the coin's private key, thereby allowing all co-owners to spend the coin at any time.
 
   signing key
      see message signing key.
 
-.. _spending:
   spending
-     operation by which a customer gives a merchant the right to deposit coins in return for merchandise
+     operation by which a customer gives a merchant the right to :deposit: coins in return for merchandise
 
-.. _transfer:
   transfer
-     method of sending funds between accounts in the banking system
+     method of sending funds between :bank: accounts
 
-.. _transaction:
   transaction
      method by which ownership is exclusively transferred from one entity to another
 
   transaction id
-     unique number by which a merchant identifies a transaction
+     unique number by which a merchant identifies a :transaction:
 
-.. _wallet:
   wallet
      software running on a customer's computer; withdraws, stores and spends coins
 
-.. _wire:
   wire transfer
      see transfer
 
-.. _wtid:
   wire transfer identifier
      subject of a wire transfer; usually a random string to uniquely identify the transfer
 
-.. _withdrawal:
   withdrawal
-     operation by which a wallet can convert funds from a reserve to fresh coins
+     operation by which a :wallet: can convert funds from a reserve to fresh coins