Gpgsql2shp Documentation

Table of Contents

General
1. Introduction
1.1. What's New?
1.1.1. Version 0.2.0
2. Requirements
3. Installation
3.1. Installation Using the Installer
Reference
1. Usage
2. Configuration
2.1. Environment Variables
3. Commandline Usage
4. Troubleshooting
5. Security
6. Development
6.1. Release Process
Index

Table of Contents

1. Introduction
1.1. What's New?
1.1.1. Version 0.2.0
2. Requirements
3. Installation
3.1. Installation Using the Installer
1.1. What's New?
1.1.1. Version 0.2.0

Gpgsql2shp provides a graphical interface to create shapefiles from PostGIS databases.

Gpgsql2shp is available from http://polylinie.de/gpgsql2shp/index.html. It is free software released under the terms of the GPL license - the full source code is available (Open Source).

This manual describes Gpgsql2shp version 0.2.0.

1.1.1. Version 0.2.0

A summary of changes in the different versions of the AV PostGIS Extension.

First public Gpgsql2shp release.

GTK+ version 2.6 or higher is required in order to use the Gpgsql2shp.

A PostgreSQL database witht the PostGIS extension is required.

3.1. Installation Using the Installer

How to install Gpgsql2shp.

How to install the Gpgsql2shp using the installer.

Download the GTK+ runtime installer and execute it.

Download the installer and execute it.

Table of Contents

1. Usage
2. Configuration
2.1. Environment Variables
3. Commandline Usage
4. Troubleshooting
5. Security
6. Development
6.1. Release Process

Run the program.

Fill in the required information.

Click on the OK button.

Review the message.

2.1. Environment Variables

A number of standard PostgreSQL environment variables are used by Gpgsql2shp, if they are set:

PGPASSWORD
PGHOST
PGPORT
PGDATABASE
PGUSER

Gpgsql2shp accepts the shapefile name as a commandline argument.

      Gpgsql2shp [shapefile]

Please report problems through the AVPGCon trackers.

Please include the full contents of the three output fields (commandline, output, errors).

[Caution]Caution

Gpgsql2shp stores the password temporarily in an enviroment variable. If this is not secure enough for you, please do not use Gpgsql2shp.

6.1. Release Process

The version number shall be derived from the packaged PostGIS version plus an additional digit for the actual extension.

PostgreSQL releases with security fixes trigger new Gpgsql2shp releases.

Update the version number in build.xml, installer/win32/gpgsql2shp.nsi and doc/en/gpgsql2shp.xml.

C

commandline, Commandline Usage
configuration, Configuration

D

development, Development

E

environment variable, Environment Variables

G

general, General
GTK+, Installation Using the Installer

I

installation, Installation
installer, Installation Using the Installer
introduction, Introduction

L

license, Introduction

N

news, What's New?

P

PGDATABASE, Environment Variables
PGHOST, Environment Variables
PGPASSWORD, Environment Variables
PGPORT, Environment Variables
PGUSER, Environment Variables

R

reference, Reference
release process, Release Process
requirements, Requirements

S

security, Security
support, Troubleshooting

T

troubleshooting, Troubleshooting

U

usage, Usage

V

version number, Development