Shrink the pg_hba.conf and pg_ident.conf default files and move most of the

inline documentation to the main docs.

src/backend/libpq/pg_ident.conf.sample

-# 
-# 		PostgreSQL IDENT-BASED AUTHENTICATION MAPS
-# 
-# This file controls PostgreSQL ident-based authentication. It maps ident
-# usernames (typically Unix usernames) to their corresponding PostgreSQL
-# usernames. Entries are grouped by map name. Each record consists of
-# three fields:
-# 
-# 	o map name
-# 	o ident username
-# 	o PostgreSQL username
-# 
-# It is read on postmaster startup and when the postmaster receives a SIGHUP.
-# If you edit the file on a running system, you have to SIGHUP the postmaster
-# for the changes to take effect.
+# PostgreSQL Ident Authentication Maps
+# ====================================
 #
-# For example, the following entry equates user "james" on a remote system
-# to PostgreSQL user "guest" in the map named "phoenix":
-# 
-# MAP       IDENT    PGUSERNAME
-# phoenix   james    guest
-# 
-# "phoenix" can now be used by an "ident" record in $DATA/pg_hba.conf.
-# 
-# Multiple maps may be specified in this file and used by pg_hba.conf.
-# 
-# Note that it is possible for a remote user to map to multiple PostgreSQL
-# usernames. The PostgreSQL username specified at connection time controls
-# which one is used.
-# 
-# If all ident usernames and PostgreSQL usernames are the same, you don't
-# need this file. Instead, use the special map name "sameuser" in
+# Refer to the PostgreSQL Administrator's Guide, chapter "Client
+# Authentication" for a complete description.  A short synopsis
+# follows.
+#
+# This file controls PostgreSQL ident-based authentication. It maps
+# ident user names (typically Unix user names) to their corresponding
+# PostgreSQL user names.  Records are of the form:
+#
+# MAPNAME  IDENT-USERNAME  PG-USERNAME
+#
+# (The uppercase quantities should be replaced by actual values.)
+# MAPNAME is the (otherwise freely chosen) map name that was used in
+# pg_hba.conf.  IDENT-USERNAME is the detected user name of the
+# client.  PG-USERNAME is the request PostgreSQL user name.  The
+# existence of a record specifies that IDENT-USERNAME may connect as
+# PG-USERNAME.  Multiple maps may be specified in this file and used
+# by pg_hba.conf.
+#
+# This file is read on server startup and when the postmaster receives
+# a SIGHUP signal.  If you edit the file on a running system, you have
+# to SIGHUP the postmaster for the changes to take effect, or use
+# "pg_ctl reload".
+
+# Put your actual configuration here
+# ----------------------------------
+#
+# No map names are defined in the default configuration.  If all ident
+# user names and PostgreSQL user names are the same, you don't need
+# this file.  Instead, use the special map name "sameuser" in
 # pg_hba.conf.
-# 
-# MAP     IDENT    PGUSERNAME
+
+# MAPNAME     IDENT-USERNAME    PG-USERNAME