clean up some comments

svn:r8338

src/or/dns.c

@@ -674,7 +674,7 @@ dns_cancel_pending_resolve(char *address)
 }
 
 /** Helper: adds an entry to the DNS cache mapping <b>address</b> to the ipv4
- * address 'addr'.  'ttl is a cache ttl; 'outcome' is one of
+ * address <b>addr</b>.  <b>ttl</b> is a cache ttl; <b>outcome</b> is one of
  * DNS_RESOLVE_{FAILED_TRANSIENT|FAILED_PERMANENT|SUCCEEDED}. */
 static void
 add_answer_to_cache(const char *address, uint32_t addr, char outcome,

src/or/or.h

@@ -1559,8 +1559,8 @@ typedef struct {
 
   char *VirtualAddrNetwork; /**< Address and mask to hand out for virtual
                              * MAPADDRESS requests. */
-  int SearchDomains; /**< If provided, we don't force exit addresses to be
+  int SearchDomains; /**< Boolean: If set, we don't force exit addresses to
-                      * fqdns, but rather search for them in the local
+                      * be FQDNs, but rather search for them in the local
                       * domains. */
   char *ResolvConf; /**< If provided, we configure our internal resolver from
                      * the file here rather than from /etc/resolv.conf (unix)