Commit Graph

149 Commits

Author SHA1 Message Date
Tom Lane f8ffb60492 A small pass of docs review and copy-editing. 2004-12-23 05:37:40 +00:00
Peter Eisentraut 5ec30faee6 Spell checker run 2004-12-13 18:05:10 +00:00
Neil Conway ec7a6bd9a2 Replace "--" and "---" with "—" as appropriate, for better-looking
output.
2004-11-15 06:32:15 +00:00
Tom Lane 3d2849820b Document IS DISTINCT FROM in a more obvious place, and add some more
index entries for IS-foo constructs.
2004-10-26 22:16:12 +00:00
Tom Lane 2f48836b1f Some editorializing on the docs for the dollar-quoting feature: fix
grammar, don't drop discussions into the middle of unrelated discussions,
etc.
2004-09-20 22:48:29 +00:00
Tom Lane d70a42e642 Represent type-specific length coercion functions as pg_cast entries,
eliminating the former hard-wired convention about their names.  Allow
pg_cast entries to represent both type coercion and length coercion in
a single step --- this is represented by a function that takes an
extra typmod argument, just like a length coercion function.  This
nicely merges the type and length coercion mechanisms into something
at least a little cleaner than we had before.  Make use of the single-
coercion-step behavior to fix integer-to-bit coercion so that coercing
to bit(n) yields the rightmost n bits of the integer instead of the
leftmost n bits.  This should fix recurrent complaints about the odd
behavior of this coercion.  Clean up the documentation of the bit string
functions, and try to put it where people might actually find it.
Also, get rid of the unreliable heuristics in ruleutils.c about whether
to display nested coercion steps; instead require parse_coerce.c to
label them properly in the first place.
2004-06-16 01:27:00 +00:00
Tom Lane 982d005d62 Some preliminary documentation for composite-type stuff. 2004-06-07 04:04:47 +00:00
Neil Conway 8295c27c89 Add documentation for the new "dollar quoting" feature, and update existing
examples to use dollar quoting when appropriate. Original patch from David
Fetter, additional work and editorializing by Neil Conway.
2004-05-16 23:22:08 +00:00
Tom Lane 2f63232d30 Promote row expressions to full-fledged citizens of the expression syntax,
rather than allowing them only in a few special cases as before.  In
particular you can now pass a ROW() construct to a function that accepts
a rowtype parameter.  Internal generation of RowExprs fixes a number of
corner cases that used to not work very well, such as referencing the
whole-row result of a JOIN or subquery.  This represents a further step in
the work I started a month or so back to make rowtype values into
first-class citizens.
2004-05-10 22:44:49 +00:00
Neil Conway bfd6f52b0e Allow 'Infinity' and '-Infinity' as input to the float4 and float8
types. Update the regression tests and the documentation to reflect
this. Remove the UNSAFE_FLOATS #ifdef.

This is only half the story: we still unconditionally reject
floating point operations that result in +/- infinity. See
recent thread on -hackers for more information.
2004-03-12 00:25:43 +00:00
PostgreSQL Daemon 969685ad44 $Header: -> $PostgreSQL Changes ... 2003-11-29 19:52:15 +00:00
Tom Lane e1b47c2dbd Minor copy-editing. 2003-11-06 22:21:47 +00:00
Tom Lane 64caee7548 Give the full syntax rules for subscripting and field selection in the
proper place, namely the syntax discussion of value expressions.
2003-11-04 19:18:15 +00:00
Peter Eisentraut 1d27de4cf4 Random copy-editing. 2003-11-04 09:55:39 +00:00
Peter Eisentraut 8442a92e5a Spell checking, consistent terminology. 2003-11-01 01:56:29 +00:00
Peter Eisentraut c326d8f4f2 Add/edit index entries. 2003-08-31 17:32:24 +00:00
Tom Lane 432fb5b886 Updates for array documentation, from Joe Conway. 2003-08-19 06:06:48 +00:00
Tom Lane 0684043e39 Minor copy-editing. 2003-08-14 23:13:27 +00:00
Tom Lane 5bfb0540b0 Update docs for 7.4 array features and polymorphic functions.
This is Joe Conway's patch of 7-Aug plus further editorializing
of my own.
2003-08-09 22:50:22 +00:00
Peter Eisentraut 3766e99c41 Add a note that AND and OR are commutative. Apparently, they are not in
certain other products.
2003-08-04 14:00:14 +00:00
Tom Lane 1bd22f55cf Disallow dollar sign in operator names, instead allow it as a non-first
character in identifiers.  The first change eliminates the current need
to put spaces around parameter references, as in "x<=$2".  The second
change improves compatibility with Oracle and some other RDBMSes.  This
was discussed and agreed to back in January, but did not get done.
2003-06-19 23:22:40 +00:00
Tom Lane e649796f12 Implement outer-level aggregates to conform to the SQL spec, with
extensions to support our historical behavior.  An aggregate belongs
to the closest query level of any of the variables in its argument,
or the current query level if there are no variables (e.g., COUNT(*)).
The implementation involves adding an agglevelsup field to Aggref,
and treating outer aggregates like outer variables at planning time.
2003-06-06 15:04:03 +00:00
Peter Eisentraut 5e5c5cd31a Merge documentation into one book. (Build with "make html".) Replace
vague cross-references with real links.
2003-03-25 16:15:44 +00:00
Peter Eisentraut 706a32cdf6 Big editing for consistent content and presentation. 2003-03-13 01:30:29 +00:00
Bruce Momjian 4996eea81c This patch includes more SGML markup fixes as well as a few minor
additions to the docs.

Neil Conway
2003-02-19 03:13:25 +00:00
Bruce Momjian da8149032a SGML improvements.
Neil Conway
2002-11-15 03:11:18 +00:00
Peter Eisentraut 1b342df00a Merge documentation updates from 7.3 branch. 2002-11-11 20:14:04 +00:00
Peter Eisentraut 266a280584 Add introductory sections explaining what each book is about. Remove Y2K
statement.
2002-10-24 17:48:54 +00:00
Tom Lane c918be6a17 Update description of numeric constants to match 7.3 reality.
Miscellaneous other copy-editing.
2002-10-20 05:05:46 +00:00
Peter Eisentraut bc49968764 Add more appropriate markup. 2002-09-21 18:32:54 +00:00
Peter Eisentraut 6d77f6e5fb Add more information about schemas. Combines some previously existing
material into the new location.
2002-09-12 22:05:36 +00:00
Bruce Momjian 6415ffe7af Not sure how I fixed it the first time, but here's a fix for another
instance in which the docs mention that 'NAMEDATALEN == 32".

Neil Conway
2002-08-23 04:27:19 +00:00
Bruce Momjian c76f5aa530 > > I had great difficulty in finding how to change the search path, so here
> > is a patch to add some cross-referencing.

Oliver Elphick
2002-08-22 04:52:17 +00:00
Bruce Momjian 46bb23ac01 Change NAMEDATALEN to 64, INDEX_MAX_KEYS/MAX_FUNC_ARGS to 32, per discussion on hackers. 2002-08-13 20:40:44 +00:00
Tom Lane a5e6e99357 Allow schema-qualified operator names to be used in the optional
arguments of CREATE OPERATOR.
2002-08-10 19:01:53 +00:00
Peter Eisentraut 6f4a9fb119 Add User's Guide chapters on Data Definition and Data Manipulation.
Still needs to be filled with more information, but it gives us a
framework to have a User's Guide with complete coverage of the basic
SQL operations.  Move arrays into data type chapter, inheritance into
DDL chapter (for now).

Make <comment>s show up in the output while the version number ends in
"devel".

Allow cross-book references with entities &cite-user; etc.
2002-08-05 19:43:31 +00:00
Tom Lane 62d4526114 Ooops, fix busted markup. 2002-06-15 22:15:03 +00:00
Tom Lane 2da3742cf5 Add a little more material to the new section about evaluation order. 2002-06-15 21:28:55 +00:00
Peter Eisentraut bf886d5baf Add section explaining unspecified expression evaluation order. 2002-06-01 20:56:55 +00:00
Tom Lane e358a61d76 Updates for schema features. 2002-04-25 20:14:43 +00:00
Peter Eisentraut b6ea172ace Spell checking and markup additions 2002-03-22 19:20:45 +00:00
Peter Eisentraut bf43bed848 Spell-check and markup police 2002-01-20 22:19:57 +00:00
Tom Lane 4d72af6cb3 Describe type casts under the heading of Value Expressions, and explain
the difference between a run-time type cast and casting a literal string
to a specific type.  Minor editorial work in same area.
2002-01-09 23:38:06 +00:00
Peter Eisentraut 731204e090 Editorial review 2002-01-07 02:29:15 +00:00
Thomas G. Lockhart 68cb184b56 Update list of currently supported platforms.
Mention SQL9x precision syntax for date/time types.
Use PostgreSQL consistantly throughout docs. Before, usage was split evenly
 between Postgres and PostgreSQL.
2001-12-08 03:24:23 +00:00
Tom Lane 53f1173388 Provide some documentation for EXISTS, IN, NOT IN, ANY/SOME/ALL,
and row comparisons.  How'd this manage to slip through the cracks?
2001-12-01 04:19:20 +00:00
Peter Eisentraut 651a639b8b proof-reading 2001-11-28 20:49:10 +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
Tom Lane 5e86d226e4 Grammatical and spelling fixes. 2001-11-19 09:05:02 +00:00
Peter Eisentraut a715c0e4c5 Cleanup of bibliography 2001-11-08 23:34:33 +00:00
Bruce Momjian 705869dd17 Uppercase keywords where appropriate. 2001-10-12 23:32:34 +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
Peter Eisentraut 351a0c1736 Replace ASCII-quotes with proper markup. 2001-09-13 15:55:24 +00:00
Peter Eisentraut 84956e71a3 Markup additions and spell check. (covers User's Guide) 2001-09-09 17:21:59 +00:00
Tom Lane 8e0d642c9b Documentation for transaction-ID-wraparound changes. Add a chapter to
the Admin Guide about routine maintenance tasks.  Currently this only
discusses the various reasons for doing VACUUM, but perhaps it could be
fleshed out with topics like log rotation.
2001-08-26 21:17:12 +00:00
Tom Lane bf56f0759b Make OIDs optional, per discussions in pghackers. WITH OIDS is still the
default, but OIDS are removed from many system catalogs that don't need them.
Some interesting side effects: TOAST pointers are 20 bytes not 32 now;
pg_description has a three-column key instead of one.

Bugs fixed in passing: BINARY cursors work again; pg_class.relhaspkey
has some usefulness; pg_dump dumps comments on indexes, rules, and
triggers in a valid order.

initdb forced.
2001-08-10 18:57:42 +00:00
Tom Lane 116d2bba7e Add IS UNKNOWN, IS NOT UNKNOWN boolean tests, fix the existing boolean
tests to return the correct results per SQL9x when given NULL inputs.
Reimplement these tests as well as IS [NOT] NULL to have their own
expression node types, instead of depending on special functions.
From Joe Conway, with a little help from Tom Lane.
2001-06-19 22:39:12 +00:00
Peter Eisentraut 01839df6dd Add index. Only some parts of the manual set have index entries so far... 2001-05-12 22:51:36 +00:00
Peter Eisentraut 60774e8210 Even better example for operator precedence mis-parsing. 2001-02-25 16:05:21 +00:00
Peter Eisentraut 3460181c3c Choose a more suitable example for the operator precedence mis-parsing
example.
2001-02-24 18:09:51 +00:00
Tom Lane 08265ef9c2 Fix example of syntactic ambiguity between prefix/infix/postfix operators
--- Postgres now accepts the example we claimed it wouldn't.  Miscellaneous
copy-editing as well.
2001-02-10 07:08:44 +00:00
Peter Eisentraut 61737a7b47 Add some links from data type chapter to section on literal constants. 2001-01-26 22:04:22 +00:00
Peter Eisentraut 21a3857f1f Rip out table expression section from SQL syntax chapter and develop it
into new chapter on query (SELECT) syntax.  In the end this should become
a narrative and example-filled counterpart to the SELECT reference page.
2001-01-22 23:34:33 +00:00
Peter Eisentraut 4f34f55d3d Description of table expressions, including join syntax, from Robert B.
Easter <reaster@comptechnews.com>, heavily massaged by me.  Also cleaned up
value expressions a bit.
2001-01-21 22:02:01 +00:00
Peter Eisentraut 027f144e39 Terminology cleanup: class -> table, instance -> row, attribute -> column,
etc.
2001-01-13 23:58:55 +00:00
Peter Eisentraut 526427f6d3 Add information about bit types. Adjust some other things to promote
SQL type names over internal type names.
2001-01-13 18:34:51 +00:00
Tom Lane 10fb290aca Document the system attributes ctid and tableoid, which for some reason
were never yet mentioned anywhere in our documentation.  Improve
explanations of the other system attributes, too.
2001-01-08 22:07:47 +00:00
Peter Eisentraut 3942ee389c Update section on SQL syntax. (Still a lot to be done though.) Add
appendix with comprehensive list of key words.
2001-01-06 11:58:56 +00:00
Peter Eisentraut 1b555ce791 Replace incorrect uses of 'which' with 'that'. (so-called "wicked which") 2000-12-22 18:57:50 +00:00
Peter Eisentraut b2145e9365 Get rid of the little "v"s in front of version numbers, substituting the
full word "version" where appropriate.
2000-12-21 22:55:27 +00:00
Tom Lane e4eb91048c Document the array_dims() function, and make some other small improvements
in the docs for arrays.
2000-12-18 23:39:37 +00:00
Tom Lane 96ff0cb0c4 Outer join updates, miscellaneous polishing. 2000-12-17 05:47:57 +00:00
Tom Lane cf00d59335 Clean up some bogosities in description of target lists. 2000-12-16 18:22:53 +00:00
Peter Eisentraut c3641483c3 Merge functions and operators chapters. Lots of updates. 2000-12-14 22:30:56 +00:00
Peter Eisentraut 72ad5fe15c Add `id' attributes to all `chapter' and `sect1' tags, to generate useful
names for the HTML files (e.g., not x4856.htm).
2000-09-29 20:21:34 +00:00
Tom Lane d2165a4a5d Fix incorrect example of CAST syntax (was missing required parentheses). 2000-08-07 19:53:27 +00:00
Thomas G. Lockhart 4835f6a8bc Update docs for TIME WITHOUT TIME ZONE.
Add information on SET SESSION CHARACTERISTICS.
Fix references to pg_hba.conf(5) since that is no longer a man page.
2000-07-14 15:26:21 +00:00
Bruce Momjian b997a4b91f > Great! Please cc: the docs or hackers mailing lists to make sure the
> patches are not lost...

Aggregate doc patches:

The patches are attached. Be great if you could check them over to make
sure all relevant content (and markup) is there...

Isaac Wilcox
2000-06-20 18:04:18 +00:00
Bruce Momjian 8c1d09d591 Inheritance overhaul by Chris Bitmead <chris@bitmead.com> 2000-06-09 01:44:34 +00:00
Thomas G. Lockhart 45f79cae14 Fixups in content and markup for 7.0 release. 2000-05-02 20:02:03 +00:00
Bruce Momjian 321eedd0bf Document FSYNC in pg_options sgml file. 2000-04-08 23:12:01 +00:00
Thomas G. Lockhart 73d8bbc2ac Minor markup changes. Refer to (".../catalog") in the emacs hints. 2000-03-31 03:27:42 +00:00
Tom Lane 175dbf741b Make discussion of names clearer and more accurate. 2000-03-30 23:42:34 +00:00
Tom Lane f945f46193 Modify lexing of multi-char operators per pghackers discussion around
16-Mar-00: trailing + or - is not part of the operator unless the operator
also contains characters not present in SQL92-defined operators.  This
solves the 'X=-Y' problem without unduly constraining users' choice of
operator names --- in particular, no existing Postgres operator names
become invalid.

Also, remove processing of // comments, as agreed in the same thread.
2000-03-18 18:03:12 +00:00
Tom Lane f72aad5678 Update discussion of aggregate syntax to mention ALL. 2000-02-21 01:20:41 +00:00
Tom Lane 90aaad06cf Remove obsolete references to 8K query limit. 2000-01-25 07:04:04 +00:00
Tom Lane ff6fe1502d Update documentation to reflect availability of aggregate(DISTINCT).
Try to provide a more lucid discussion in 'Using Aggregate Functions'
tutorial section.
1999-12-13 17:39:38 +00:00
Thomas G. Lockhart fac9e11878 Add DEC and SESSION_USER as reserved words.
Move around a few other keywords which were not in the right category.
DEC and SESSION_USER are not yet committed to gram.y,
 since I'm in the middle of working on JOIN syntax too.
1999-10-12 13:58:53 +00:00
Thomas G. Lockhart 03e5edb7e4 Add keywords from Jan's recent RI features. 1999-10-01 15:21:08 +00:00
Thomas G. Lockhart d810338d29 Add a few items to the reserved keyword lists.
Clarify information on implicitly-typed constants.
1999-09-29 05:22:25 +00:00
Thomas G. Lockhart db5d724986 Fix wording on allowed/forbidden keyword usage.
Thanks to Michael Deck <deckm@cleansoft.com> for the tipoff.
Add more examples for language components.
1999-09-01 02:37:40 +00:00
Thomas G. Lockhart 6b07527721 Fix cross-reference markup so that only the *title* of the Operators
chapter is included, not the chapter itself.
Thanks to Evelyn Mitchell <efm@tummy.com> for pointing it out.
1999-08-06 13:48:38 +00:00
Thomas G. Lockhart f2f43efbe1 Complete merge of all old man page information.
lisp.sgml is a placeholder for Eric Marsden's upcoming contribution.
catalogs.sgml is not yet marked up or integrated.
 It should perhaps become an appendix.
1999-07-22 15:11:05 +00:00
Thomas G. Lockhart 878d952084 Add mention of hot backups to the release notes.
Add id tags to chapter and section headings to ensure good labels
 on output html files.
1999-06-09 13:44:59 +00:00
Thomas G. Lockhart 95e3cec621 Include mention of CASE, COALESCE, and IFNULL.
Add date/time parsing procedure (perhaps should be in appendix).
Add time zone information (ditto).
Update keyword list.
1999-05-12 07:32:47 +00:00
Thomas G. Lockhart 7fcbc5ddf0 Fix markup to include all closing tags.
Required by newest versions of DocBook and style sheets.
1999-04-06 15:41:20 +00:00
Thomas G. Lockhart bb6286a92d Include keywords from CASE implementation.
Rearrange a few other keywords to put them in the proper category.
1998-12-18 16:13:45 +00:00
Thomas G. Lockhart e149af170d Add TIMESTAMP as unreserved word. 1998-10-14 16:28:53 +00:00
Thomas G. Lockhart 2d73585028 Clean up pages. Add information for operator precedence.
Split introduction sections into separate files to allow the legal notice
 and notation sections appear in all documents without having the history
 show up everplace too.
Add full list of reserved and non-reserved key words in syntax.sgml.
Add a separate chapter to the admin guide on security.
1998-09-30 05:41:54 +00:00