diff --git a/doc/src/sgml/installation.sgml b/doc/src/sgml/installation.sgml index 4487d0cfd1..2dc2b82d9a 100644 --- a/doc/src/sgml/installation.sgml +++ b/doc/src/sgml/installation.sgml @@ -75,7 +75,7 @@ su - postgres make programs or older GNU make versions will not work. (GNU make is sometimes installed under the name gmake.) To test for GNU - make enter: + make and check its version, enter: make --version @@ -385,8 +385,8 @@ su - postgres This script will run a number of tests to determine values for various system dependent variables and detect any quirks of your operating system, and finally will create several files in the - build tree to record what it found. You can also run - configure in a directory outside the source + build tree to record what it found. If it does not print any error messages, configuration was successful. + You can also run configure in a directory outside the source tree, if you want to keep the build directory separate. This procedure is also called a VPATHVPATH @@ -1610,6 +1610,15 @@ su - postgres All of PostgreSQL successfully made. Ready to install. + If you see an error message like: + +ERROR: `flex' is missing on your system. It is needed to create the +file `bootscanner.c'. You can either get flex from a GNU mirror site +or download an official distribution of PostgreSQL, which contains +pre-packaged flex output. + + then one or more of the packages PostgreSQL requires is not installed. + See for the required packages. diff --git a/doc/src/sgml/start.sgml b/doc/src/sgml/start.sgml index 5b73557835..4e3aaaac86 100644 --- a/doc/src/sgml/start.sgml +++ b/doc/src/sgml/start.sgml @@ -19,8 +19,8 @@ If you are not sure whether PostgreSQL - is already available or whether you can use it for your - experimentation then you can install it yourself. Doing so is not + is already available for your experimentation, + you can install it yourself. Doing so is not hard and it can be a good exercise. PostgreSQL can be installed by any unprivileged user; no superuser (root) @@ -83,7 +83,7 @@ - The user's client (frontend) application that wants to perform + The user's client (frontend), an application that wants to perform database operations. Client applications can be very diverse in nature: a client could be a text-oriented tool, a graphical application, a web server that accesses the database to @@ -99,7 +99,7 @@ As is typical of client/server applications, the client and the - server can be on different hosts. In that case they communicate + server can be on different machines or networks. In that case they communicate over a TCP/IP network connection. You should keep this in mind, because the files that can be accessed on a client machine might not be accessible (or might only be accessible using a different @@ -153,7 +153,7 @@ $ createdb mydb - If this produces no response then this step was successful and you can skip over the + If this exits without any error message then this step was successful and you can skip over the remainder of this section. @@ -168,7 +168,7 @@ createdb: command not found $ /usr/local/pgsql/bin/createdb mydb - The path at your site might be different. Contact your site + The path at your site's server might be different. Contact your site administrator or check the installation instructions to correct the situation. @@ -240,12 +240,11 @@ createdb: database creation failed: ERROR: permission denied to create database You can also create databases with other names. PostgreSQL allows you to create any - number of databases at a given site. Database names must have an - alphabetic first character and are limited to 63 bytes in - length. A convenient choice is to create a database with the same - name as your current user name. Many tools assume that database - name as the default, so it can save you some typing. To create - that database, simply type: + number of databases at a given site. Database names are limited to 63 bytes in + length. Database names longer than 63 bytes will be truncated. A convenient + choice is to create a database with the same name as your current user name. + Many tools assume that database name as the default, so it + can save you some typing. To create that database, simply type: $ createdb @@ -355,7 +354,7 @@ mydb=# The last line printed out by psql is the prompt, and it indicates that psql is listening - to you and that you can type SQL queries into a + to you and that you can type commands and SQL queries into a work space maintained by psql. Try out these commands: version