From: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
---|---|
To: | pgsql-hackers(at)lists(dot)postgresql(dot)org |
Cc: | John Naylor <jcnaylor(at)gmail(dot)com> |
Subject: | Documentation for bootstrap data conversion |
Date: | 2018-04-06 18:27:39 |
Message-ID: | 28827.1523039259@sss.pgh.pa.us |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-hackers |
I felt it was worth spending some extra effort on documentation for
this change, since it's going to impact a lot of future patches.
Accordingly, I've taken John's proposed README text and moved it
into the SGML format, and done a fair amount of editing to extend
the text and bring it all up to date.
The attached patch only touches bki.sgml, but I intend that
src/backend/catalog/README would go away altogether, and we'd
likewise get rid of the separate README.data file that John proposed.
Pretty much all the useful info in those files is here in some form.
One question is whether it's worth renaming bki.sgml to something
more in keeping with its new focus. I'm inclined not to, because
presumably that would also entail changing the chapter ID to something
else, and I'm not sure how well our documentation website would cope
with that.
John and I are probably both too close to the patch to be able to
review this documentation for clarity and usefulness, so if anyone
else wants to have a look, please comment.
regards, tom lane
Attachment | Content-Type | Size |
---|---|---|
bootstrap-sgml-documentation.patch | text/x-diff | 28.9 KB |
From | Date | Subject | |
---|---|---|---|
Next Message | Magnus Hagander | 2018-04-06 18:31:42 | Re: [PATCH] pg_hba.conf : new auth option : clientcert=verify-full |
Previous Message | Alexander Korotkov | 2018-04-06 18:19:23 | Re: pgsql: New files for MERGE |