]> granicus.if.org Git - postgresql/commit
Standardize terminology for pg_statistic_ext entries.
authorTom Lane <tgl@sss.pgh.pa.us>
Sun, 14 May 2017 14:54:47 +0000 (10:54 -0400)
committerTom Lane <tgl@sss.pgh.pa.us>
Sun, 14 May 2017 14:55:01 +0000 (10:55 -0400)
commitf04c9a61468904b6815b2bc73a48878817766e0e
treeb8eb1b9a131023b1ab0f7e151e036988d02eb8a3
parent12ad38b3b4b5004001a525e0a0eda2ec45329e8e
Standardize terminology for pg_statistic_ext entries.

Consistently refer to such an entry as a "statistics object", not just
"statistics" or "extended statistics".  Previously we had a mismash of
terms, accompanied by utter confusion as to whether the term was
singular or plural.  That's not only grating (at least to the ear of
a native English speaker) but could be outright misleading, eg in error
messages that seemed to be referring to multiple objects where only one
could be meant.

This commit fixes the code and a lot of comments (though I may have
missed a few).  I also renamed two new SQL functions,
pg_get_statisticsextdef -> pg_get_statisticsobjdef
pg_statistic_ext_is_visible -> pg_statistics_obj_is_visible
to conform better with this terminology.

I have not touched the SGML docs other than fixing those function
names; the docs certainly need work but it seems like a separable task.

Discussion: https://postgr.es/m/22676.1494557205@sss.pgh.pa.us
31 files changed:
doc/src/sgml/func.sgml
src/backend/catalog/aclchk.c
src/backend/catalog/namespace.c
src/backend/catalog/objectaddress.c
src/backend/commands/alter.c
src/backend/commands/dropcmds.c
src/backend/commands/statscmds.c
src/backend/optimizer/util/plancat.c
src/backend/statistics/README
src/backend/statistics/README.dependencies
src/backend/statistics/dependencies.c
src/backend/statistics/extended_stats.c
src/backend/statistics/mvdistinct.c
src/backend/utils/adt/ruleutils.c
src/backend/utils/adt/selfuncs.c
src/backend/utils/cache/relcache.c
src/bin/pg_dump/pg_dump.c
src/bin/psql/describe.c
src/bin/psql/tab-complete.c
src/include/catalog/catversion.h
src/include/catalog/namespace.h
src/include/catalog/pg_proc.h
src/include/catalog/pg_statistic_ext.h
src/include/utils/acl.h
src/test/regress/expected/alter_generic.out
src/test/regress/expected/object_address.out
src/test/regress/expected/rules.out
src/test/regress/expected/stats_ext.out
src/test/regress/sql/object_address.sql
src/test/regress/sql/rules.sql
src/test/regress/sql/stats_ext.sql