I wrote:
> One thing I notice is that the "table" and "with" entries are not coming
> out as intended. The file names are all caps:
> -rw-r--r-- 1 tgl users 18 Jun 12 01:37 WITH.7
> -rw-r--r-- 1 tgl users 18 Jun 12 01:37 TABLE.7
> and the content surely isn't what was meant:
> $ more TABLE.7
> .so man7/SELECT.7
> $ more WITH.7
> .so man7/SELECT.7
BTW, as far as that particular point goes: maybe we could fix the tools
issues underlying this, but I'm tempted to think that it's not worth the
trouble, because making these man pages be aliases for SELECT is just
the Wrong Thing anyway. I think we should just split them off and have
them be documented as separate top-level reference pages. Doing that
for TABLE is clearly fairly sensible; and as for WITH, the current
approach is going to fail miserably anyhow as soon as we allow WITH
to be prefixed to INSERT/UPDATE/DELETE. Which is something that was
already requested, and I see no semantic or implementation reason not
to allow (in 8.5 of course, not now). So I'm thinking we make a man
page for WITH as such, and cross-reference it from SELECT, moving the
current discussion of CTEs over.
regards, tom lane