Gentoo Logo
Gentoo Spaceship




Note: Due to technical difficulties, the Archives are currently not up to date. GMANE provides an alternative service for most mailing lists.
c.f. bug 424647
List Archive: gentoo-doc
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Headers:
To: gentoo-doc@g.o
From: David Abbott <dabbott@g.o>
Subject: Re: RFC: PostgreSQL Documentation
Date: Sat, 23 Jul 2011 15:56:18 -0400
On Sat, Jul 23, 2011 at 3:44 PM, David Abbott <dabbott@g.o> wrote:
> On Fri, Jul 22, 2011 at 8:57 AM, Aaron W. Swenson <titanofold@g.o> 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/
--- 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>

Replies:
Re: RFC: PostgreSQL Documentation
-- Aaron W. Swenson
References:
RFC: PostgreSQL Documentation
-- Aaron W. Swenson
Re: RFC: PostgreSQL Documentation
-- David Abbott
Navigation:
Lists: gentoo-doc: < Prev By Thread Next > < Prev By Date Next >
Previous by thread:
Re: RFC: PostgreSQL Documentation
Next by thread:
Re: RFC: PostgreSQL Documentation
Previous by date:
Re: RFC: PostgreSQL Documentation
Next by date:
Re: RFC: PostgreSQL Documentation


Updated Mar 27, 2012

Summary: Archive of the gentoo-doc mailing list.

Donate to support our development efforts.

Copyright 2001-2013 Gentoo Foundation, Inc. Questions, Comments? Contact us.