============================================================
-Frequently Asked Questions (FAQ) for PostgreSQL V7.1
+Frequently Asked Questions (FAQ) for PostgreSQL 7.2
SCO UnixWare and OpenServer specific
to be read in conjunction with the installation instructions
============================================================
-last updated: $Date: 2001/03/13 20:52:04 $
+last updated: $Date: 2001/08/29 19:14:39 $
current maintainer: Billy G. Allie (Bill.Allie@mug.org)
original author: Andrew Merrill (andrew@compclass.com)
*) Readline
*) Using the UDK on OpenServer
*) Compiling PostgreSQL using the UDK
-*) Reading the PostgreSQL man pages on UnixWare
+*) Reading the PostgreSQL man pages
***************************************************************************
***************************************************************************
-*) Reading the PostgreSQL man pages on UnixWare
+*) Reading the PostgreSQL man pages
-By default, the PostgreSQL man pages are installed into /usr/local/pgsql/man.
-By default, UnixWare does not look there for man pages, so you will not be
-able to read them.
-
-You need to make the following changes to access the PostgreSQL man pages
-from UnixWare.
-
-1) You need to modify the MANPATH variable in /etc/default/man. I use:
+By default, the PostgreSQL man pages are installed into
+/usr/local/pgsql/man. By default, UnixWare does not look there for
+man pages. To be able to read them you need to modify the MANPATH
+variable in /etc/default/man. I use:
MANPATH=/usr/lib/scohelp/%L/man:/usr/dt/man:/usr/man:/usr/share/man:scohelp:/usr/local/man:/usr/local/pgsql/man
-2) Add a line that says '1sql' to /etc/default/manSection.
-
-3) The man pages for SQL commands are, by default, placed in section 'l'
- (normally used for "l"ocal pages). UnixWare does not support the 'l'
- section.
-
-The solution I use is to move all these pages from section 'l' to a section
-named '1sql'. To following KSH script will perform the move and change the
-section names in the man page:
-
-------------------------------8< CUT HERE >8------------------------------
-#!/bin/ksh
-cd /usr/local/pgsql/man
-mv man1 man.1
-mkdir man.1sql
-
-cd /usr/local/pgsql/man/manl
-for i in *.l
-do
- sed -e '/^\.TH/s/"l"/"1sql"/' \
- -e 's/\\fR(l)/\\fR(1sql)/' $i >../man.1sql/${i%.l}.1sql
-done
-cd /usr/local/pgsql/man
-rm -rf manl
-/usr/ucb/catman -M /usr/local/pgsql/man 1
-/usr/ucb/catman -M /usr/local/pgsql/man 1sql
-------------------------------8< CUT HERE >8------------------------------
-
-After running this script, you can view the man pages using the 'man'
-command. They will not be usable from the scohelp system.
-
-I am working on integrating the man pages into the scohelp system. When I
-generate a PostgreSQL package for UnixWare 7.x, the man pages will be
-integrated into the scohelp system.
-
-I have not tried using the PostgreSQL man pages on OpenServer. Volunteers??
+On OpenServer, some extra research needs to be invested to make the
+man pages usable, because the man system is a bit different from other
+platforms. Currently, PostgreSQL will not install them at all.
#
# Copyright (c) 1994, Regents of the University of California
#
-# $Header: /cvsroot/pgsql/doc/Makefile,v 1.20 2000/12/26 20:47:07 petere Exp $
+# $Header: /cvsroot/pgsql/doc/Makefile,v 1.21 2001/08/29 19:14:39 petere Exp $
#
#----------------------------------------------------------------------------
-# This directory doesn't build anything, it is only responsible for
-# installing the documenation. It is invoked automatically by the
-# top-level makefile. The files to be installed are prepared specially
-# and are placed in this directory during distribution bundling. In
-# CVS-based trees these files don't exist, so we skip the installation
-# in that case.
+# This makefile is responsible for installing the documentation. The
+# files to be installed are prepared specially and are placed in this
+# directory during distribution bundling. In CVS-based trees these
+# files don't exist, so we skip the installation in that case.
+#
+# Before we install the man pages, we massage the section numbers to
+# follow the local conventions.
#
# To actually build the documenation, look into the src/ and src/sgml
# subdirectories.
top_builddir = ..
include $(top_builddir)/src/Makefile.global
+.NOTPARALLEL:
ifneq ($(wildcard $(srcdir)/postgres.tar.gz),)
found_html := yes
endif
ifneq ($(wildcard $(srcdir)/man.tar.gz),)
+# SCO OpenServer's man system is sufficiently different to not bother.
+ifneq ($(PORTNAME), sco)
found_man := yes
endif
+endif
+
+
+ifdef found_man
+ifndef sqlmansect
+sqlmansect = 7
+endif
+sqlmansectnum = $(shell expr X'$(sqlmansect)' : X'\([0-9]\)')
+
+all: man1/.timestamp man$(sqlmansectnum)/.timestamp
+man1/.timestamp man$(sqlmansect_dummy)/.timestamp: man.tar.gz
+ gzip -d -c $< | $(TAR) xf -
+ for file in man1/*.1; do \
+ mv $$file $$file.bak && \
+ sed -e 's/\\fR($(sqlmansect_dummy))/\\fR($(sqlmansectnum))/' $$file.bak >$$file && \
+ rm $$file.bak || exit; \
+ done
+ @echo timestamp >man1/.timestamp
+ @echo timestamp >man$(sqlmansect_dummy)/.timestamp
-all:
+man$(sqlmansectnum)/.timestamp: man$(sqlmansect_dummy)/.timestamp
+ $(mkinstalldirs) man$(sqlmansectnum)
+ for file in man$(sqlmansect_dummy)/*.$(sqlmansect_dummy); do \
+ sed -e '/^\.TH/s/"$(sqlmansect_dummy)"/"$(sqlmansect)"/' \
+ -e 's/\\fR($(sqlmansect_dummy))/\\fR($(sqlmansectnum))/' \
+ $$file >man$(sqlmansectnum)/`basename $$file | sed 's/.$(sqlmansect_dummy)$$/.$(sqlmansect)/'` || exit; \
+ done
+ @echo timestamp >$@
+endif # found_man
install: all installdirs
gzip -d -c postgres.tar.gz | ( cd $(DESTDIR)$(docdir)/html && $(TAR) xf - )
endif
ifdef found_man
- gzip -d -c man.tar.gz | ( cd $(DESTDIR)$(mandir) && $(TAR) xf - )
+ for file in man1/*.1 man$(sqlmansectnum)/*.$(sqlmansect) ; do \
+ $(INSTALL_DATA) $$file $(DESTDIR)$(mandir)/$$file || exit; \
+ done
endif
installdirs:
- $(mkinstalldirs) $(DESTDIR)$(mandir) $(DESTDIR)$(docdir)/html
+ifdef found_html
+ $(mkinstalldirs) $(DESTDIR)$(docdir)/html
+endif
+ifdef found_man
+ $(mkinstalldirs) $(addprefix $(DESTDIR)$(mandir)/man, 1 $(sqlmansectnum))
+endif
uninstall:
-rm -f $(addprefix $(DESTDIR)$(docdir)/html/, $(shell gunzip -c $(srcdir)/postgres.tar.gz | tar tf -))
endif
ifdef found_man
- -rm -f $(addprefix $(DESTDIR)$(mandir)/, $(shell gunzip -c $(srcdir)/man.tar.gz | tar tf -))
+ -rm -f $(addprefix $(DESTDIR)$(mandir)/, $(shell gunzip -c $(srcdir)/man.tar.gz | tar tf - | sed -e 's,man$(sqlmansect_dummy)/,man$(sqlmansectnum)/,' -e 's/.$(sqlmansect_dummy)$$/.$(sqlmansect)/'))
endif
+
+
+clean:
+ rm -rf man1/ man$(sqlmansectnum)/ man$(sqlmansect_dummy)/
+
+distclean maintainer-clean: clean
# Postgres documentation makefile
-# $Header: /cvsroot/pgsql/doc/src/Makefile,v 1.18 2001/03/27 16:34:14 momjian Exp $
+# $Header: /cvsroot/pgsql/doc/src/Makefile,v 1.19 2001/08/29 19:14:39 petere Exp $
subdir = doc/src
top_builddir = ../..
man.tar:
$(MAKE) -C sgml man
- $(TAR) -cf $@ -C sgml man1 manl
+ $(TAR) -cf $@ -C sgml man1 man$(sqlmansect_dummy)
# Generic production rules
#
#
# IDENTIFICATION
-# $Header: /cvsroot/pgsql/doc/src/sgml/Makefile,v 1.37 2001/05/12 22:51:34 petere Exp $
+# $Header: /cvsroot/pgsql/doc/src/sgml/Makefile,v 1.38 2001/08/29 19:14:39 petere Exp $
#
#----------------------------------------------------------------------------
.PHONY: man
-DEFAULTSECTION := l
+DEFAULTSECTION := $(sqlmansect_dummy)
man: $(ALLSGML)
$(NSGMLS) $(NSGMLS_FLAGS) $(srcdir)/book-decl.sgml $(srcdir)/reference.sgml \
# -*-makefile-*-
-# $Header: /cvsroot/pgsql/src/Makefile.global.in,v 1.135 2001/08/28 14:20:26 petere Exp $
+# $Header: /cvsroot/pgsql/src/Makefile.global.in,v 1.136 2001/08/29 19:14:39 petere Exp $
#------------------------------------------------------------------------------
# All PostgreSQL makefiles include this file and use the variables it sets,
includedir_internal = $(pkgincludedir)/internal
mandir := @mandir@
+sqlmansect_dummy = l
docdir := @docdir@
ifeq "$(findstring pgsql, $(docdir))" ""
*
*
* IDENTIFICATION
- * $Header: /cvsroot/pgsql/src/backend/storage/lmgr/lock.c,v 1.92 2001/08/23 23:06:38 tgl Exp $
+ * $Header: /cvsroot/pgsql/src/backend/storage/lmgr/lock.c,v 1.93 2001/08/29 19:14:39 petere Exp $
*
* NOTES
* Outside modules can create a lock table and acquire/release
"AccessExclusiveLock"
};
-static char *DeadLockMessage = "Deadlock detected.\n\tSee the lock(l) manual page for a possible cause.";
-
#ifdef LOCK_DEBUG
*/
LOCK_PRINT("WaitOnLock: aborting on lock", lock, lockmode);
SpinRelease(lockMethodTable->ctl->masterLock);
- elog(ERROR, DeadLockMessage);
+ elog(ERROR, "deadlock detected");
/* not reached */
}
/**
* What is the maximum number of columns in a table? From the
- * create_table(l) manual page...
+ * CREATE TABLE reference page...
*
* <p>"The new class is created as a heap with no initial data. A
* class can have no more than 1600 attributes (realistically,
/**
* What is the maximum number of columns in a table? From the
- * create_table(l) manual page...
+ * CREATE TABLE reference page...
*
* <p>"The new class is created as a heap with no initial data. A
* class can have no more than 1600 attributes (realistically,
%$(DLSUFFIX): %.o %$(EXPSUFF)
@echo Making shared library $@ from $*.o, $*$(EXPSUFF) and postgres.imp
$(CC) -Wl,-H512 -Wl,-bM:SRE -Wl,-bI:$(top_builddir)/src/backend/$(POSTGRES_IMP) -Wl,-bE:$*$(EXPSUFF) -o $@ $*.o $(LDFLAGS) $(LIBS) $(LDFLAGS_SL)
+
+sqlmansect = 7
%.so: %.o
ln -fs $(top_srcdir)/src/backend/postgres _APP_
$(CC) -nostart -Xlinker -soname=$@ -o $@ _APP_ $<
+
+sqlmansect = 7
%.so: %.o
$(CC) -shared -o $@ $<
+
+sqlmansect = 7
%.so: %.o
$(CC) $(CFLAGS) $(CFLAGS_SL) -o $@ $<
+
+sqlmansect = 7
%.so: %.o
$(CC) -shared -o $@ $<
+
+sqlmansect = 5
@rm -f $@
$(LD) -x -Bshareable -Bforcearchive -o $@ $@.pic
endif
+
+sqlmansect = 7
# shlib ... should go away, since this is not really enough knowledge)
%.sl: %.o
$(LD) -b -o $@ $<
+
+sqlmansect = 5
CFLAGS += -woff 1164,1171,1185,1195,1552
endif
LDFLAGS += -Wl,-woff,15 -Wl,-woff,84
+
+sqlmansect = 5sql
%.so: %.o
$(CC) -shared -o $@ $<
+
+sqlmansect = 7
$(LD) -x -Bshareable -Bforcearchive \
-o $@ $@.pic
endif
+
+sqlmansect = 7
$(LD) -x -Bshareable -Bforcearchive \
-o $@ $@.pic
endif
+
+sqlmansect = 7
%.so: %.o
$(LD) -shared -expect_unresolved '*' -o $@ $<
+
+sqlmansect = 5
override CXXFLAGS +=-I/usr/local/include/g++
override CFLAGS +=-I/usr/local/include
+
+sqlmansect = 7
%.so: %.o
$(LD) -G -Bdynamic -o $@ $<
+sqlmansect = 7
-# $Header: /cvsroot/pgsql/src/makefiles/Makefile.solaris,v 1.6 2000/12/16 18:14:25 petere Exp $
+# $Header: /cvsroot/pgsql/src/makefiles/Makefile.solaris,v 1.7 2001/08/29 19:14:40 petere Exp $
AROPT = crs
%.so: %.o
$(LD) -G -Bdynamic -o $@ $<
+
+sqlmansect = 5sql
%.so: %.o
$(LD) -assert pure-text -Bdynamic -o $@ $<
+sqlmansect = 7
%.so: %.o
$(LD) -G -Bdynamic -o $@ $<
+
+sqlmansect = 5
%.so: %.c
$(CC) -c -G 0 $(CPPFLAGS) $(CFLAGS) -o $@ $<
+
+sqlmansect = 7
%.so: %.o
$(LD) -G -Bdynamic -o $@ $<
-INSTALL= /usr/ucb/install
+sqlmansect = 5
%.so: %.o
$(LD) -G -Bdynamic -o $@ $<
+
+sqlmansect = 5sql
-# $Header: /cvsroot/pgsql/src/makefiles/Attic/Makefile.win,v 1.13 2001/05/25 15:48:33 momjian Exp $
+# $Header: /cvsroot/pgsql/src/makefiles/Attic/Makefile.win,v 1.14 2001/08/29 19:14:40 petere Exp $
LDFLAGS+= -g
DLLTOOL= dlltool
DLLWRAP= dllwrap
endif
override javadir := '$(shell cygpath -w $(javadir))'
+
+sqlmansect = 7