I have shortened your paragraph to:

        Because Win32 is significantly different from the Unix platforms
        supported in previous releases, this port might have more bugs
        than other supported platforms in this release.   Please
        test it thoroughly before using it in production.

and made the change in release.sgml.  Do we need more?

Other wording I considered was:

  "we expect this port not to be as bug-free as other supported platforms"

but that is close to a double-negative.

In adding this now, I would also like to see a notice in a future
release at the point we think Win32 is as bug-free as Unix (or as
bug-free as the platform allows).  (And this might happen in a minor
8.0.X release.)

Again, my concern about this stuff is that you later have to undo what
you said.

---------------------------------------------------------------------------

Neil Conway wrote:
> Bruce Momjian wrote:
> > What text are people suggesting?
> 
> How do people feel about the attached doc patch?
> 
> Cheers,
> 
> Neil
> 

> Index: doc/src/sgml/release.sgml
> ===================================================================
> RCS file: /Users/neilc/local/cvs/pgsql-server/doc/src/sgml/release.sgml,v
> retrieving revision 1.288
> diff -c -r1.288 release.sgml
> *** doc/src/sgml/release.sgml 24 Aug 2004 00:06:50 -0000      1.288
> --- doc/src/sgml/release.sgml 26 Aug 2004 05:43:32 -0000
> ***************
> *** 28,47 ****
>         <listitem>
>          <para>
>           This is the first <productname>PostgreSQL</productname>
> !         release to natively run on Microsoft Windows as a server. It
> !         can run as a Windows service. This release supports NT-based
> !         Windows releases like Win2000, XP, Win2003.  Older releases
> !         like Windows 95, 98, and ME are not supported because these
> !         operating systems do not have the infrastructure to support
> !         <productname>PostgreSQL</productname>.  A separate installer
> !         project has been created to ease installation on Windows:
>           <ulink url="http://pgfoundry.org/projects/pginstaller";>
>           http://pgfoundry.org/projects/pginstaller</ulink>.
>          </para>
> !        <para>
> !         Previous releases required the Unix emulation toolkit Cygwin for
> !         Win32 server support. <productname>PostgreSQL</productname>
> !         has always supported clients on Win32.
>          </para>
>         </listitem>
>        </varlistentry>
> --- 28,65 ----
>         <listitem>
>          <para>
>           This is the first <productname>PostgreSQL</productname>
> !         release to natively run on Microsoft Windows as a server. This
> !         release supports Windows 2000, XP, and 2003. Older releases of
> !         Windows are not supported because they lack the infrastructure
> !         necessary to support <productname>PostgreSQL</productname>. A
> !         separate installer project has been created to allow for easy
> !         installation on Windows:
>           <ulink url="http://pgfoundry.org/projects/pginstaller";>
>           http://pgfoundry.org/projects/pginstaller</ulink>.
>          </para>
> ! 
> !        <warning>
> !         <para>
> !          This is the first release of <productname>PostgreSQL</> to
> !          natively support Win32. As a result, the Windows port of
> !          <productname>PostgreSQL</> is less mature and likely less
> !          stable than <productname>PostgreSQL</> on Unix. While we have
> !          done our best to produce a high-quality release for Windows,
> !          users accustomed to the stability and maturity of
> !          <productname>PostgreSQL</> on Unix may not be satisfied by
> !          the current state of <productname>PostgreSQL</> on
> !          Windows. We expect the maturity of the Windows port to
> !          significantly increase in the future. We encourage all
> !          prospective users of <productname>PostgreSQL</> on Windows to
> !          carefully evaluate the database system before putting it into
> !          production use.
> !         </para>
> !        </warning>
> ! 
> !        <para>
> !         Previous releases required the Unix emulation toolkit Cygwin
> !         for Win32 server support. <productname>PostgreSQL</> has
> !         supported clients on Win32 for a long time.
>          </para>
>         </listitem>
>        </varlistentry>

-- 
  Bruce Momjian                        |  http://candle.pha.pa.us
  [EMAIL PROTECTED]               |  (610) 359-1001
  +  If your life is a hard drive,     |  13 Roberts Road
  +  Christ can be your backup.        |  Newtown Square, Pennsylvania 19073

---------------------------(end of broadcast)---------------------------
TIP 2: you can get off all lists at once with the unregister command
    (send "unregister YourEmailAddressHere" to [EMAIL PROTECTED])

Reply via email to