pod'ify pg_wrapper manpage

postgresql-common-1/debian/rules

@@ -2,7 +2,7 @@
 include /usr/share/cdbs/1/rules/debhelper.mk
 
 POD2MAN=pod2man --center "Debian PostgreSQL infrastructure" -r "Debian"
-PODPROGS=pg_ctlcluster
+PODPROGS=pg_ctlcluster pg_wrapper
 
 build/postgresql-common::
 	for p in $(PODPROGS); do $(POD2MAN) $$p > $$p.1; done

postgresql-common-1/pg_wrapper

@@ -32,3 +32,39 @@ $ENV{'PGDATABASE'} = $db if $db;
 push @args, @ARGV;
 exec @args;
 
+__END__
+
+=head1 NAME
+
+pg_wrapper - wrapper for PostgreSQL client commands
+
+=head1 DESCRIPTION
+
+This program is run only as a link to names which correspond to PostgreSQL
+programs in B</usr/lib/postgresql/>I<version>B</bin>. It finds the correct
+cluster and database for the user and calls the correct version of the desired
+program to connect to that cluster and database, supplying any specifed options
+to that command.
+
+=head1 FILES
+
+=over
+
+=item B</etc/postgresql-common/user_clusters>
+
+stores the default cluster and database for users and groups as set by
+the administrators. 
+
+=item B<$HOME/.postgresqlrc>
+
+stores defaults set by the user himself.
+
+=back
+
+=head1 SEE ALSO
+
+L<pg_default(1)>, L<pg_exec(1)>
+
+=head1 AUTHOR
+
+Martin Pitt L<E<lt>mpitt@debian.orgE<gt>>

postgresql-common-1/pg_wrapper.1

-.\" Hey, Emacs!  This is an -*- nroff -*- source file.
-.\"
-.TH PG_WRAPPER 1 "October 2003" "Debian Project" "Debian Linux"
-.SH NAME
-pg_wrapper \- Wrapper program for PostgreSQL commands
-.SH DESCRIPTION
-.P
-This program is run only as a link to names
-which correspond to PostgreSQL programs in 
-.RI /usr/lib/postgresql/ version /bin.
-If the specified host is the local machine, it finds the correct
-cluster and database for the user and calls
-the correct version of the desired program to connect to that cluster and
-database, supplying any specifed options to that command.
-.P
-If a remote host is specified,
-.B pg_wrapper
-behaves like
-.B pg_exec.
-.SH FILES
-.TP
-.I /etc/postgresql-common/user_clusters 
-stores the default cluster and database for users and groups as set by
-the administrators.  By setting the FORCED flag for a user or group, it
-is possible for an administrator to override a
-user's choices so that the user can connect only to the cluster and
-database selected for him.
-.TP
-.I $HOME/.postgresqlrc
-stores defaults set by the user himself.
-
-.SH SEE ALSO
-.BR pg_default (1),
-.BR pg_exec (1)
-.SH AUTHOR
-Oliver Elphick <olly@lfix.co.uk>