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