More documentation improvements

Author: larskanis

README.md

@@ -146,7 +146,7 @@ Very basic type casting can be enabled by:
 But Pg's type casting is highly customizable. That's why it's divided into
 2 layers:
 
-### Encoders / Decoders (ext/pg_*coder.c, lib/pg/*coder.rb)
+### Encoders / Decoders (ext/pg_\*coder.c, lib/pg/\*coder.rb)
 
 This is the lower layer, containing encoding classes that convert Ruby
 objects for transmission to the DBMS and decoding classes to convert
@@ -188,9 +188,9 @@ The following text and binary formats can also be encoded although they are not
 * Literal for insertion into SQL string: [TE](rdoc-ref:PG::TextEncoder::QuotedLiteral)
 * SQL-Identifier: [TE](rdoc-ref:PG::TextEncoder::Identifier), [TD](rdoc-ref:PG::TextDecoder::Identifier)
 
-### PG::TypeMap and derivations (ext/pg_type_map*.c, lib/pg/type_map*.rb)
+### TypeMap and derivations (ext/pg_type_map\*.c, lib/pg/type_map\*.rb)
 
-A TypeMap defines which value will be converted by which encoder/decoder.
+A PG::TypeMap defines which value will be converted by which encoder/decoder.
 There are different type map strategies, implemented by several derivations
 of this class. They can be chosen and configured according to the particular
 needs for type casting. The default type map is PG::TypeMapAllStrings.

ext/pg_result.c

@@ -1402,7 +1402,7 @@ pgresult_fields(VALUE self)
  * call-seq:
  *    res.type_map = typemap
  *
- * Set the TypeMap that is used for type casts of result values to ruby objects.
+ * Set the PG::TypeMap that is used for type casts of result values to ruby objects.
  *
  * All value retrieval methods will respect the type map and will do the
  * type casts from PostgreSQL's wire format to Ruby objects on the fly,
@@ -1432,7 +1432,7 @@ pgresult_type_map_set(VALUE self, VALUE typemap)
  * call-seq:
  *    res.type_map -> value
  *
- * Returns the TypeMap that is currently set for type casts of result values to ruby objects.
+ * Returns the PG::TypeMap that is currently set for type casts of result values to ruby objects.
  *
  */
 static VALUE

ext/pg_type_map.c

@@ -187,7 +187,9 @@ init_pg_type_map(void)
 	 *
 	 * This is the base class for type maps.
 	 * See derived classes for implementations of different type cast strategies
-	 * ( PG::TypeMapByColumn, PG::TypeMapByOid ).
+	 * ( PG::TypeMapByColumn, PG::TypeMapByOid, etc.).
+	 *
+	 * Find more type maps in the {README}[rdoc-ref:README.md@Type+Casts].
 	 *
 	 */
 	rb_cTypeMap = rb_define_class_under( rb_mPG, "TypeMap", rb_cObject );