summaryrefslogtreecommitdiff
path: root/doc/src/sgml/ref
AgeCommit message (Collapse)Author
2003-04-22More editing of reference pages.Peter Eisentraut
2003-04-20Make it clear it is the server version that determines if crlf is used. ↵Bruce Momjian
Idea from Joe Conway.
2003-04-19Add pipe parameter to COPY function to allow proper line termination.Bruce Momjian
2003-04-17Make pg_dump's concurency capability more prominent.Bruce Momjian
2003-04-15Bring SQL ref pages to consistent format, part 1.Peter Eisentraut
2003-04-14Another try at correctly explaining the difference between Postgres andTom Lane
SQL92 temp tables. Possibly I got it right this time.
2003-04-14Minor copy-editing.Tom Lane
2003-04-14Clarify description of our deviation from standard for temp tables,Tom Lane
per suggestion from Mike Sykes.
2003-04-06Fix markup.Peter Eisentraut
2003-03-27This patch implements holdable cursors, following the proposalBruce Momjian
(materialization into a tuple store) discussed on pgsql-hackers earlier. I've updated the documentation and the regression tests. Notes on the implementation: - I needed to change the tuple store API slightly -- it assumes that it won't be used to hold data across transaction boundaries, so the temp files that it uses for on-disk storage are automatically reclaimed at end-of-transaction. I added a flag to tuplestore_begin_heap() to control this behavior. Is changing the tuple store API in this fashion OK? - in order to store executor results in a tuple store, I added a new CommandDest. This works well for the most part, with one exception: the current DestFunction API doesn't provide enough information to allow the Executor to store results into an arbitrary tuple store (where the particular tuple store to use is chosen by the call site of ExecutorRun). To workaround this, I've temporarily hacked up a solution that works, but is not ideal: since the receiveTuple DestFunction is passed the portal name, we can use that to lookup the Portal data structure for the cursor and then use that to get at the tuple store the Portal is using. This unnecessarily ties the Portal code with the tupleReceiver code, but it works... The proper fix for this is probably to change the DestFunction API -- Tom suggested passing the full QueryDesc to the receiveTuple function. In that case, callers of ExecutorRun could "subclass" QueryDesc to add any additional fields that their particular CommandDest needed to get access to. This approach would work, but I'd like to think about it for a little bit longer before deciding which route to go. In the mean time, the code works fine, so I don't think a fix is urgent. - (semi-related) I added a NO SCROLL keyword to DECLARE CURSOR, and adjusted the behavior of SCROLL in accordance with the discussion on -hackers. - (unrelated) Cleaned up some SGML markup in sql.sgml, copy.sgml Neil Conway
2003-03-25Merge documentation into one book. (Build with "make html".) ReplacePeter Eisentraut
vague cross-references with real links.
2003-03-24Prevent multiple queries in a single string into a single transactionBruce Momjian
when autocommit is off, and document grouping when autocommit is on.
2003-03-24Another big editing pass for consistent content and presentation.Peter Eisentraut
2003-03-21Remove mention of transactions for insensitive cursors.Bruce Momjian
2003-03-20This is not the only place in the system catalogs where NULL isBruce Momjian
effectively used to mean a default value that could also be spelled out explicitly. (ACLs behave that way, and useconfig/datconfig do too IIRC.) It's a bit of a hack, but it saves table space and backend code --- without this convention the default would have to be inserted "manually" since we have no mechanism to supply defaults when C code is forming a new catalog tuple. I'm inclined to leave the code alone. But Alvaro is right that it'd be good to point out the 'infinity' option in the CREATE USER and ALTER USER man pages. (Doc patch please?) Alvaro Herrera
2003-03-20The documentation for SELECT is incorrect in a sense: the syntax for aBruce Momjian
join is defined as: from_item [ NATURAL ] join_type from_item [ ON join_condition | USING ( join_column_list ) ] However, if the join_type is an INNER or OUTER join, an ON, USING, or NATURAL clause *must* be specified (it's not optional, as that segment of the docs suggest). I'm not exactly sure what the best way to fix this is, so I've attached a patch adding a FIXME comment to the relevant section of the SGML. If anyone has any ideas on the proper way to outline join syntax, please speak up. Neil Conway <neilc@samurai.com> || PGP Key ID: DB3C29FC
2003-03-20Now that the CLUSTER ALL machinery is in place, the clusterdb script canBruce Momjian
be simplified (I'd thought that it can even be removed). This patch does that. Alvaro Herrera
2003-03-20Add ALTER TABLE <tablename> CLUSTER ON <indexname>Bruce Momjian
Alvaro Herrera
2003-03-20Fix typo in SGML tags.Bruce Momjian
2003-03-20Todo items:Bruce Momjian
Add ALTER SEQUENCE to modify min/max/increment/cache/cycle values Also updated create sequence docs to mention NO MINVALUE, & NO MAXVALUE. New Files: doc/src/sgml/ref/alter_sequence.sgml src/test/regress/expected/sequence.out src/test/regress/sql/sequence.sql ALTER SEQUENCE is NOT transactional. It behaves similarly to setval(). It matches the proposed SQL200N spec, as well as Oracle in most ways -- Oracle lacks RESTART WITH for some strange reason. -- Rod Taylor <rbt@rbt.ca>
2003-03-20(Now featuring documentation: fixed some typos, expanded theBruce Momjian
Envrironment and Files section, explained exactly what -w does) This is a patch which allows pg_ctl to make an intelligent guess as to the proper port when running 'psql -l' to determine if the database has started up (the -w flag). The environment variable PGPORT is used. If that is not found, it checks if a specific port has been set inside the postgresql.conf file. If it is has not, it uses the port that Postgres was compiled with. Greg Sabino Mullane greg@turnstep.com
2003-03-20Minor doc patch: create functionBruce Momjian
Gavin Sherry
2003-03-18Reimplement create and drop scripts in C, to reduce repetitivePeter Eisentraut
connections, increase robustness, add NLS, and prepare for Windows port. (vacuumdb and clusterdb will follow later.)
2003-03-18Remove duplicate ANALYZE recommendation in pg_dump.Bruce Momjian
2003-03-18Add mention of ANALYZE after object restore.Bruce Momjian
2003-03-11Implement SQL92-compatible FIRST, LAST, ABSOLUTE n, RELATIVE n optionsTom Lane
for FETCH and MOVE.
2003-03-10Restructure parsetree representation of DECLARE CURSOR: now it's aTom Lane
utility statement (DeclareCursorStmt) with a SELECT query dangling from it, rather than a SELECT query with a few unusual fields in it. Add code to determine whether a planned query can safely be run backwards. If DECLARE CURSOR specifies SCROLL, ensure that the plan can be run backwards by adding a Materialize plan node if it can't. Without SCROLL, you get an error if you try to fetch backwards from a cursor that can't handle it. (There is still some discussion about what the exact behavior should be, but this is necessary infrastructure in any case.) Along the way, make EXPLAIN DECLARE CURSOR work.
2003-02-19This patch makes the following changes to the documentation:Bruce Momjian
- more work from the SGML police - some grammar improvements: rewriting a paragraph or two, replacing contractions where (IMHO) appropriate - fix missing utility commands in lock mode docs - improve CLUSTER, REINDEX, SET SESSION AUTHORIZATION ref pages Neil Conway
2003-02-19This patch includes more SGML markup fixes as well as a few minorBruce Momjian
additions to the docs. Neil Conway
2003-02-13This patch fixes an error in the usage message for 'clusterdb', andBruce Momjian
makes a few editorial changes to the documentation. Neil Conway
2003-02-13> > They work the same as table constraints with in-line declaration (noBruce Momjian
> > comma). > > OK. But the documentation implies there is a comma, so it should probably > get chenged then. Yes, it should. (attached) [ Backpatched to 7.3.X too.] Rod Taylor
2003-02-13Code for WITHOUT OIDS.Bruce Momjian
On Wed, 2003-01-08 at 21:59, Christopher Kings-Lynne wrote: > I agree. I want to remove OIDs from heaps of our tables when we go to 7.3. > I'd rather not have to do it in the dump due to down time. Rod Taylor <rbt@rbt.ca>
2003-02-13[ dumping schemas ]Bruce Momjian
> I don't care what you use for short options if all useful ones are taken. > But the long option should be --schema. Ok, fair enough: a revised patch is attached that uses the '-n' short option and the '--schema' long option. Neil Conway
2003-02-04Revert doc change so we mention moving past the last row of a cursor.Bruce Momjian
2003-02-03Add mention of CURRENT_SCHEMA for object creation.Bruce Momjian
2003-02-03Change MOVE LAST to MOVE ALL.Bruce Momjian
Standard says FETCH LAST is after last row, and we don't do that.
2003-02-02Implement EXPLAIN EXECUTE. By Neil Conway, with some kibitzing fromTom Lane
Tom Lane.
2003-02-01Remove restriction that cast functions cannot be volatile. ThisTom Lane
restriction was debatable to begin with, but it has now become obvious that it breaks forward-porting of user-defined types; contrib/lo being the most salient example.
2003-01-23Grant options, and cascading revoke. Grant options are allowed only forPeter Eisentraut
users right now, not groups. Extension of has_foo_privileges functions to query the grant options. Extension of aclitem type to store grantor.
2003-01-19This patch includes a lot of minor cleanups to the SGML documentation,Bruce Momjian
including: - replacing all the appropriate usages of <citetitle>PostgreSQL ...</citetitle> with &cite-user;, &cite-admin;, and so on - fix an omission in the EXECUTE documentation - add some more text to the EXPLAIN documentation - improve the PL/PgSQL RETURN NEXT documentation (more work to do here) - minor markup fixes Neil Conway
2003-01-12SGML build cleanups from Neil Conway.Bruce Momjian
2003-01-11Fix markup problem in link to other SGML file.Bruce Momjian
2003-01-11Add doc links from SET to SET_CONSTRAINTS, SET_SESSION_AUTH,Bruce Momjian
SET_TRANSACTION.
2003-01-11Fix markup.Peter Eisentraut
2003-01-10Read-only transactions, as defined in SQL.Peter Eisentraut
2003-01-10Add optional drop behavior clause to REVOKE command, for SQL conformance.Peter Eisentraut
Currently, only RESTRICT is allowed.
2003-01-08Code review for FETCH/MOVE 0 changes. Improve documentation, do theTom Lane
right thing with the destination when FETCH 0 can't return a row, don't try to stuff LONG_MAX into an int value.
2003-01-07Apply the proper version of Christopher Kings-Lynne's describe patchTom Lane
(ie, the one with describe-schema support). Minor code review. Adjust display of casts to use standard type names.
2003-01-07Document that psql \encoding doesn't see SET CLIENT_ENCODING changes.Bruce Momjian
2003-01-06Use our own version of getopt_long() if the OS doesn't have one.Peter Eisentraut