This commit is contained in:
Bruce Momjian 1999-12-05 20:04:42 +00:00
parent ed62104ea9
commit 66f8da0756
4 changed files with 412 additions and 11375 deletions

197
doc/src/sgml/ref/Makefile Normal file
View File

@ -0,0 +1,197 @@
#----------------------------------------------------------------------------
#
# Makefile
# Postgres documentation makefile
# Thomas Lockhart
#
# Copyright (c) 1994, Regents of the University of California
#
#
# IDENTIFICATION
# $Header: /cvsroot/pgsql/doc/src/sgml/ref/Attic/Makefile,v 1.1 1999/12/05 20:04:39 momjian Exp $
#
#----------------------------------------------------------------------------
PGDOCS= ../..
SRCDIR= ../../../src
# This is where the default stylesheets appear on my linux system.
# Probably no need to change this; rather, put definitions
# for HSTYLE and PSTYLE and/or for HDSL and PDSL
# in Makefile.custom in your code src directory.
#HSTYLE=/usr/lib/sgml/stylesheets/nwalsh-modular/html
#PSTYLE=/usr/lib/sgml/stylesheets/nwalsh-modular/print
# This is where the production stylesheets appear on postgresql.org
HSTYLE= /home/users/t/thomas/db118.d/docbook/html
PSTYLE= /home/users/t/thomas/db118.d/docbook/print
HDSL=$(HSTYLE)/docbook.dsl
PDSL=$(PSTYLE)/docbook.dsl
# Options for DocBook style sheets
DBOPTS= -D ref -D ../graphics
#DBOPTS+= -V %no-split-output% -V %no-make-index%
# use-id-as-filename picks up the "Id=" fields to use as file names.
# If this is omitted then file names are generic "c01.htm"
# as in v6.3 documentation. Yuck.
DBOPTS+= -V %use-id-as-filename%
# docbook2man generates man pages from docbook refentry source code.
# This is where the (patched) docbook2man perl scripts reside on hub.org.
D2MDIR= /home/users/t/thomas/d2x/docbook2man
D2MSCRIPT= $(D2MDIR)/docbook2man-spec.pl
TAR= tar
# Pick up Makefile.global from the source area
# This is the only resource from the code source area and is optional.
# Actually, we want this to get Makefile.custom - thomas 1998-03-01
ifneq ($(wildcard $(SRCDIR)/Makefile.global),)
include $(SRCDIR)/Makefile.global
endif
# Hmm, made this optional but jade _really_ doesn't like them missing
# - thomas 1998-03-01
ifneq ($(HDSL), )
HTMLOPTS= -d $(HDSL)
endif
ifneq ($(PDSL), )
PRINTOPTS= -d $(PDSL)
endif
vpath %.sgml ./ref
MANSOURCES= $(wildcard ref/*.sgml)
APPLICATIONS= createdb.sgml createuser.sgml \
createlang.sgml \
dropdb.sgml dropuser.sgml \
droplang.sgml \
initdb.sgml initlocation.sgml \
ipcclean.sgml \
pg_dump.sgml \
pg_dumpall.sgml \
pg_upgrade.sgml \
pgaccess-ref.sgml \
pgadmin-ref.sgml \
pgtclsh.sgml \
pgtksh.sgml \
postgres-ref.sgml \
postmaster.sgml \
psql-ref.sgml \
vacuumdb.sgml
COMMANDS= abort.sgml alter_table.sgml alter_user.sgml \
begin.sgml \
close.sgml cluster.sgml commit.sgml copy.sgml \
create_aggregate.sgml create_database.sgml create_function.sgml create_index.sgml \
create_language.sgml create_operator.sgml create_rule.sgml create_sequence.sgml \
create_table.sgml create_table_as.sgml create_trigger.sgml create_type.sgml \
create_user.sgml create_view.sgml \
declare.sgml delete.sgml \
drop_aggregate.sgml drop_database.sgml drop_function.sgml drop_index.sgml \
drop_language.sgml drop_operator.sgml drop_rule.sgml drop_sequence.sgml \
drop_table.sgml drop_trigger.sgml drop_type.sgml drop_user.sgml drop_view.sgml \
explain.sgml fetch.sgml grant.sgml \
insert.sgml listen.sgml load.sgml lock.sgml move.sgml \
notify.sgml \
reset.sgml revoke.sgml rollback.sgml \
select.sgml select_into.sgml set.sgml show.sgml \
unlisten.sgml update.sgml vacuum.sgml
FUNCTIONS= current_date.sgml current_time.sgml current_timestamp.sgml current_user.sgml
#APPSOURCES= $(addprefix ref/, $(APPLICATIONS))
#SQLSOURCES= $(addprefix ref/, $(COMMANDS))
APPSOURCES= $(APPLICATIONS)
SQLSOURCES= $(COMMANDS)
XAPPTARGETS= $(APPLICATIONS:.sgml=.1)
APPTARGETS= $(XAPPTARGETS:-ref.1=.1)
XSQLTARGETS= $(COMMANDS:.sgml=.l)
SQLTARGETS= $(XSQLTARGETS:-ref.l=.l)
.PRECIOUS: postgres.tex postgres.dvi
.PHONY: install all clean distclean
install::
all::
man:
$(MAKE) man1 manl
($(RM) -r *.1 *.l man1 manl)
$(MAKE) man1 manl
manpage.refs:
$(MAKE) man
man1: $(APPTARGETS) manpage.refs
$(RM) -rf man1
if [ ! -d man1 ]; then mkdir man1; fi
cp *.1 man1/
manl: $(SQLTARGETS) manpage.refs
$(RM) -rf manl/*
if [ ! -d manl ]; then mkdir manl; fi
cp *.l manl/
clean::
(rm -rf HTML.manifest *.html *.htm *.1 *.l man1 manl manpage*)
distclean::
$(MAKE) clean
#
# Generic production rules
#
%.1: %-ref.sgml
nsgmls $(NSGMLS_FLAGS) refentry.sgml $< \
| sgmlspl $(D2MSCRIPT) --lowercase --blockformat --section 1
%.1: %.sgml
nsgmls $(NSGMLS_FLAGS) refentry.sgml $< \
| sgmlspl $(D2MSCRIPT) --lowercase --blockformat --section 1
%.l: %.sgml
nsgmls $(NSGMLS_FLAGS) refentry.sgml $< \
| sgmlspl $(D2MSCRIPT) --lowercase --blockformat --section l
# HTML
# Include some softlinks to the generic default file names
%.html: %.sgml #$(HDSL)
(rm -rf *.htm)
jade $(DBOPTS) $(HTMLOPTS) -t sgml $<
(ln -sf $*.htm index.html)
(ln -sf $*.htm $*.html)
# RTF to allow minor editing for hardcopy
# This is used for v6.3 docs
%.rtf: %.sgml #$(PDSL)
jade $(DBOPTS) $(PRINTOPTS) -t rtf $<
# TeX and DVI
%.tex: %.sgml #$(PDSL)
jade $(DBOPTS) $(PRINTOPTS) -t tex $<
%.dvi: %.tex
jadetex $<
jadetex $<
# Postscript from TeX
%.ps: %.dvi
dvips -o $@ $<
# Graphics
%.gif:
cp -p ../graphics/$@ .

View File

@ -0,0 +1,215 @@
<!--
$Header: /cvsroot/pgsql/doc/src/sgml/ref/droplang.sgml,v 1.1 1999/12/05 20:04:39 momjian Exp $
Postgres documentation
-->
<refentry id="APP-DROPLANG">
<refmeta>
<refentrytitle id="APP-DROPLANG-TITLE">
<application>droplang</application>
</refentrytitle>
<refmiscinfo>Application</refmiscinfo>
</refmeta>
<refnamediv>
<refname id="droplang">
<application>droplang</application>
</refname>
<refpurpose>
Remove a programming language from a <productname>PostgreSQL</productname> database
</refpurpose>
</refnamediv>
<refsynopsisdiv>
<refsynopsisdivinfo>
<date>1999-12-05</date>
</refsynopsisdivinfo>
<synopsis>
droplang [ <replaceable class="parameter">connection options</replaceable> ] [ <replaceable class="parameter">langname</replaceable> [ <replaceable class="parameter">dbname</replaceable> ] ]
droplang [ <replaceable class="parameter">connection options</replaceable> ] --list|-l
</synopsis>
<refsect2 id="R2-APP-DROPLANG-1">
<title>
Inputs
</title>
<para>
<application>droplang</application> accepts the following command line arguments:
<variablelist>
<varlistentry>
<term><replaceable class="parameter">langname</replaceable></term>
<listitem>
<para>
Specifies the name of the backend programming language to be removed.
<application>droplang</application> will prompt for
<replaceable class="parameter">langname</replaceable>
if it is not specified on the command line.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>[-d, --dbname] <replaceable class="parameter">dbname</replaceable></term>
<listitem>
<para>
Specifies from which database the language should be removed.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-l, --list</term>
<listitem>
<para>
Shows a list of already installed languages in the target database
(which must be specified).
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
<application>droplang</application> also accepts
the following command line arguments for connection parameters:
<variablelist>
<varlistentry>
<term>-h, --host <replaceable class="parameter">host</replaceable></term>
<listitem>
<para>
Specifies the hostname of the machine on which the
<application>postmaster</application>
is running.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-p, --port <replaceable class="parameter">port</replaceable></term>
<listitem>
<para>
Specifies the Internet TCP/IP port or local Unix domain socket file
extension on which the <application>postmaster</application>
is listening for connections.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-U, --username <replaceable class="parameter">username</replaceable></term>
<listitem>
<para>
Username to connect as.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-W, --password</term>
<listitem>
<para>
Force password prompt.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>-e, --echo</term>
<listitem>
<para>
Echo the commands that <application>droplang</application> generates
and sends to the backend.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect2>
<refsect2 id="R2-APP-DROPLANG-2">
<refsect2info>
<date>1999-12-05</date>
</refsect2info>
<title>
Outputs
</title>
<para>
Most error messages are self-explanatory. If not, run
<application>droplang</application> with the <option>--echo</option>
option and see under the respective <acronym>SQL</acronym> command
for details. Check also under <xref linkend="APP-PSQL" endterm="APP-PSQL-title">
for more possibilities.
</para>
<para>
No output is generated if <application>droplang</application> succeeds.
</para>
</refsect2>
</refsynopsisdiv>
<refsect1 id="R1-APP-DROPLANG-1">
<refsect1info>
<date>1999-12-05</date>
</refsect1info>
<title>
Description
</title>
<para>
<application>droplang</application> is a utility for removing an
existing programming language from a
<productname>PostgreSQL</productname> database.
<application>droplang</application> currently accepts two
languages, <literal>plsql</literal> and <literal>pltcl</literal>.
</para>
<para>
Although backend programming languages can be removed directly using
several <acronym>SQL</acronym> commands, it is recommended to use
<application>droplang</application> because it performs a number
of checks and is much easier to use. See
<xref linkend="sql-droplanguage" endterm="sql-droplanguage-title">
for more.
</para>
</refsect1>
<refsect1 id="R1-APP-DROPLANG-2">
<title>
Notes
</title>
<para>
Use <xref linkend="app-createlang" endterm="app-createlang-title">
to add a language.
</para>
</refsect1>
<refsect1 id="R1-APP-DROPLANG-3">
<title>
Usage
</title>
<para>
To remove <literal>pltcl</literal>:
<programlisting>
$ droplang pltcl
</programlisting>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:nil
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:"../reference.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:"/usr/lib/sgml/catalog"
sgml-local-ecat-files:nil
End:
-->

Binary file not shown.

File diff suppressed because it is too large Load Diff