Thread: Doc bug

The documentation at <a
href="http://www.postgresql.org/docs/8.2/interactive/config-setting.html">http://www.postgresql.org/docs/8.2/interactive/config-setting.html</a>
statesthat:<br /><br />Boolean values may be written as <tt class="LITERAL">ON</tt>, <tt class="LITERAL">OFF</tt>, <tt
class="LITERAL">TRUE</tt>,<tt class="LITERAL">FALSE</tt>, <tt class="LITERAL">YES</tt>, <tt class="LITERAL">NO</tt>,
<ttclass="LITERAL">1</tt>, <tt class="LITERAL">0</tt> (all case-insensitive) or any unambiguous prefix of these.<br
/><br/>But the following doesn't work:<br /><br />postgres=# set enable_seqscan = of;<br />ERROR:  parameter
"enable_seqscan"requires a Boolean value <br />postgres=#<br /><br />'of' is an unambiguous prefix of OFF, but it
clearlydoesn't work. Is it the documentation that needs fix or is it the code?<br /><br />I tried the following too:<br
/><br/>set enable_seqscan = "of"; -- doesn't work <br /> set enable_seqscan = "off"; -- works<br /><br />BTW, I tried
TR,TRU, FA, FAL, FALS, YE. They all work fine.<br /><br />Best regards,<br clear="all" /><br />-- <br
/>gurjeet[.singh]@EnterpriseDB.com<br/>singh.gurjeet@{ gmail | hotmail | yahoo }.com  

Gurjeet Singh wrote:
> Hi Jim,
>
>     The code has been fixed by Bruce in response to my bug#2851 (
> http://archives.postgresql.org/pgsql-bugs/2006-12/msg00191.php).
>
> BTW, I don't know how to make sure that the effect of a doc patch looks
> fine
> in a browser. I mean, how to view the doc/src/sgml/*.sgml in a browser,
> nicely formatted as we see on our website!
>



Docs for CVS HEAD can aleways be seen here:

http://momjian.us/main/writings/pgsql/sgml/

cheers

andrew

On Sun, 31 Dec 2006, Gurjeet Singh wrote:

> On 12/31/06, Andrew Dunstan <andrew@dunslane.net> wrote:
> >
> >
> > Gurjeet Singh wrote:
> > > BTW, I don't know how to make sure that the effect of a doc patch looks
> > > fine
> > > in a browser. I mean, how to view the doc/src/sgml/*.sgml in a browser,
> > > nicely formatted as we see on our website!
> > >
> >
> >
> >
> > Docs for CVS HEAD can aleways be seen here:
> >
> > http://momjian.us/main/writings/pgsql/sgml/
>
>
> I meant, before submitting the patch, or while even working on it, I would
> like to see it's rendering on my local machine, from the sources. One would
> like to be sure that he used the correct (or more appropriate) tags while
> writing the patch.

cd pgsql/doc/src/sgml
make html

See
http://developer.postgresql.org/pgdocs/postgres/docguide-build.html

Gurjeet Singh wrote:
>     cd pgsql/doc/src/sgml
>     make html
> 
>     See
>     http://developer.postgresql.org/pgdocs/postgres/docguide-build.html
>     <http://developer.postgresql.org/pgdocs/postgres/docguide-build.html>
> 
> 
> This, obviously, isn't working on MinGW for me. I'll try Linux (Ubuntu).

If you're doing it on windows, see

http://people.planetpostgresql.org/mha/index.php?/archives/94-Building-the-PostgreSQL-docs-on-Windows.html#extended


for some hints.

//Magnus