Re: Documentation

Le 27/09/2010 10:00, Dave Page a écrit :
> On Sun, Sep 26, 2010 at 9:50 PM, Guillaume Lelarge
> <guillaume(at)lelarge(dot)info> wrote:
>>
>> See
>> http://developer.pgadmin.org/~guillaume/pgadmin_docs/_build/html/index.html.
>>
>> It took me three hours to manually convert the current documentation.
>> There is also a possibility to change the theme. I'll try to do it on my
>> laptop.
>
> Wow, that was quick (and unexpected!). There's some weirdness here,
> but maybe that's just a markup issue:
>
> http://developer.pgadmin.org/~guillaume/pgadmin_docs/_build/html/connect.html#connect
>
> ---
> If you select “Store password”, pgAdmin stores passwords you enter in
> the ~/.pgpass file under Unix or :file:%APPDATA%postgresqlpgpass.conf
> ---
>

Yes, there are probably a lot of weirdness. Not because of the tool, but
because of me. I think it would be hard for me to work on this before
this weekend. Crappy hotel (and when I say crappy, I really mean it...
or probably worse), and crappy internet connection.

> Otherwise it looks great. Couple of questions:
>
> - Have you thought about how we might shoe-horn this into the build process?
>

Not yet. Actually, my main issue is "what should we put on the repo?".
Only the .rst files? the whole project, including the Makefile? I didn't
set my mind yet on this issue.

> - Have you tried the htmlhelp output on Windows and Linux/Mac?
>

Not yet :) I'm waiting to have a windows box before working on this (ie
get back to my home).

--
Guillaume
http://www.postgresql.fr
http://dalibo.com