summaryrefslogtreecommitdiff
path: root/doc/src
AgeCommit message (Collapse)Author
2012-05-03doc: Fix for too many brackets in command synopses on man pagesPeter Eisentraut
The default for the choice attribute of the <arg> element is "opt", which would normally put the argument inside brackets. But the DSSSL stylesheets contain a hack that treats <arg> directly inside <group> specially, so that <group><arg>-x</arg><arg>-y</arg></group> comes out as [ -x | -y ] rather than [ [-x] | [-y] ], which it would technically be. But when building man pages, this doesn't work, and so the command synopses on the man pages contain lots of extra brackets. By putting choice="opt" or choice="plain" explicitly on every <arg> and <group> element, we avoid any toolchain dependencies like that, and it also makes it clearer in the source code what is meant. In passing, make some small corrections in the documentation about which arguments are really optional or not.
2012-05-03Remove BSD/OS (BSDi) port. There are no known users upgrading toBruce Momjian
Postgres 9.2, and perhaps no existing users either.
2012-05-01Remove dead portsPeter Eisentraut
Remove the following ports: - dgux - nextstep - sunos4 - svr4 - ultrix4 - univel These are obsolete and not worth rescuing. In most cases, there is circumstantial evidence that they wouldn't work anymore anyway.
2012-04-30Improve markup of cmdsynopsis elementsPeter Eisentraut
Add more markup in particular so that the command options appear consistently in monospace in the HTML output. On the vacuumdb reference page, remove listing all the possible options in the synopsis. They have become too many now; we have the detailed options list for that.
2012-04-30Fix display of <command> elements on man pagesPeter Eisentraut
We had changed this from the default bold to monospace for all output formats, but for man pages, this creates visual inconsistencies, so revert to the default for man pages.
2012-04-30Converge all SQL-level statistics timing values to float8 milliseconds.Tom Lane
This patch adjusts the core statistics views to match the decision already taken for pg_stat_statements, that values representing elapsed time should be represented as float8 and measured in milliseconds. By using float8, we are no longer tied to a specific maximum precision of timing data. (Internally, it's still microseconds, but we could now change that without needing changes at the SQL level.) The columns affected are pg_stat_bgwriter.checkpoint_write_time pg_stat_bgwriter.checkpoint_sync_time pg_stat_database.blk_read_time pg_stat_database.blk_write_time pg_stat_user_functions.total_time pg_stat_user_functions.self_time pg_stat_xact_user_functions.total_time pg_stat_xact_user_functions.self_time The first four of these are new in 9.2, so there is no compatibility issue from changing them. The others require a release note comment that they are now double precision (and can show a fractional part) rather than bigint as before; also their underlying statistics functions now match the column definitions, instead of returning bigint microseconds.
2012-04-29Rename I/O timing statistics columns to blk_read_time and blk_write_time.Tom Lane
This seems more consistent with the pre-existing choices for names of other statistics columns. Rename assorted internal identifiers to match.
2012-04-29Rename track_iotiming GUC to track_io_timing.Tom Lane
This spelling seems significantly more readable to me.
2012-04-29Further editorialization on the new documentation for statistics views.Tom Lane
Get rid of the per-column documentation of underlying functions, which did far more to clutter the view descriptions than it did to be helpful, and was rather incomplete and typo-ridden anyway. Instead suggest that people consult the definitions of the standard views to see the underlying functions. The older functions for obtaining individual facts about backends are now somewhat obsoleted by pg_stat_get_activity, which means that they are not documented by any standard view. So I put that information into a separate table. (Maybe we should just deprecate them instead?) In passing, fix a couple more documentation errors.
2012-04-29Make a copy-editing pass over the new documentation for statistics views.Tom Lane
Fix a bunch of typos, improve markup, make wording more uniform, rearrange some material. No substantive changes.
2012-04-28Adjust timing units in pg_stat_statements.Tom Lane
Display total time and I/O timings in milliseconds, for consistency with the units used for timings in the core statistics views. The columns remain of float8 type, so that sub-msec precision is available. (At some point we will probably want to convert the core views to use float8 type for the same reason, but this patch does not touch that issue.) This is a release-note-requiring change in the meaning of the total_time column. The I/O timing columns are new as of 9.2, so there is no compatibility impact from redefining them. Do some minor copy-editing in the documentation, too.
2012-04-28PL/Python: Update list of supported environment variablesPeter Eisentraut
2012-04-26Improve documentation around historical calendar rules.Tom Lane
Get rid of section 8.5.6 (Date/Time Internals), which appears to confuse people more than it helps, and anyway discussion of Postgres' internal datetime calculation methods seems pretty out of place here. Instead, make datatype.sgml just say that we follow the Gregorian calendar (a bit of specification not previously present anywhere in that chapter :-() and link to the History of Units appendix for more info. Do some mild editorialization on that appendix, too, to make it clearer that we are following proleptic Gregorian calendar rules rather than anything more historically accurate. Per a question from Florence Cousin and subsequent discussion in pgsql-docs.
2012-04-24Standardize indentation of XSL filesPeter Eisentraut
Predominant standard is two spaces, so adjust outliers to that.
2012-04-24Fix minor stylistic issuePeter Eisentraut
2012-04-24Casts to or from a domain type are ignored; warn and document.Robert Haas
Prohibiting this outright would break dumps taken from older versions that contain such casts, which would create far more pain than is justified here. Per report by Jaime Casanova and subsequent discussion.
2012-04-23Lots of doc corrections.Robert Haas
Josh Kupershmidt
2012-04-23Minor improvements for CHECK NO INHERIT documentation.Robert Haas
Fix typo spotted by Thom Brown, and improve wording in another area where Thom spotted a typo.
2012-04-20Recast "ONLY" column CHECK constraints as NO INHERITAlvaro Herrera
The original syntax wasn't universally loved, and it didn't allow its usage in CREATE TABLE, only ALTER TABLE. It now works everywhere, and it also allows using ALTER TABLE ONLY to add an uninherited CHECK constraint, per discussion. The pg_constraint column has accordingly been renamed connoinherit. This commit partly reverts some of the changes in 61d81bd28dbec65a6b144e0cd3d0bfe25913c3ac, particularly some pg_dump and psql bits, because now pg_get_constraintdef includes the necessary NO INHERIT within the constraint definition. Author: Nikhil Sontakke Some tweaks by me
2012-04-19Untabify DSSSL and XSL files and add to check-tabs targetPeter Eisentraut
Like with SGML files, using tabs in these files is confusing and unnecessary.
2012-04-18Doc clarification for synchronous_commit.Robert Haas
Fujii Masao
2012-04-16Add compatibility information for prepared transaction commandsPeter Eisentraut
2012-04-16PL/Python: Improve documentation of nrows() methodPeter Eisentraut
Clarify that nrows() is the number of rows processed, versus the number of rows returned, which can be obtained using len. Also add tests about that.
2012-04-15PL/Python: Fix crash when colnames() etc. called without result setPeter Eisentraut
The result object methods colnames() etc. would crash when called after a command that did not produce a result set. Now they throw an exception. discovery and initial patch by Jean-Baptiste Quenot
2012-04-14Rename synchronous_commit='write' to 'remote_write'.Robert Haas
Fujii Masao, per discussion on pgsql-hackers
2012-04-14pg_size_pretty(numeric)Robert Haas
The output of the new pg_xlog_location_diff function is of type numeric, since it could theoretically overflow an int8 due to signedness; this provides a convenient way to format such values. Fujii Masao, with some beautification by me.
2012-04-14Add description of long options for '-c', '-D', '-l' and '-s'. PerTatsuo Ishii
discussion of hackers list on 2012/3/10 "missing description initdb manual".
2012-04-14Document that VALUES can be used in WITHPeter Eisentraut
2012-04-14Fix typoPeter Eisentraut
Etsuro Fujita
2012-04-13Add Peter Geoghegan as additional author of pg_stat_statements.Robert Haas
2012-04-13Rename bytea_agg to string_agg and add delimiter argumentPeter Eisentraut
Per mailing list discussion, we would like to keep the bytea functions parallel to the text functions, so rename bytea_agg to string_agg, which already exists for text. Also, to satisfy the rule that we don't want aggregate functions of the same name with a different number of arguments, add a delimiter argument, just like string_agg for text already has.
2012-04-13Grammar corrections.Robert Haas
Christoph Berg
2012-04-12Assorted spelling corrections.Tom Lane
Thom Brown
2012-04-11Silently ignore any nonexistent schemas that are listed in search_path.Tom Lane
Previously we attempted to throw an error or at least warning for missing schemas, but this was done inconsistently because of implementation restrictions (in many cases, GUC settings are applied outside transactions so that we can't do system catalog lookups). Furthermore, there were exceptions to the rule even in the beginning, and we'd been poking more and more holes in it as time went on, because it turns out that there are lots of use-cases for having some irrelevant items in a common search_path value. It seems better to just adopt a philosophy similar to what's always been done with Unix PATH settings, wherein nonexistent or unreadable directories are silently ignored. This commit also fixes the documentation to point out that schemas for which the user lacks USAGE privilege are silently ignored. That's always been true but was previously not documented. This is mostly in response to Robert Haas' complaint that 9.1 started to throw errors or warnings for missing schemas in cases where prior releases had not. We won't adopt such a significant behavioral change in a back branch, so something different will be needed in 9.1.
2012-04-11Accept postgres:// URIs in libpq connection functionsAlvaro Herrera
postgres:// URIs are an attempt to "stop the bleeding" in this general area that has been said to occur due to external projects adopting their own syntaxes. The syntaxes supported by this patch: postgres://[user[:pwd]@][unix-socket][:port[/dbname]][?param1=value1&...] postgres://[user[:pwd]@][net-location][:port][/dbname][?param1=value1&...] should be enough to cover most interesting cases without having to resort to "param=value" pairs, but those are provided for the cases that need them regardless. libpq documentation has been shuffled around a bit, to avoid stuffing all the format details into the PQconnectdbParams description, which was already a bit overwhelming. The list of keywords has moved to its own subsection, and the details on the URI format live in another subsection. This includes a simple test program, as requested in discussion, to ensure that interesting corner cases continue to work appropriately in the future. Author: Alexander Shulgin Some tweaking by Álvaro Herrera, Greg Smith, Daniel Farina, Peter Eisentraut Reviewed by Robert Haas, Alexey Klyukin (offlist), Heikki Linnakangas, Marko Kreen, and others Oh, it also supports postgresql:// but that's probably just an accident.
2012-04-10Measure epoch of timestamp-without-time-zone from local not UTC midnight.Tom Lane
This patch reverts commit 191ef2b407f065544ceed5700e42400857d9270f and thereby restores the pre-7.3 behavior of EXTRACT(EPOCH FROM timestamp-without-tz). Per discussion, the more recent behavior was misguided on a couple of grounds: it makes it hard to get a non-timezone-aware epoch value for a timestamp, and it makes this one case dependent on the value of the timezone GUC, which is incompatible with having timestamp_part() labeled as immutable. The other behavior is still available (in all releases) by explicitly casting the timestamp to timestamp with time zone before applying EXTRACT. This will need to be called out as an incompatible change in the 9.2 release notes. Although having mutable behavior in a function marked immutable is clearly a bug, we're not going to back-patch such a change.
2012-04-10Point the URL to PL/py directly to the page about the procedural language.Heikki Linnakangas
It used to point to a top-level page that contains client-side tools as well. It was hard to find the procedural language there.
2012-04-10Fix typos in docs, some words were doubled.Heikki Linnakangas
Thom Brown
2012-04-09Adjust various references to GEQO being non-deterministic.Tom Lane
It's still non-deterministic in some sense ... but given fixed settings and identical planning problems, it will now always choose the same plan, so we probably shouldn't tar it with that brush. Per bug #6565 from Guillaume Cottenceau. Back-patch to 9.0 where the behavior was fixed.
2012-04-09Re-add documentation recommendation to use gzip/gunzip for archive fileBruce Momjian
storage.
2012-04-09Update documentation to more clearly label the streaming replication option.Bruce Momjian
2012-04-09Remove documentation mention of pglesslog, which was added in 2009Bruce Momjian
because there was only a beta for 9.0 and it does not compile on 9.1.
2012-04-09Remove link to ODBCng project from the docs.Heikki Linnakangas
Thom Browne pointed out that the URL was out of date, and Devrim GÜNDÜZ pointed out that the project isn't maintained anymore.
2012-04-06Update URL for pgtclng project.Tom Lane
Thom Brown
2012-04-06Fix some typos in the documentationPeter Eisentraut
Thom Brown
2012-04-06Correct various system catalog/view definitions in the documentationPeter Eisentraut
Thom Brown
2012-04-06Dept of second thoughts: improve the API for AnalyzeForeignTable.Tom Lane
If we make the initially-called function return the table physical-size estimate, acquire_inherited_sample_rows will be able to use that to allocate numbers of samples among child tables, when the day comes that we want to support foreign tables in inheritance trees.
2012-04-06Allow statistics to be collected for foreign tables.Tom Lane
ANALYZE now accepts foreign tables and allows the table's FDW to control how the sample rows are collected. (But only manual ANALYZEs will touch foreign tables, for the moment, since among other things it's not very clear how to handle remote permissions checks in an auto-analyze.) contrib/file_fdw is extended to support this. Etsuro Fujita, reviewed by Shigeru Hanada, some further tweaking by me.
2012-04-06Add DROP INDEX CONCURRENTLY [IF EXISTS], uses ShareUpdateExclusiveLockSimon Riggs
2012-04-05Allow pg_archivecleanup to strip optional file extensions.Robert Haas
Greg Smith and Jaime Casanova, reviewed by Alex Shulgin and myself. e