From 0688e7204874a70b169df70f327047e20dc93a38 Mon Sep 17 00:00:00 2001 From: Martin Pitt <martin@piware.de> Date: Thu, 3 Feb 2005 21:36:59 +0000 Subject: [PATCH] pod'ify pg_wrapper manpage --- postgresql-common-1/debian/rules | 2 +- postgresql-common-1/pg_wrapper | 36 ++++++++++++++++++++++++++++++++ postgresql-common-1/pg_wrapper.1 | 36 -------------------------------- 3 files changed, 37 insertions(+), 37 deletions(-) delete mode 100644 postgresql-common-1/pg_wrapper.1 diff --git a/postgresql-common-1/debian/rules b/postgresql-common-1/debian/rules index 5fd2ab15..b03a6fa5 100755 --- a/postgresql-common-1/debian/rules +++ b/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 diff --git a/postgresql-common-1/pg_wrapper b/postgresql-common-1/pg_wrapper index ecc7e555..20f80f88 100755 --- a/postgresql-common-1/pg_wrapper +++ b/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>> diff --git a/postgresql-common-1/pg_wrapper.1 b/postgresql-common-1/pg_wrapper.1 deleted file mode 100644 index 2b67bb7f..00000000 --- a/postgresql-common-1/pg_wrapper.1 +++ /dev/null @@ -1,36 +0,0 @@ -.\" 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> -- GitLab