Re: [DOCS] pgcrypto links

2010-08-13 Thread Robert Haas
On Thu, Aug 12, 2010 at 4:34 PM, Kevin Grittner
 wrote:
> In looking for documentation of pgcrypto to respond to a user
> request for help, I noticed that we could have provided more links
> to help users find the docs for it.  Attached is a docs patch which
> is intended to help with that.

I don't think the index entry you've added to pgcrypto is very
appropriate, considering that there is a section with *exactly that
name* in runtime.sgml.

As for the reference from runtime.sgml to pgcrypto, how about adding
it inline, as in the attached?

-- 
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise Postgres Company


pgcrypto_docs.patch
Description: Binary data

-- 
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs


Re: [DOCS] pgcrypto links

2010-08-13 Thread Kevin Grittner
Robert Haas  wrote:
 
> I don't think the index entry you've added to pgcrypto is very
> appropriate, considering that there is a section with *exactly
> that name* in runtime.sgml.
 
That was intentional.  Did you look at what it generated on the
index page?
 
| encryption, Encryption Options
| for specific columns, pgcrypto
 
It seems to me that's a good thing, and we should do more of it.
 
> As for the reference from runtime.sgml to pgcrypto, how about
> adding it inline, as in the attached?
 
Absolutely.  I wanted to do that, but failed to figure out how.  Now
I know.
 
Thanks,
 
-Kevin

-- 
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs


Re: [DOCS] pgcrypto links

2010-08-13 Thread Robert Haas
On Fri, Aug 13, 2010 at 1:56 PM, Kevin Grittner
 wrote:
> Robert Haas  wrote:
>
>> I don't think the index entry you've added to pgcrypto is very
>> appropriate, considering that there is a section with *exactly
>> that name* in runtime.sgml.
>
> That was intentional.  Did you look at what it generated on the
> index page?

/me blushes

> | encryption, Encryption Options
> |     for specific columns, pgcrypto
>
> It seems to me that's a good thing, and we should do more of it.

Hmm, I think you might be right.  Anyone want to object?

>> As for the reference from runtime.sgml to pgcrypto, how about
>> adding it inline, as in the attached?
>
> Absolutely.  I wanted to do that, but failed to figure out how.  Now
> I know.

There's an easy-to-overlook file called README.links that is worth
reading, if unlike me you can remember where it is the next time
you're trying to do this sort of thing.

-- 
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise Postgres Company

-- 
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs