Add MinGW FAQ.

21 years ago · e95130e882
parent 1c24bf9096
commit e95130e882
2 changed files with 147 additions and 0 deletions
--- a/doc/FAQ_MINGW
+++ b/doc/FAQ_MINGW
@ -0,0 +1,62 @@
+
+                    PostgreSQL Native Win32 FAQ Using MinGW
+                                       
+   Last updated: Fri Oct 8 12:47:37 EDT 2004
+   
+   Current maintainer: Bruce Momjian (pgman@candle.pha.pa.us)
+   
+   The most recent version of this document can be viewed at
+   http://momjian.postgresql.org/main/writings/pgsql/project/win32.html.
+   
+   The native Win32 port is built from source using MinGW tools.  There
+   is also a precompiled binary installer called pginstaller which you
+   can download from http://pgfoundry.org/projects/pginstaller.  It is a
+   fully native build and uses no additional software like MinGW.
+   
+Tools for Building Binaries
+
+   The native Win32 port requires a 32-bit NT-based Microsoft operating
+   system, like Windows NT 4, Windows 2000/2003, or Windows XP. (NT 4
+   doesn't support tablespaces because it doesn't support the junction
+   points needed for symlinks.)  Earlier operating systems do not have
+   sufficient infrastructure. Building the port also requires MinGW and
+   Msys, which can be downloaded from http://www.mingw.org/. MinGW is a
+   Unix-like build environment for Microsoft operating systems. Msys is a
+   collection of unix tools required to run shell scripts like
+   configure.  Neither is required to run the resulting binaries;  they
+   are needed only for creating the binaries.  We have no intention of
+   supporting Visual C; their build environment is just too different
+   from Unix, and maintenance of such a build environment would be too
+   burdensome.
+   
+Steps For Building Binaries
+
+     * Download the nightly snapshot tarball from
+       ftp://ftp.postgresql.org/pub/dev or checkout via CVS (you will
+       need bison, flex, and perl installed to build from CVS)
+     * Run configure (you might need to add the --without-zlib argument,
+       depending on whether you have installed zlib on MinGW)
+     * Run make install
+       
+   Note:  it is suggested that you run psql under CMD.EXE., as the Msys
+   console has buffering issues.
+   If you make a change that you want to contribute, make a context diff
+   and send it to the mailing list.
+   
+Access
+
+   The mailing list for discussion is pgsql-hackers-win32@postgresql.org.
+   You can subscribe by sending an email body containing the word
+   subscribe to pgsql-hackers-win32-request@postgresql.org.
+   
+Resources
+
+   There are several resources that helped us complete this port:
+     * PeerDirect port of PostgreSQL 7.2 to Win32
+       (ftp://momjian.postgresql.org/pub/postgresql/win32/PeerDirect)
+     * CONNX Win32 signal
+       code(ftp://momjian.postgresql.org/pub/postgresql/win32/CONNX)
+     * SRA port of PostgreSQL to Win32 (unfortunately, this is not
+       publically available because the threaded portion is proprietary)
+     * CHM help files
+       (http://www.pgadmin.org/snapshots/help/en_US/pgadmin3.chm)
--- a/doc/src/FAQ/FAQ_MINGW.html
+++ b/doc/src/FAQ/FAQ_MINGW.html
@ -0,0 +1,85 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+  <meta http-equiv="content-type"
+ content="text/html; charset=ISO-8859-1">
+  <title>PostgreSQL Native Win32 Status Report</title>
+</head>
+<body>
+<h1 style="text-align: center;">PostgreSQL Native Win32 FAQ Using MinGW<br>
+</h1>
+<P>Last updated: Fri Oct  8 12:47:37 EDT 2004</P>
+<P>Current maintainer: Bruce Momjian (<A href=
+"mailto:pgman@candle.pha.pa.us">pgman@candle.pha.pa.us</A>)<BR>
+</P>
+
+<P>The most recent version of this document can be viewed at <A href=
+"http://momjian.postgresql.org/main/writings/pgsql/project/win32.html">
+http://momjian.postgresql.org/main/writings/pgsql/project/win32.html</A>.</P>
+
+<p>The native Win32 port is built from source using MinGW tools.&nbsp;
+There is also a precompiled binary installer called <span
+ style="font-style: italic;">pginstaller</span> which you can download
+from <a href="http://pgfoundry.org/projects/pginstaller">http://pgfoundry.org/projects/pginstaller</a>.&nbsp;
+It is a fully native build and uses no additional software like MinGW.<br>
+</p>
+<h2>Tools for Building Binaries<br>
+</h2>
+<p> The native Win32 port requires a 32-bit NT-based Microsoft
+operating
+system, like Windows NT 4, Windows 2000/2003, or Windows XP. (NT 4
+doesn't support tablespaces because it doesn't support the junction
+points needed for symlinks.)&nbsp; Earlier
+operating systems do not have sufficient infrastructure. Building the
+port also
+requires MinGW and Msys, which can be downloaded from <a
+ href="http://www.mingw.org/">http://www.mingw.org/</a>. MinGW is
+a Unix-like build environment for Microsoft operating systems.
+Msys is a collection of unix tools required to run shell scripts like <i>configure.&nbsp;
+</i>Neither is required to run the resulting binaries;&nbsp; they are
+needed only for creating the binaries.&nbsp; We have no intention
+of supporting Visual C; their build environment is just too different
+from Unix, and maintenance of such a build environment would be too
+burdensome.<br>
+</p>
+<h2>Steps For Building Binaries<br>
+</h2>
+<ul>
+  <li>Download the nightly snapshot tarball from <a
+ href="ftp://ftp.postgresql.org/pub/dev">ftp://ftp.postgresql.org/pub/dev</a>
+or checkout via CVS (you will need <i>bison, flex,</i> and <i>perl</i>
+installed to build from CVS)<br>
+  </li>
+  <li>Run <i>configure</i> (you might need to add the --without-zlib
+argument, depending on whether you have installed <span
+ style="font-style: italic;">zlib
+    </span>on MinGW)</li>
+  <li>Run <i>make install</i></li>
+</ul>
+Note:&nbsp; it is suggested that you run <i>psql</i> under <i>CMD.EXE.</i>,
+as the Msys console has buffering issues.<br>
+<br>
+If you make a change that you want to contribute, make a context diff
+and send
+it to the mailing list. <br>
+<h2>Access</h2>
+The mailing list for discussion is
+<i>pgsql-hackers-win32@postgresql.org</i>. You can subscribe by sending
+an email body containing the word <i>subscribe</i> to <i><a
+ href="mailto:pgsql-hackers-win32-request@postgresql.org">pgsql-hackers-win32-request@postgresql.org</a></i>.<br>
+<ul>
+</ul>
+<h2>Resources</h2>
+There are several resources that helped us complete this port:<br>
+<ul>
+  <li>PeerDirect port of PostgreSQL 7.2 to Win32 (<a
+ href="ftp://momjian.postgresql.org/pub/postgresql/win32/PeerDirect">ftp://momjian.postgresql.org/pub/postgresql/win32/PeerDirect</a>)</li>
+  <li>CONNX Win32 signal code(<a
+ href="ftp://momjian.postgresql.org/pub/postgresql/win32/CONNX">ftp://momjian.postgresql.org/pub/postgresql/win32/CONNX</a>)</li>
+  <li>SRA port of PostgreSQL to Win32 (unfortunately, this is not
+publically available because the threaded portion is proprietary)</li>
+  <li>CHM help files (<a
+ href="http://www.pgadmin.org/snapshots/help/en_US/pgadmin3.chm">http://www.pgadmin.org/snapshots/help/en_US/pgadmin3.chm</a>)</li>
+</ul>
+</body>
+</html>