diff --git a/doc/FAQ_SCO b/doc/FAQ_SCO index 56a46f10445..6f7d2670a9f 100644 --- a/doc/FAQ_SCO +++ b/doc/FAQ_SCO @@ -1,9 +1,9 @@ ============================================================ -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) @@ -21,7 +21,7 @@ Topics: *) Readline *) Using the UDK on OpenServer *) Compiling PostgreSQL using the UDK -*) Reading the PostgreSQL man pages on UnixWare +*) Reading the PostgreSQL man pages *************************************************************************** @@ -125,52 +125,15 @@ This compiler bug seems to be fixed at least in *************************************************************************** -*) 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. diff --git a/doc/Makefile b/doc/Makefile index 233c6735506..341f473d0dc 100644 --- a/doc/Makefile +++ b/doc/Makefile @@ -4,16 +4,17 @@ # # 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. @@ -22,17 +23,47 @@ subdir = doc 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 -all: +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 + +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 @@ -40,12 +71,19 @@ ifdef found_html 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: @@ -53,5 +91,11 @@ ifdef found_html -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 diff --git a/doc/src/Makefile b/doc/src/Makefile index bb4f2352c46..6717f1f7727 100644 --- a/doc/src/Makefile +++ b/doc/src/Makefile @@ -1,5 +1,5 @@ # 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 = ../.. @@ -60,7 +60,7 @@ postgres.tar: man.tar: $(MAKE) -C sgml man - $(TAR) -cf $@ -C sgml man1 manl + $(TAR) -cf $@ -C sgml man1 man$(sqlmansect_dummy) # Generic production rules diff --git a/doc/src/sgml/Makefile b/doc/src/sgml/Makefile index e60ef8156c7..293fb6e7606 100644 --- a/doc/src/sgml/Makefile +++ b/doc/src/sgml/Makefile @@ -8,7 +8,7 @@ # # # 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 $ # #---------------------------------------------------------------------------- @@ -60,7 +60,7 @@ CATALOG = $(DOCBOOKSTYLE)/catalog .PHONY: man -DEFAULTSECTION := l +DEFAULTSECTION := $(sqlmansect_dummy) man: $(ALLSGML) $(NSGMLS) $(NSGMLS_FLAGS) $(srcdir)/book-decl.sgml $(srcdir)/reference.sgml \ diff --git a/src/Makefile.global.in b/src/Makefile.global.in index dc54dcd1e66..9a1aa8c5386 100644 --- a/src/Makefile.global.in +++ b/src/Makefile.global.in @@ -1,5 +1,5 @@ # -*-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, @@ -88,6 +88,7 @@ includedir_server = $(pkgincludedir)/server includedir_internal = $(pkgincludedir)/internal mandir := @mandir@ +sqlmansect_dummy = l docdir := @docdir@ ifeq "$(findstring pgsql, $(docdir))" "" diff --git a/src/backend/storage/lmgr/lock.c b/src/backend/storage/lmgr/lock.c index 7816a6c9689..82679eb65cb 100644 --- a/src/backend/storage/lmgr/lock.c +++ b/src/backend/storage/lmgr/lock.c @@ -8,7 +8,7 @@ * * * 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 @@ -65,8 +65,6 @@ static char *lock_mode_names[] = "AccessExclusiveLock" }; -static char *DeadLockMessage = "Deadlock detected.\n\tSee the lock(l) manual page for a possible cause."; - #ifdef LOCK_DEBUG @@ -953,7 +951,7 @@ WaitOnLock(LOCKMETHOD lockmethod, LOCKMODE lockmode, */ LOCK_PRINT("WaitOnLock: aborting on lock", lock, lockmode); SpinRelease(lockMethodTable->ctl->masterLock); - elog(ERROR, DeadLockMessage); + elog(ERROR, "deadlock detected"); /* not reached */ } diff --git a/src/interfaces/jdbc/org/postgresql/jdbc1/DatabaseMetaData.java b/src/interfaces/jdbc/org/postgresql/jdbc1/DatabaseMetaData.java index a87c34e771f..e1187b30947 100644 --- a/src/interfaces/jdbc/org/postgresql/jdbc1/DatabaseMetaData.java +++ b/src/interfaces/jdbc/org/postgresql/jdbc1/DatabaseMetaData.java @@ -1196,7 +1196,7 @@ public class DatabaseMetaData implements java.sql.DatabaseMetaData /** * What is the maximum number of columns in a table? From the - * create_table(l) manual page... + * CREATE TABLE reference page... * *
"The new class is created as a heap with no initial data. A * class can have no more than 1600 attributes (realistically, diff --git a/src/interfaces/jdbc/org/postgresql/jdbc2/DatabaseMetaData.java b/src/interfaces/jdbc/org/postgresql/jdbc2/DatabaseMetaData.java index bc47bbde9c1..6acfec1421d 100644 --- a/src/interfaces/jdbc/org/postgresql/jdbc2/DatabaseMetaData.java +++ b/src/interfaces/jdbc/org/postgresql/jdbc2/DatabaseMetaData.java @@ -1196,7 +1196,7 @@ public class DatabaseMetaData implements java.sql.DatabaseMetaData /** * What is the maximum number of columns in a table? From the - * create_table(l) manual page... + * CREATE TABLE reference page... * *
"The new class is created as a heap with no initial data. A * class can have no more than 1600 attributes (realistically, diff --git a/src/makefiles/Makefile.aix b/src/makefiles/Makefile.aix index a9ba100305c..f500a5f09b8 100644 --- a/src/makefiles/Makefile.aix +++ b/src/makefiles/Makefile.aix @@ -43,3 +43,5 @@ endif %$(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 diff --git a/src/makefiles/Makefile.beos b/src/makefiles/Makefile.beos index fa26c993542..7c79bcecd94 100644 --- a/src/makefiles/Makefile.beos +++ b/src/makefiles/Makefile.beos @@ -11,3 +11,5 @@ CFLAGS_SL = -fpic -DPIC %.so: %.o ln -fs $(top_srcdir)/src/backend/postgres _APP_ $(CC) -nostart -Xlinker -soname=$@ -o $@ _APP_ $< + +sqlmansect = 7 diff --git a/src/makefiles/Makefile.bsdi b/src/makefiles/Makefile.bsdi index 901e210fbb6..95eb123841f 100644 --- a/src/makefiles/Makefile.bsdi +++ b/src/makefiles/Makefile.bsdi @@ -22,3 +22,5 @@ endif %.so: %.o $(CC) -shared -o $@ $< + +sqlmansect = 7 diff --git a/src/makefiles/Makefile.darwin b/src/makefiles/Makefile.darwin index cfeba7f922f..b6619165b0c 100644 --- a/src/makefiles/Makefile.darwin +++ b/src/makefiles/Makefile.darwin @@ -6,3 +6,5 @@ CFLAGS_SL = -bundle -undefined suppress %.so: %.o $(CC) $(CFLAGS) $(CFLAGS_SL) -o $@ $< + +sqlmansect = 7 diff --git a/src/makefiles/Makefile.dgux b/src/makefiles/Makefile.dgux index c88ee14e0ea..f9519632a20 100644 --- a/src/makefiles/Makefile.dgux +++ b/src/makefiles/Makefile.dgux @@ -4,3 +4,5 @@ CFLAGS_SL = -fpic %.so: %.o $(CC) -shared -o $@ $< + +sqlmansect = 5 diff --git a/src/makefiles/Makefile.freebsd b/src/makefiles/Makefile.freebsd index 9f270c37fad..90543b7016a 100644 --- a/src/makefiles/Makefile.freebsd +++ b/src/makefiles/Makefile.freebsd @@ -21,3 +21,5 @@ else @rm -f $@ $(LD) -x -Bshareable -Bforcearchive -o $@ $@.pic endif + +sqlmansect = 7 diff --git a/src/makefiles/Makefile.hpux b/src/makefiles/Makefile.hpux index 1ed5130af08..cfdbee114b9 100644 --- a/src/makefiles/Makefile.hpux +++ b/src/makefiles/Makefile.hpux @@ -52,3 +52,5 @@ endif # shlib ... should go away, since this is not really enough knowledge) %.sl: %.o $(LD) -b -o $@ $< + +sqlmansect = 5 diff --git a/src/makefiles/Makefile.irix5 b/src/makefiles/Makefile.irix5 index d90fcd9a6eb..4062161d9ef 100644 --- a/src/makefiles/Makefile.irix5 +++ b/src/makefiles/Makefile.irix5 @@ -16,3 +16,5 @@ ifneq ($(GCC), yes) CFLAGS += -woff 1164,1171,1185,1195,1552 endif LDFLAGS += -Wl,-woff,15 -Wl,-woff,84 + +sqlmansect = 5sql diff --git a/src/makefiles/Makefile.linux b/src/makefiles/Makefile.linux index 31277151c96..2b204f9d853 100644 --- a/src/makefiles/Makefile.linux +++ b/src/makefiles/Makefile.linux @@ -8,3 +8,5 @@ CFLAGS_SL = -fpic %.so: %.o $(CC) -shared -o $@ $< + +sqlmansect = 7 diff --git a/src/makefiles/Makefile.netbsd b/src/makefiles/Makefile.netbsd index bcba61732fb..59ab7a791fd 100644 --- a/src/makefiles/Makefile.netbsd +++ b/src/makefiles/Makefile.netbsd @@ -24,3 +24,5 @@ else $(LD) -x -Bshareable -Bforcearchive \ -o $@ $@.pic endif + +sqlmansect = 7 diff --git a/src/makefiles/Makefile.openbsd b/src/makefiles/Makefile.openbsd index fbcc2e2e4bd..3709d24bdc2 100644 --- a/src/makefiles/Makefile.openbsd +++ b/src/makefiles/Makefile.openbsd @@ -22,3 +22,5 @@ else $(LD) -x -Bshareable -Bforcearchive \ -o $@ $@.pic endif + +sqlmansect = 7 diff --git a/src/makefiles/Makefile.osf b/src/makefiles/Makefile.osf index 2bf0cfe249e..4ee46ccd756 100644 --- a/src/makefiles/Makefile.osf +++ b/src/makefiles/Makefile.osf @@ -5,3 +5,5 @@ rpath = -rpath $(libdir) %.so: %.o $(LD) -shared -expect_unresolved '*' -o $@ $< + +sqlmansect = 5 diff --git a/src/makefiles/Makefile.qnx4 b/src/makefiles/Makefile.qnx4 index 2fb9d7bd193..23364955ed2 100644 --- a/src/makefiles/Makefile.qnx4 +++ b/src/makefiles/Makefile.qnx4 @@ -15,3 +15,5 @@ CFLAGS_SL = override CXXFLAGS +=-I/usr/local/include/g++ override CFLAGS +=-I/usr/local/include + +sqlmansect = 7 diff --git a/src/makefiles/Makefile.sco b/src/makefiles/Makefile.sco index a2fedb22f0d..4cd2bcfe2f3 100644 --- a/src/makefiles/Makefile.sco +++ b/src/makefiles/Makefile.sco @@ -16,3 +16,4 @@ endif %.so: %.o $(LD) -G -Bdynamic -o $@ $< +sqlmansect = 7 diff --git a/src/makefiles/Makefile.solaris b/src/makefiles/Makefile.solaris index 56fb5c5f058..4425bc45b35 100644 --- a/src/makefiles/Makefile.solaris +++ b/src/makefiles/Makefile.solaris @@ -1,4 +1,4 @@ -# $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 @@ -24,3 +24,5 @@ endif %.so: %.o $(LD) -G -Bdynamic -o $@ $< + +sqlmansect = 5sql diff --git a/src/makefiles/Makefile.sunos4 b/src/makefiles/Makefile.sunos4 index c45f44d0998..f9e9fc63d90 100644 --- a/src/makefiles/Makefile.sunos4 +++ b/src/makefiles/Makefile.sunos4 @@ -15,3 +15,4 @@ endif %.so: %.o $(LD) -assert pure-text -Bdynamic -o $@ $< +sqlmansect = 7 diff --git a/src/makefiles/Makefile.svr4 b/src/makefiles/Makefile.svr4 index 9704f1a1d64..7a01c5c944e 100644 --- a/src/makefiles/Makefile.svr4 +++ b/src/makefiles/Makefile.svr4 @@ -10,3 +10,5 @@ CFLAGS_SL = %.so: %.o $(LD) -G -Bdynamic -o $@ $< + +sqlmansect = 5 diff --git a/src/makefiles/Makefile.ultrix4 b/src/makefiles/Makefile.ultrix4 index 1c03737756f..e9acbc8d462 100644 --- a/src/makefiles/Makefile.ultrix4 +++ b/src/makefiles/Makefile.ultrix4 @@ -8,3 +8,5 @@ CFLAGS_SL = -G 0 %.so: %.c $(CC) -c -G 0 $(CPPFLAGS) $(CFLAGS) -o $@ $< + +sqlmansect = 7 diff --git a/src/makefiles/Makefile.univel b/src/makefiles/Makefile.univel index f91cf357e73..41e64616ef2 100644 --- a/src/makefiles/Makefile.univel +++ b/src/makefiles/Makefile.univel @@ -6,4 +6,4 @@ CFLAGS_SL = -K PIC %.so: %.o $(LD) -G -Bdynamic -o $@ $< -INSTALL= /usr/ucb/install +sqlmansect = 5 diff --git a/src/makefiles/Makefile.unixware b/src/makefiles/Makefile.unixware index bc2ddcad36d..0a437c9b0c3 100644 --- a/src/makefiles/Makefile.unixware +++ b/src/makefiles/Makefile.unixware @@ -19,3 +19,5 @@ endif %.so: %.o $(LD) -G -Bdynamic -o $@ $< + +sqlmansect = 5sql diff --git a/src/makefiles/Makefile.win b/src/makefiles/Makefile.win index 7fce66b1ace..cca9bcbbe0f 100644 --- a/src/makefiles/Makefile.win +++ b/src/makefiles/Makefile.win @@ -1,4 +1,4 @@ -# $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 @@ -33,3 +33,5 @@ override CPPFLAGS+= -DUSE_DL_IMPORT endif override javadir := '$(shell cygpath -w $(javadir))' + +sqlmansect = 7