Commit Graph

2518 Commits

Author SHA1 Message Date
Bruce Momjian 49d762f6aa Update TODO list. 2001-11-21 18:49:50 +00:00
Bruce Momjian e4ba691240 Update TODO list. 2001-11-21 18:49:10 +00:00
Bruce Momjian 370174b953 Move internals.ps to web cvs. 2001-11-21 15:38:15 +00:00
Thomas G. Lockhart 6c402eafc8 Deprecate 'current' date/time constant.
Purge "Postgres" in favor of "PostgreSQL" in docs. ref/ not yet done.
2001-11-21 06:09:45 +00:00
Thomas G. Lockhart 2475e87481 Deprecate 'current' for date/time input.
Fix up references to "PostgreSQL" rather than "Postgres". Was roughly
 evenly split between the two before. ref/ files not yet done.
2001-11-21 05:53:41 +00:00
Thomas G. Lockhart eec9511f0a Update for first platforms reported as working
for the upcoming 7.2 release.
2001-11-21 05:52:01 +00:00
Bruce Momjian 8e6467fff3 Peter Eisentraut wrote:
> So I would base this discussion on the premise "bytea stores binary data"
> (insert examples).
>
> Some stylistic issues:
>
> bytea => <type>bytea</type>
>
> NULLs => zero bytes/bytes of value zero ("NULL" is too overloaded)
>
> 'non-printable' => <quote>nonprintable</quote>
>
> MUST => <emphasis>must</emphasis>
>

Here's a patch against *CVS tip* to address Peter's comments. Please let
me know what you think!

Joe Conway
2001-11-21 03:17:22 +00:00
Bruce Momjian 05979312ed Added a few paragraphs to explain current restricted execution environment,
and error handling behavior.

Bradley McLean
2001-11-20 21:09:53 +00:00
Bruce Momjian 004293317f Here's a patch adding documentation for the PQescapeBytea function to
libpq.sgml

I was trying (but gave up) to cross-reference back to the input escape
table in the User's Guide, but could not get the documentation to
compile with a cross-book xref (missing IDREF error). Can a cross-book
xref be done?

 Joe Conway
2001-11-20 20:28:31 +00:00
Bruce Momjian 01e0dae689 I've created a new section to func.sgml, "Binary String Functions and
Operators", plagiarized shamelessly from the "String Functions and
Operators" section. There were enough differences that it made sense (at
least to me) to give this its own section instead of cramming it in with
normal string functions. This way I could also make the examples
relevant, which is particularly important for bytea.

One thing I think worth mentioning: while documenting the trim()
function I realized that I never implemented the bytea equivalent of
rtrim and ltrim. Therefore, the 'leading' and 'trailing' forms of trim,
available with text, are not available with bytea (I'd be happy to
correct this, but since it would require an initdb, I guess not until
7.3) -- the submitted doc accurately reflects this.

I will look for other areas of the docs that need mention of bytea, but
any guidance would be much appreciated.

--

Here's a second bytea documentation patch. This one significantly
expands the "Binary Data" section added by Bruce recently.


Joe Conway
2001-11-20 15:42:44 +00:00
Bruce Momjian 1337bfa94c Update TODO list. 2001-11-20 15:28:37 +00:00
Tom Lane bb2ff5f2d4 Expand discussion of logfile management a little bit. 2001-11-20 04:27:49 +00:00
Tom Lane fb726283b6 Expand description of how to use REINDEX. 2001-11-20 02:45:00 +00:00
Tom Lane 0dfe913803 Fill in empty tutorial section about transactions. 2001-11-19 23:17:38 +00:00
Bruce Momjian 8f6f16929a Update TODO list. 2001-11-19 20:02:25 +00:00
Tom Lane ec62ba9361 Try to be a little bit clearer about the implications of GRANT TO PUBLIC
and REVOKE FROM PUBLIC: the latter is not the same as 'revoke from all
users', but the ref page blurred the difference.
2001-11-19 19:03:56 +00:00
Bruce Momjian 9473f8d5f7 Update TODO list. 2001-11-19 18:10:38 +00:00
Tom Lane 5e86d226e4 Grammatical and spelling fixes. 2001-11-19 09:05:02 +00:00
Tom Lane 375dcf9c88 Fix a few typos, grammatical problems, etc in new tutorial material.
Overall a really nice job here, Peter ...
2001-11-19 05:37:53 +00:00
Tom Lane 9b03776ff2 A bunch of small doco updates motivated by scanning the comments on
the interactive docs.
2001-11-19 03:58:25 +00:00
Tom Lane 9f07cb70db Add example of using 'sameuser' followed by 'all' pg_hba records to
enforce a limit on who can connect to databases other than their own.
From a recent discussion in pg-admin.
2001-11-18 23:24:16 +00:00
Tom Lane 8cf87ac393 Fix some typos. 2001-11-18 22:27:00 +00:00
Tom Lane 0ad017fc64 Update various obsolete remarks about VACUUM. 2001-11-18 22:17:30 +00:00
Tom Lane acac465efa utils/geo-decls.h should be utils/geo_decls.h, per report from
StÅphane Raimbault.
2001-11-18 21:28:00 +00:00
Tom Lane deab49566d Mention that LIKE ... ESCAPE '' is allowed to specify no
escape character.
2001-11-18 21:17:10 +00:00
Bruce Momjian 98e05cec5b Update TODO list. 2001-11-18 21:17:04 +00:00
Tom Lane b16f6c6b95 Point out that TRUNCATE can't be used inside a transaction block. 2001-11-18 21:14:20 +00:00
Peter Eisentraut 17f0b55d15 Initial round of tweakage for man pages 2001-11-18 20:35:02 +00:00
Peter Eisentraut 31578cdeac Updates about NLS 2001-11-18 20:33:32 +00:00
Bruce Momjian 834a76fe79 Update TODO list. 2001-11-18 15:32:39 +00:00
Tom Lane e2548526cf Mention the option to submit bug reports via a web-form. Minor
copy editing.
2001-11-18 07:14:49 +00:00
Tom Lane 5906d7e096 Fix obsolete claim that only btree indexes support multiple columns;
GiST does now, too.  (Someone needs to write a description of GiST
to add to this chapter.  I don't know enough about it ...)
2001-11-18 00:59:00 +00:00
Tom Lane 0729c4a61f Clean up treatment of creating/dropping databases in User's Guide and
Admin Guide.  Move discussion of template databases out of footnotes
in CREATE DATABASE ref page and into a section of the Admin Guide.
Clean up various obsolete claims, do some copy-editing.
2001-11-18 00:38:00 +00:00
Tom Lane c9a85cb276 Copy-editing. 2001-11-17 22:23:55 +00:00
Tom Lane 2043340b87 Expand documentation for sequence functions (nextval and friends).
Place it in the expected place in the User's Guide, rather than
hiding it in the command reference page for CREATE SEQUENCE.
2001-11-17 22:20:34 +00:00
Bruce Momjian 59fdccccf5 Update TODO list. 2001-11-17 19:53:07 +00:00
Bruce Momjian f57eec067d Update TODO list. 2001-11-17 19:29:19 +00:00
Peter Eisentraut d5a951260a Update key words for recent grammar changes 2001-11-17 13:27:16 +00:00
Bruce Momjian dc6efa44e2 Update Japanese FAQ's. 2001-11-17 05:11:43 +00:00
Bruce Momjian b0df7a60f2 Update TODO list. 2001-11-16 17:43:25 +00:00
Peter Eisentraut 306798ded5 Use -f for rm. 2001-11-16 16:29:56 +00:00
Tom Lane 7e422ac0e7 Fix silly error in plpgsql example. 2001-11-16 00:40:11 +00:00
Tom Lane fa09b6d7b2 Add documentation for new plpgsql cursor operations. Also, another
round of editorial effort.
2001-11-15 23:32:39 +00:00
Tom Lane 307e449e5f Significant editorial overhaul of plpgsql documentation. 2001-11-15 06:25:22 +00:00
Tatsuo Ishii 7a546eb985 Add changes for multibyte support in 7.2. 2001-11-15 06:15:34 +00:00
Bruce Momjian 09f19de62c Update TODO list. 2001-11-15 03:11:32 +00:00
Tom Lane b3bbeed1f6 Overhaul SPI documentation: bring it into some semblance of agreement
with reality, and add doco for Jan's recent round of enhancements.
2001-11-14 22:26:02 +00:00
Tom Lane a370cad990 Try to be a little less terse about dealing with variable-length structs
in C, but recommend that newbies who don't recognize this trick should do
some studying ...
2001-11-14 22:14:22 +00:00
Bruce Momjian 74114938ad Gnu -> GNU in docs. 2001-11-14 20:40:33 +00:00
Bruce Momjian 276450d7d7 Update TODO list. 2001-11-14 16:31:38 +00:00
Bruce Momjian 330b112476 Update TODO list. 2001-11-13 01:14:57 +00:00
Tom Lane a585c20d12 Tweak parser so that there is a defined representation for datatypes
bpchar, bit, numeric with typmod -1.  Alter format_type so that this
representation is printed when the typmod is -1.  This ensures that
tables having such columns can be pg_dump'd and reloaded correctly.
Also, remove the rather useless and non-SQL-compliant default
precision and scale for type NUMERIC.  A numeric column declared as
such (with no precision/scale) will now have typmod -1 which means
that numeric values of any precision/scale can be stored in it,
without conversion to a uniform scale.  This seems significantly
more useful than the former behavior.  Part of response to bug #513.
2001-11-12 21:04:46 +00:00
Bruce Momjian 9c9ea41b3c Update TODO list. 2001-11-12 20:26:39 +00:00
Peter Eisentraut 3c879e3738 Add some more index entries. 2001-11-12 19:19:39 +00:00
Bruce Momjian 905109f24a Update FAQ. 2001-11-12 07:38:57 +00:00
Bruce Momjian 0954ea174a Update TODO list. 2001-11-12 07:10:58 +00:00
Bruce Momjian 26e34c9b30 Update TODO list. 2001-11-12 05:35:48 +00:00
Bruce Momjian 53a4fa6b0e Add more MD5 documentation now that odbc/jdbc support it. 2001-11-12 02:35:16 +00:00
Bruce Momjian c336b58f93 Fix typo pointed out by bruno@wolff.to 2001-11-11 19:24:28 +00:00
Tom Lane 26e8a4f356 Repair erroneous ALTER DROP CONSTRAINT example. 2001-11-10 20:13:37 +00:00
Peter Eisentraut e5fadc78b5 Support for images in jadetex and pdfjadetex. Formatting improvements for
lists, bibliography, index, page numbering.  Add comments.
2001-11-08 23:46:29 +00:00
Peter Eisentraut 03048ffd3f Use <sect1> rather than <section> to simplify formatting. 2001-11-08 23:44:01 +00:00
Peter Eisentraut 15f2215c86 Add missing spaces 2001-11-08 23:42:23 +00:00
Peter Eisentraut 84f07f5768 Fix indexterms 2001-11-08 23:41:12 +00:00
Peter Eisentraut ede8724010 Move the indexterms around so they don't affect formatting 2001-11-08 23:40:40 +00:00
Peter Eisentraut e0a513e82e Use <important> rather than <caution> when the condition isn't hazardous,
because the result looks to "scary" otherwise.
2001-11-08 23:39:22 +00:00
Peter Eisentraut 5766f98a73 Small tuning 2001-11-08 23:37:50 +00:00
Peter Eisentraut 06f008e154 Spacing improvements 2001-11-08 23:36:55 +00:00
Peter Eisentraut d65df97885 Don't use dot in id attribute, which confuses the index generation code in
this particular instance.
2001-11-08 23:36:18 +00:00
Peter Eisentraut a715c0e4c5 Cleanup of bibliography 2001-11-08 23:34:33 +00:00
Bruce Momjian e8192dc0d0 Update TODO list. 2001-11-08 18:24:55 +00:00
Bruce Momjian 75df678ffa Update TODO list. 2001-11-07 05:27:46 +00:00
Bruce Momjian 3e5e73ec3b Update TODO list. 2001-11-07 01:34:03 +00:00
Tom Lane 4a3bf197eb Add some notes about conditional rules used with views. 2001-11-06 23:54:32 +00:00
Bruce Momjian f688c1e064 Update TODO list. 2001-11-06 23:42:44 +00:00
Tom Lane 0053cebea5 Fix coredump in plpgsql when trying to return a rowtype result.
Need to return a TupleTableSlot, not just a bare tuple.
2001-11-05 19:41:56 +00:00
Tom Lane 3d5ddc0b3c Clean up wrong, misleading, or obsolete documentation about array types,
particularly in the CREATE TYPE reference page.  Fix some other errors
in the CREATE TYPE page, too.
2001-11-03 21:42:47 +00:00
Peter Eisentraut e25058bb14 Update keyword list for 7.2 release. 2001-11-02 19:13:09 +00:00
Tom Lane 8a069abd18 Fix pg_pwd caching mechanism, which was broken by changes to fork
postmaster children before client auth step.  Postmaster now rereads
pg_pwd on receipt of SIGHUP, the same way that pg_hba.conf is handled.
No cycles need be expended to validate password cache validity during
connection startup.
2001-11-02 18:39:57 +00:00
Bruce Momjian 36aa85dcd3 Update TODO list. 2001-11-01 20:06:59 +00:00
Tom Lane fe61b6cc4a Fix broken markup. 2001-11-01 04:48:00 +00:00
Tom Lane d14147de77 Copy-editing. 2001-11-01 04:07:29 +00:00
Peter Eisentraut d63805a469 A little reformatting for better print appearance. 2001-10-31 20:39:30 +00:00
Peter Eisentraut 8e144b09ae More information about partial indexes, and some tips about examining
index usage.
2001-10-31 20:38:26 +00:00
Peter Eisentraut 028c72525d Reformat some non-sensical markup. 2001-10-31 20:37:39 +00:00
Peter Eisentraut d6b2d6b640 Empty ulinks show the url string as hot text; no need to repeat the url as
element content.
2001-10-31 20:35:02 +00:00
Bruce Momjian fa8505f996 Update TODO list. 2001-10-31 15:11:08 +00:00
Bruce Momjian 453baecda3 Update TODO list. 2001-10-31 15:06:02 +00:00
Bruce Momjian 85801ed9b8 Attached is a small patch for the Reference Manual which adds
information about nulls and sort order.

This is based on information obtained from Peter Eisentraut and
Tom Lane on pgsql-hackers.

Please check my English and Docbook markup, as both are a second
language to me.

Rene Pijlman
2001-10-31 04:50:52 +00:00
Bruce Momjian 4911c85e86 Add ALTER TABLE ADD UNIQUE regression tests from Christopher Kings-Lynne.
Add space between slash for ALTER TABLE / ADD ....

Regression and *.po updates to follow.
2001-10-31 04:49:44 +00:00
Bruce Momjian 2fd8f8907f Update TODO list. 2001-10-31 01:56:55 +00:00
Barry Lind 2f254bdd56 updates to JDBC TODO items 2001-10-30 20:45:17 +00:00
Tom Lane b9cd4c8331 Grammatical corrections. 2001-10-30 20:13:44 +00:00
Tom Lane 6b0be33446 Update WAL configuration discussion to reflect post-7.1 tweaking.
Minor copy-editing.
2001-10-26 23:10:21 +00:00
Tom Lane 8394e4723a More cleanup of CREATE FUNCTION examples. 2001-10-26 21:17:03 +00:00
Tom Lane 62651c0176 Editorial work on xfunc chapter --- better explanations about SQL
functions handling composite types and sets, various minor cleanups.
2001-10-26 19:58:12 +00:00
Bruce Momjian effeef8a32 Update TODO list. 2001-10-26 15:27:41 +00:00
Barry Lind b75e1752f0 updates to jdbc documentation for 7.2 2001-10-25 22:00:31 +00:00
Bruce Momjian bac0d2d2cd Update TODO list. 2001-10-25 19:43:53 +00:00
Bruce Momjian b6b028c7b7 Remove <> from FAQ_MSWIN, for Vince. 2001-10-25 16:20:51 +00:00
Bruce Momjian bd39e0c0d7 Update TODO list. 2001-10-24 01:01:36 +00:00
Bruce Momjian 0fe571676a Update TODO list. 2001-10-23 23:27:18 +00:00
Tom Lane 92e1b7431f Editorial work on descriptions of options. 2001-10-23 22:11:22 +00:00
Bruce Momjian 3e76c9aaa5 Move ALL out of UNION|INTERSECT|EXCEPT syntax.
Alvaro Herrera
2001-10-23 16:42:36 +00:00
Bruce Momjian 749fe03f7b Update TODO list. 2001-10-23 02:52:19 +00:00
Bruce Momjian 9c6e543f73 Update TODO list. 2001-10-23 02:51:35 +00:00
Tom Lane 453f3503f3 Add note explaining that multiple prompts for a password are normal
behavior when password auth is used.
2001-10-22 23:48:11 +00:00
Peter Eisentraut f08c9ff84b Make the CREATE TABLE ref page more readable and update some information. 2001-10-22 18:14:47 +00:00
Bruce Momjian f363b3177d Remove LIMIT #,# and suggest LIMIT # OFFSET #, per mailing list discussion. 2001-10-20 02:55:39 +00:00
Bruce Momjian 9590249e14 Update TODO list. 2001-10-19 14:59:04 +00:00
Bruce Momjian efd72ce376 Update TODO list. 2001-10-19 01:30:17 +00:00
Tom Lane 6b5aeb797f Typo. 2001-10-19 00:46:51 +00:00
Bruce Momjian f5a5b44c4d Change error code docs to use colons. 2001-10-18 20:43:05 +00:00
Bruce Momjian 278669e038 Document all the ecpg error codes. 2001-10-18 20:32:58 +00:00
Tom Lane 8be02853b8 Add documentation about statistics collector and stats views & functions. 2001-10-16 23:57:06 +00:00
Tom Lane 2bb6b98d5c Add a section about the planner's statistics, including a description
of the new pg_stats view.
2001-10-16 01:13:44 +00:00
Tom Lane daf72bba91 Add note about pg_stats to pg_statistic entry; add sections for
pg_largeobject, pg_listener, pg_rewrite, pg_trigger; miscellaneous
small improvements.
2001-10-15 22:47:47 +00:00
Tom Lane 8f6d72cb39 Suggest placing audit trail on pg_shadow, not its view pg_user. 2001-10-15 02:02:06 +00:00
Tom Lane 9bc15d499d Update examples of type coercion rules --- some of them no longer worked
as the example claimed, because of changes elsewhere in the system.
2001-10-15 01:00:59 +00:00
Bruce Momjian 360e61e1f5 Update FAQ. 2001-10-14 23:27:31 +00:00
Bruce Momjian 657d0044b0 Update FAQ. 2001-10-13 05:27:05 +00:00
Bruce Momjian 46712990bd More keyword uppercasing. 2001-10-13 04:58:35 +00:00
Bruce Momjian 1d3a47af0c Attached patch for unconditional enabling of pltcl-unknown support.
Enabling this feature adds very light overhead of 1 select from pg_class on
first using of pl/tcl in backend if unknown suppport is really unused.
But pl/tcl with this support has very improved functionality.

Patch includes changes to documentation.
2001-10-13 04:23:50 +00:00
Bruce Momjian 36458b93e0 Update FAQ. 2001-10-13 03:53:45 +00:00
Bruce Momjian db7aa99fb9 Update FAQ. 2001-10-13 03:37:42 +00:00
Bruce Momjian cdd4379394 Update FAQ. 2001-10-13 01:32:47 +00:00
Bruce Momjian 0818073894 More uppercasing. 2001-10-12 23:34:30 +00:00
Bruce Momjian 705869dd17 Uppercase keywords where appropriate. 2001-10-12 23:32:34 +00:00
Bruce Momjian c24216bea8 Fix reverse FOR loop to work properly, uppercase cleanup in file. 2001-10-12 21:19:09 +00:00
Bruce Momjian c0b2bbf42e Add WAL mmap() mention. 2001-10-12 17:35:10 +00:00
Bruce Momjian 68966634b2 Update TODO list. 2001-10-12 17:34:36 +00:00
Bruce Momjian 6790f21441 Update TODO list. 2001-10-12 17:33:46 +00:00
Bruce Momjian 63a22cd2dd Update TODO list. 2001-10-12 17:28:41 +00:00
Bruce Momjian 129b19f685 Update TODO list. 2001-10-12 17:23:04 +00:00
Bruce Momjian d8f88f01f0 Update TODO list. 2001-10-12 16:29:36 +00:00
Bruce Momjian 010e8144cd Update TODO list. 2001-10-12 16:14:17 +00:00
Bruce Momjian 7d9d026323 Update TODO list. 2001-10-12 16:13:48 +00:00
Bruce Momjian 7bce3e95cf Remove mutex mention. Fixed now. 2001-10-12 16:10:51 +00:00
Bruce Momjian 182722f737 Update TODO list. 2001-10-12 16:07:34 +00:00
Bruce Momjian ffcad12769 Update TODO list. 2001-10-12 02:50:48 +00:00
Tatsuo Ishii f426465ba9 Add a new function "pg_client_encoding" which returns the current client
side encoding name. This is necessary for client API's such as JDBC
to perform correct encoding conversions. See my email "[HACKERS]
pg_client_encoding" 10 Sep 2001.
2001-10-12 02:08:34 +00:00
Tom Lane f9e6e27c87 Break transformCreateStmt() into multiple routines and make
transformAlterStmt() use these routines, instead of having lots of
duplicate (not to mention should-have-been-duplicate) code.
Adding a column with a CHECK constraint actually works now,
and the tests to reject unsupported DEFAULT and NOT NULL clauses
actually fire now.  ALTER TABLE ADD PRIMARY KEY works, modulo
having to have created the column(s) NOT NULL already.
2001-10-12 00:07:15 +00:00
Bruce Momjian e98476eb03 Document use of GEQO param in subquery pullups. 2001-10-11 21:16:26 +00:00
Bruce Momjian 9e642cd7ef Update TODO list. 2001-10-11 20:40:38 +00:00
Bruce Momjian c19ff887c6 Add documention for ecpg -209 error. 2001-10-11 20:25:42 +00:00
Bruce Momjian b0c4598c66 Update TODO list. 2001-10-11 16:35:50 +00:00
Bruce Momjian 95c18db868 Remove mention of "pg_result -list" becuase it is not implemented, per
Tatsuo.
2001-10-11 16:30:41 +00:00
Peter Eisentraut 371f49bf9f Remove gratuitous discrepancy between extract() and date_part(),
regarding timezone_hour, timezone_minute vs. tz_hour, tz_minute.
Document the former.
2001-10-10 00:02:42 +00:00
Peter Eisentraut ec5c62874d Allow optional () after current_user, session_user, user, current_time,
current_timestamp, current_date for ODBC compatibility.

Add more functions to odbc.sql catalog extension, use new CREATE OR
REPLACE FUNCTION.

Document iODBC/unixODBC build options.
2001-10-09 22:32:33 +00:00
Peter Eisentraut ffb8f73890 Bunch of copy fitting and style sheet tweakage to get decent looking print
output (from pdfjadetex).  Also updated instructions to install documentation
processing toolchain.
2001-10-09 18:46:00 +00:00