DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma;
	h=message-id:date:from:user-agent:mime-version:to:cc:subject
	:references:in-reply-to:content-type:content-transfer-encoding;
	b=fpLCEp+muXDH+fsClHZzD3nUHZIEFQqowWkbsyvKRspd+N1q2ZIUtS8PCXQnXhjYUd
	28sr0O/jS5ynAYlvKcP5423/I5ELkBsYWS0Z6nsOKAROcBC8wxAlV1NKYS9l/is73mSC
	oKled4PHTySXGKkNJMG1NhTn7wsH21zKx1BCM=
Message-ID: <4C359F7B.3020604@gmail.com>
Date: Thu, 08 Jul 2010 18:50:51 +0900
From: Satoshi Nagayasu <satoshi.nagayasu@gmail.com>
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; ja;
	rv:1.9.2.4) Gecko/20100608 Thunderbird/3.1
MIME-Version: 1.0
To: pgsql-interfaces@postgresql.org, pgsql-docs@postgresql.org
CC: Bruce Momjian <bruce@momjian.us>, Michael Meskes <meskes@postgresql.org>
Subject: Re: ECPG Documentation Improvement
References: <4C19E5B9.3040002@gmail.com>
In-Reply-To: <4C19E5B9.3040002@gmail.com>
Content-Type: text/plain; charset=ISO-2022-JP
Content-Transfer-Encoding: 7bit

Hi all,

As I mentioned, I have been working to improve the ECPG official manual,
trying to understand details, and adding more descriptions and examples
in a past few weeks.

I think now is the time to introduce this work again, and hope some of
you to look inside the new documents. And also I want to discuss how
to contribute to the official manual.

New ECPG manual (Zip file)
http://code.google.com/p/ecpgdocs/downloads/detail?name=ecpg_html.zip

Current ECPG manual
http://developer.postgresql.org/pgdocs/postgres/ecpg.html

I have refined and reorganized the ECPG manual from the viewpoint of
application developers who don't have deep knowledge about PostgreSQL
and its internals.

The work is still in progress, but the whole structure and the core
chapters have almost been fixed.

So, I want someone who is interested in the ECPG and/or documentation
to look inside the documents.

Any feedback and comments would be appreciated.

Regards,

On 2010/06/17 18:07, Satoshi Nagayasu wrote:
> Hi all,
> 
> I'm trying to improve the ECPG documents for the ECPG application
> developrs, because some of my clients want more detailed information
> when they develop (or migrate) an embeded SQL applications.
> Of course, I want to contribute this work to the official manual.
> 
> So I have one thing to introduce to you, and thing to ask you.
> 
> At first, I've done writing ECPG directives.
> I think it could be useful for the ECPG application developers,
> similar to the SQL reference section in the official manual.
> 
> ecpgdocs @ GoogleCode (I'm working here.)
> http://code.google.com/p/ecpgdocs/
> 
> ecpgdocs downloads (You can find the current document.)
> http://code.google.com/p/ecpgdocs/downloads/list?deleted=1&ts=1276763948
> 
> However, I'm not familiar with ECPG details or internals,
> so here is one asking, I hope someone to review my documents
> and give some feedback to me.
> 
> Feedbacks which I'm expecting are:
> 
> - Is this document useful?
> - Missing directives.
> - Missing or wrong synopsis.
> - More appropriate descriptions on parameters or examples.
> - How to contribute this to the official manual.
> - Correcting English. (sorry for my poor English.)
> - etc...
> 
> Honestly, I'm not familiar with the documentation acceptance/review process,
> so any advice and/or comments are welcome.
> 
> Regards,


-- 
NAGAYASU Satoshi <satoshi.nagayasu@gmail.com>