From: David Abbott <dabbott@gentoo.org>
To: gentoo-doc@lists.gentoo.org
Subject: Re: [gentoo-doc] RFC: PostgreSQL Documentation
Date: Sat, 23 Jul 2011 15:56:18 -0400 [thread overview]
Message-ID: <CACs9S6ZmUNQdJiTqjhturU=e4UD0XZA2OSKXJh505yUaHPamSA@mail.gmail.com> (raw)
In-Reply-To: <CACs9S6a5RzJ7O=6L-bYqqbpEJkK+np9CZAxRm7LXL05U7Fdfig@mail.gmail.com>
[-- Attachment #1: Type: text/plain, Size: 1698 bytes --]
On Sat, Jul 23, 2011 at 3:44 PM, David Abbott <dabbott@gentoo.org> wrote:
> On Fri, Jul 22, 2011 at 8:57 AM, Aaron W. Swenson <titanofold@gentoo.org> wrote:
>> -----BEGIN PGP SIGNED MESSAGE-----
>> Hash: SHA256
>>
>> I think the documentation I've written[1] for PostgreSQL is pretty well
>> set to be published. I'm submitting it here for a final review.
>>
> Also This section;
> <p>
> You can change your locale and encoding selections at database creation time
> (<uri
> link="http://www.postgresql.org/docs/current/static/sql-createdatabase.html"><c>CREATE
> DATABASE</c></uri>). In order to change the locale for a database after you have
> created it, you must drop the database and start over again.
> </p>
> The c tags can't be inside the uri tag;
>
> postgresql.xml:410: element uri: validity error : Element c is not
> declared in uri list of possible children
> DATABASE</c></uri>). In order to change the locale for a database after you have
>
> I would change it so it reads a little clearer to somethin like;
>
> <p>
> You can change your locale and encoding selections at database <uri
> link="http://www.postgresql.org/docs/current/static/sql-createdatabase.html">creation
> time.</uri>). In order to change the locale for a database after you have
> created it, you must drop the database and start over again.
> </p>
I forgot to remove the ). after </uri>
I would also remove this section;
</body>
</section>
<section>
<title>Initialize</title>
<body>
<p>
To finish the installation:
</p>
I attached a diff from yours to the changes I made.
Regards,
David
--
David Abbott (dabbott)
Gentoo
http://dev.gentoo.org/~dabbott/
[-- Attachment #2: postgresql.xml.diff --]
[-- Type: text/plain, Size: 1308 bytes --]
--- postgresql.old.xml 2011-07-23 15:50:41.000000000 -0400
+++ postgresql.xml 2011-07-23 15:45:22.000000000 -0400
@@ -404,21 +404,10 @@
</p>
<p>
-You can change your locale and encoding selections at database creation time
-(<uri
-link="http://www.postgresql.org/docs/current/static/sql-createdatabase.html"><c>CREATE
-DATABASE</c></uri>). In order to change the locale for a database after you have
-created it, you must drop the database and start over again.
-</p>
-
-</body>
-</section>
-<section>
-<title>Initialize</title>
-<body>
-
-<p>
-To finish the installation:
+You can change your locale and encoding selections at database <uri
+ link="http://www.postgresql.org/docs/current/static/sql-createdatabase.html">creation
+ time.</uri> In order to change the locale for a database after you have
+created it, you must drop the database and start over again.
</p>
<pre caption="Finalize the installation">
@@ -625,7 +614,7 @@
<p>
At this point you are ready to continue on with the official <uri
-src="http://www.postgresql.org/docs/current/static/tutorial.html">PostgreSQL
+link="http://www.postgresql.org/docs/current/static/tutorial.html">PostgreSQL
Tutorial</uri>. The tutorial will guide you through creating roles, databases,
schemata and all that fun and useful stuff.
</p>
next prev parent reply other threads:[~2011-07-23 19:56 UTC|newest]
Thread overview: 8+ messages / expand[flat|nested] mbox.gz Atom feed top
2011-07-22 12:57 [gentoo-doc] RFC: PostgreSQL Documentation Aaron W. Swenson
2011-07-22 15:17 ` Sven Vermeulen
2011-07-22 18:29 ` Aaron W. Swenson
2011-07-23 16:43 ` Aaron W. Swenson
2011-07-23 18:51 ` David Abbott
2011-07-23 19:44 ` David Abbott
2011-07-23 19:56 ` David Abbott [this message]
2011-07-23 20:18 ` Aaron W. Swenson
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to='CACs9S6ZmUNQdJiTqjhturU=e4UD0XZA2OSKXJh505yUaHPamSA@mail.gmail.com' \
--to=dabbott@gentoo.org \
--cc=gentoo-doc@lists.gentoo.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox