Thread: pgcrypto links
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. -Kevin
Attachment
On Thu, Aug 12, 2010 at 4:34 PM, Kevin Grittner <Kevin.Grittner@wicourts.gov> 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
Attachment
Robert Haas <robertmhaas@gmail.com> 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
On Fri, Aug 13, 2010 at 1:56 PM, Kevin Grittner <Kevin.Grittner@wicourts.gov> wrote: > Robert Haas <robertmhaas@gmail.com> 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
On Fri, Aug 13, 2010 at 2:19 PM, Robert Haas <robertmhaas@gmail.com> wrote: > Hmm, I think you might be right. Anyone want to object? Apparently not. Committed, and back-patched to 8.4. -- Robert Haas EnterpriseDB: http://www.enterprisedb.com The Enterprise Postgres Company