Documentation for bootstrap data conversion

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

Responses

Browse pgsql-hackers by date

  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