Thread: Minor doc bug in 8.1.4

Minor doc bug in 8.1.4

From
Quinn Weaver
Date:
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. :)

Re: Minor doc bug in 8.1.4

From
Bruce Momjian
Date:
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. +