Hi,

I just noticed a tiny but annoying documentation bug:

pg_hba.conf (/etc/postgresql/8.1/main/pg_hba.conf on my Ubuntu system)
begins with this comment:

# PostgreSQL Client Authentication Configuration File
# ================================================== =
#
# Refer to the PostgreSQL Administrator's Guide, chapter "Client
# Authentication" for a complete description. A short synopsis
# follows.

However, there _is_ no PostgreSQL Administrator's Guide; as of 7.4,
the PostgreSQL Guides were combined into a single Manual. So the
comment is somewhat misleading.

It took me a few minutes of head-scratching, local system searching,
and web searching to ascertain this. Fixing the bug would save
future pg newbies from this fate.

Thanks for helping make PostgreSQL, whoever you are; you rock.

---------------------------(end of broadcast)---------------------------
TIP 9: In versions below 8.0, the planner will ignore your desire to
choose an index scan if your joining column's datatypes do not
match

Thanks, text updated to:

# Refer to the "Client Authentication" section in the
# PostgreSQL documentation for a complete description
# of this file. A short synopsis follows.

---------------------------------------------------------------------------

Quinn Weaver wrote:
> Hi,
>
> I just noticed a tiny but annoying documentation bug:
>
> pg_hba.conf (/etc/postgresql/8.1/main/pg_hba.conf on my Ubuntu system)
> begins with this comment:
>
> # PostgreSQL Client Authentication Configuration File
> # ================================================== =
> #
> # Refer to the PostgreSQL Administrator's Guide, chapter "Client
> # Authentication" for a complete description. A short synopsis
> # follows.
>
> However, there _is_ no PostgreSQL Administrator's Guide; as of 7.4,
> the PostgreSQL Guides were combined into a single Manual. So the
> comment is somewhat misleading.
>
> It took me a few minutes of head-scratching, local system searching,
> and web searching to ascertain this. Fixing the bug would save
> future pg newbies from this fate.
>
> Thanks for helping make PostgreSQL, whoever you are; you rock.
>
> ---------------------------(end of broadcast)---------------------------
> TIP 9: In versions below 8.0, the planner will ignore your desire to
> choose an index scan if your joining column's datatypes do not
> match

--
Bruce Momjian bruce@momjian.us
EnterpriseDB http://www.enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +

---------------------------(end of broadcast)---------------------------
TIP 6: explain analyze is your friend