Re: [DOCS] Documenting a DB schema

2008-03-05 Thread David Fetter
column a...'); > > (see http://dev.mysql.com/doc/refman/5.0/en/create-table.html) > > However, Postgres doesn't support the "comment" keyword. Actually, it does :) > Is there an alternative? Cheers, David. -- David Fetter <[EMAIL PROTECTED]> http:/

Re: [DOCS] FAQ on Embedding Postgres

2008-03-05 Thread David Fetter
On Wed, Mar 05, 2008 at 12:35:53PM -0500, Tom Lane wrote: > Bruce Momjian <[EMAIL PROTECTED]> writes: > > Richard Huxton wrote: > >> Bruce Momjian wrote: > > David Fetter wrote: > >>> If you really need to embed an > >>> SQL engine in a bina

Re: [DOCS] FAQ on Embedding Postgres

2008-03-05 Thread David Fetter
On Wed, Mar 05, 2008 at 12:56:01PM -0500, Tom Lane wrote: > David Fetter <[EMAIL PROTECTED]> writes: > > On Wed, Mar 05, 2008 at 12:35:53PM -0500, Tom Lane wrote: > >> If we need a FAQ entry on this at all, I'd stop after David's > >> first two sentenc

Re: [DOCS] FAQ on Embedding Postgres

2008-03-05 Thread David Fetter
dded SQL DBMSs rather than leave people with the feeling of, "It's all up to you from here. Go away." Cheers, David. -- David Fetter <[EMAIL PROTECTED]> http://fetter.org/ Phone: +1 415 235 3778 AIM: dfetter666 Yahoo!: dfetter Skype: davidfetter XMPP: [EMAIL PROTE

[DOCS] Windows ODBC FAQ

2008-05-25 Thread David Fetter
;Go to Programs -> Administrative Tools -> Data Sources and Add the PostgreSQL Unicode driver." Thanks to Dan Dascalescu (pidginusr) in IRC for pointing this out :) Cheers, David. -- David Fetter <[EMAIL PROTECTED]> http://fetter.org/ Phone: +1 415 235 3778 AIM: dfetter666 Ya

Re: [DOCS] TODO build rule

2008-08-17 Thread David Fetter
one to a makefile, btw. > > Oh, I forgot that README talked about making TODO.html. I have > updated the README to suggest using pgsql/src/tools/TODO2html. I thought this was going onto the wiki so Bruce doesn't have to be the sole maintainer :) Cheers, David. -- David Fe

[DOCS] SQL formatting in docs

2009-04-05 Thread David Niergarth
Hopefully not a naive question... How are all the queries in the postgres docs formatted? They're all very consistent and nice pretty printed, especially complex queries. How can I do the same? --David -- Sent via pgsql-docs mailing list ([email protected]) To make changes to

Re: [DOCS] SQL formatting in docs

2009-04-05 Thread David Niergarth
David Niergarth wrote: Hopefully not a naive question... How are all the queries in the postgres docs formatted? They're all very consistent and nice pretty printed, especially complex queries. How can I do the same? As an non-trivial example of what I mean, here's a query from C

Re: [DOCS] SQL formatting in docs

2009-04-05 Thread David Niergarth
Thanks for settling that for me; I've always wondered about it! --David Tom Lane wrote: David Niergarth writes: Hopefully not a naive question... How are all the queries in the postgres docs formatted? They're all very consistent and nice pretty printed, especially complex querie

Re: [DOCS] [GENERAL] Postgresql 8.3X supports Arrays of Composite Types?

2009-04-19 Thread David Fetter
RCHAR, num VARCHAR, PRIMARY KEY(cod, num) ); CREATE TABLE person ( name varchar, PRIMARY KEY(name) ) CREATE TABLE person_phone ( name VARCHAR NOT NULL REFERENCES person(name), cod VARCHAR, num VARCHAR, FOREIGN KEY(cod, num) REFERENCES phone(cod, num), PRIMAR

Re: [DOCS] [GENERAL] Postgresql 8.3X supports Arrays of Composite Types?

2009-04-20 Thread David Fetter
On Mon, Apr 20, 2009 at 08:13:15AM -0300, Robson Fidalgo wrote: > Hi David, > > Thanks for your help, but I want a relational-object solution. You can have one without denormalizing. Just use VIEWs and rewrite RULEs for INSERTs, UPDATEs and DELETEs on them. > The solution presented

[DOCS] Re: [COMMITTERS] pgsql: Proofreading adjustments for first two parts of documentation

2009-04-27 Thread David Fetter
had them, at least in some of their engines, for many years. Cheers, David. -- David Fetter http://fetter.org/ Phone: +1 415 235 3778 AIM: dfetter666 Yahoo!: dfetter Skype: davidfetter XMPP: [email protected] Remember to vote! Consider donating to Postgres: http://www.postgresql.o

Re: [DOCS] Re: [COMMITTERS] pgsql: Proofreading adjustments for first two parts of documentation

2009-04-27 Thread David Fetter
On Mon, Apr 27, 2009 at 09:50:13PM +0300, Peter Eisentraut wrote: > On Monday 27 April 2009 20:10:27 David Fetter wrote: > > While we're at it, can we see about moving foreign keys out of the > > "advanced" section? They've been standard for many years. He

Re: [DOCS] Re: [COMMITTERS] pgsql: Proofreading adjustments for first two parts of documentation

2009-04-27 Thread David Fetter
On Mon, Apr 27, 2009 at 10:56:28PM +0300, Peter Eisentraut wrote: > On Monday 27 April 2009 21:54:12 David Fetter wrote: > > On Mon, Apr 27, 2009 at 09:50:13PM +0300, Peter Eisentraut wrote: > > > On Monday 27 April 2009 20:10:27 David Fetter wrote: > > > > While

Re: [DOCS] [GENERAL] how to select temp table

2009-05-06 Thread David Fetter
//www.postgresql.org/docs/current/static/ddl-schemas.html > > Apparently the only mention of pg_temp is in the CREATE FUNCTION page. That's probably not a good omission. Any ideas as to where further mentions should go? Cheers, David. -- David Fetter http://fetter.org/ Phone: +1 41

Re: [DOCS] Postgres Sql7.3 Update

2009-09-03 Thread David Fetter
them. It > will take a long time to read as you're talking about 6 years of > development. It's a really, really good idea to build major version upgrades into your development, deployment and maintenance processes. Cheers, David. -- David Fetter http://fetter.org/ Phone: +1 415 2

[DOCS] Missing information on Expressional Indexes

2010-03-16 Thread David Fetter
'm thinking that something along the lines of, "Expressions are limited to those which are equivalent to an [link]IMMUTABLE[/link] function." Anybody have a better suggestion for wording? Cheers, David. -- David Fetter http://fetter.org/ Phone: +1 415 235 3778 AIM: dfetter

Re: [DOCS] INTEGER range ("-2147483648" is not accepted.)

2010-06-22 Thread David Fetter
nt out of range > postgres=# SELECT -9223372036854775808::bigint; > ERROR: bigint out of range > > I think those min values are all out by 1. Nope. Same problem. SELECT (-32768)::smallint; -32768 SELECT (-9223372036854775808)::bigint; -9223372036854775808 I agree that the appropriat

Re: [HACKERS] [DOCS] Sync rep doc corrections

2011-03-07 Thread David Fetter
ews, it helps me *enormously* to have only one list I need to check, so at least for me, it's an enormous help to have all patches at least CC'd, or better still, only posted, to -hackers. Cheers, David. -- David Fetter http://fetter.org/ Phone: +1 415 235 3778 AIM: dfetter666 Yahoo!: d

Re: [HACKERS] [DOCS] Sync rep doc corrections

2011-03-07 Thread David Fetter
On Mon, Mar 07, 2011 at 11:34:48PM +0530, Thom Brown wrote: > On 7 March 2011 23:21, David Fetter wrote: > > On Mon, Mar 07, 2011 at 10:53:17PM +0530, Thom Brown wrote: > >> On 7 March 2011 22:31, Robert Haas wrote: > >> > On Mon, Mar 7, 2011 at 6:16 AM, Thom Br

Re: [HACKERS] [DOCS] Sync rep doc corrections

2011-03-07 Thread David Fetter
eparation of docs from code is one that's actively unhelpful. We don't have a separate "docs" team, and we rightly put the responsibility of documenting changes on the person or people patching them in. Cheers, David. -- David Fetter http://fetter.org/ Phone: +1 415 235 3778 AI

Re: [HACKERS] [DOCS] Sync rep doc corrections

2011-03-07 Thread David Fetter
On Mon, Mar 07, 2011 at 02:31:18PM -0500, Robert Haas wrote: > On Mon, Mar 7, 2011 at 2:07 PM, David Fetter wrote: > > Re: docs, I'd actually like to see that list gone, as the separation > > of docs from code is one that's actively unhelpful.  We don't have a &g

Re: [DOCS] SQL key word list and SQL:2011

2012-05-20 Thread David Fetter
ons of the > > standard but then removed (e.g., BIT). Maybe those could be added > > with a note or something. > > Perhaps it'd be useful to keep just SQL-92 and SQL:2011, to give > some sense of how the standard's keyword set has evolved over time > while

[DOCS] doc page: ALTER VIEW

2013-01-02 Thread Sahagian, David
On the doc page for ALTER VIEW . . . In the discussion about SET/DROP DEFAULT, I am thinking that [instead-of insert trigger] should be mentioned in addition to [ON INSERT rule]. "A default value associated with a view column is inserted into INSERT statements on the view before the view's ON I

[DOCS] Create Table ... Like Including Default & Sequences

2013-06-14 Thread David Johnston
orrection is desired. For my purposes I'll likely just leave it alone. David J. -- View this message in context: http://postgresql.1045698.n5.nabble.com/Create-Table-Like-Including-Default-Sequences-tp5759108.html Sent from the PostgreSQL - docs mailing list archive at Nabble.com. --

Re: [DOCS] Google Doc Camp

2013-08-05 Thread David Fetter
+1 for PostgreSQL tutorials that actually tutor. Is it worth trying to do a baseline general one first, or going directly to separate ones for DBAs, app & DB developers, etc.? Cheers, David. On Sat, Aug 03, 2013 at 06:45:49PM -0700, Craig Kerstiens wrote: > Count me as both intrig

Re: [DOCS] regexp_replace 'g' flag

2013-09-06 Thread David Johnston
Sorry if you get this twice but I use Nabble and didn't subscribe to the list so my originals got put into the verification queue. I've subscribed now and am re-posting hoping it will go through clean. See my self-quote comment and my direct comment at the end. David Johnston wrot

Re: [DOCS] MVCC snapshot timing

2013-11-11 Thread David Johnston
intro but I wanted to get opinions on the approach first. David J. -- View this message in context: http://postgresql.1045698.n5.nabble.com/MVCC-snapshot-timing-tp559p5777852.html Sent from the PostgreSQL - docs mailing list archive at Nabble.com. -- Sent via pgsql-docs mailing

Re: [DOCS] MVCC snapshot timing

2013-11-11 Thread David Johnston
David Johnston wrote > This reads badly to my ears: >> This means that while querying a database each SQL statement sees a >> snapshot of data (a database version) as it was some time ago, regardless >> of the current state of the underlying data. > How about something clos

Re: [DOCS] MVCC snapshot timing

2013-11-12 Thread David Johnston
regarding the docs I try and put myself in the person's shoes and find not that the docs are incorrect but that they could be improved - which is just a part of our reality). My $0.02 David J. -- View this message in context: http://postgresql.1045698.n5.nabble.com/MVCC-snapshot-timing-tp5

Re: [DOCS] MVCC snapshot timing

2013-11-12 Thread David Johnston
Bruce Momjian wrote > On Tue, Nov 12, 2013 at 03:36:01PM -0800, David Johnston wrote: >> Bruce Momjian wrote >> > We just want to get across the MVCC concept in the intro --- we cover >> > the snapshots later in the document. >> >> I just think we're be

Re: [DOCS] MVCC snapshot timing

2013-11-12 Thread David Johnston
lt) as an outcome of MVCC should be included - in some form - in the introduction. In the current, proposed, and my revisions it is indeed covered but to various degrees of detail and low/high level focus. David J. -- View this message in context: http://postgresql.1045698.n5.nabble

Re: [DOCS] PATCH: Warn users about tablespace abuse data loss risk

2014-02-11 Thread David Johnston
> > Regards > > > Ian Barwick While providing additional warnings is good and necessary it may also help to be more descriptive as to in what situations tablespaces are appropriate and/or necessary so that people leave with a better understanding of why the feature exists and no

Re: [DOCS] pg_dump hangs

2014-02-24 Thread David Johnston
cated (since at least 8.4)... "-b" is only needed for selective dumps... "-v" you've turned on verbose mode - maybe include the last handful of output lines in your complaint... Given the apparent testing of different versions of PostgreSQL you should also provide the pairing of

Re: [DOCS] Some qualms with the current description of RegExp s,n,w modes.

2014-06-05 Thread David Johnston
On Thu, Jun 5, 2014 at 8:00 PM, Tom Lane wrote: > David G Johnston writes: > > I simplified ". and bracket expressions" to "wildcard" and "^ and $" to > > "anchors" though did make use of ^ and $individual quite a bit. I did > not >

Re: [DOCS] Some qualms with the current description of RegExp s,n,w modes.

2014-06-05 Thread David Johnston
[^]" and "^$" match the newline character, or not. [w] anchor newline-matching [n] dot/inverse-bracket newline-matching [s] newline-matching These are precise, what-oriented, names compared to: [w] record mode [n] multi-line mode [s] single-line mode which are more descriptive, use-oriented, names. Use of these label sets is not mutually exclusive... David J.

Re: [DOCS] [9.3] Should we mention "set_config(...)" in 18.1.3 in Server Configuration?

2014-06-08 Thread David Johnston
​Re-sending to hopefully avoid admin moderation rule.​ Fixing top-post as well. On Wed, May 21, 2014 at 4:37 PM, Tom Lane wrote: > >> David G Johnston writes: >> > Section 18.1.3 is named "18.1.3. Other Ways to Set Parameters" yet does >> not >> &g

Re: [DOCS] disabling log_rotation_age feature.

2014-06-12 Thread David Johnston
On Thursday, June 12, 2014, Tom Lane wrote: > David G Johnston > writes: > > On Thu, Jun 12, 2014 at 10:42 AM, Tom Lane-2 [via PostgreSQL] < > > [email protected] > wrote: > >> I wonder if we should round fractions up instead of down in

Re: [DOCS] disabling log_rotation_age feature.

2014-06-12 Thread David Johnston
forgot the list... On Thu, Jun 12, 2014 at 2:05 PM, David Johnston wrote: > On Thu, Jun 12, 2014 at 1:25 PM, Tom Lane wrote: > >> David Johnston writes: >> > On Thursday, June 12, 2014, Tom Lane wrote: >> >> I don't think that argument holds water ei

Re: [DOCS] [9.3] Should we mention "set_config(...)" in 18.1.3 in Server Configuration?

2014-09-09 Thread David Johnston
On Tue, Sep 9, 2014 at 3:13 PM, Bruce Momjian wrote: > On Thu, Jun 12, 2014 at 11:32:49AM -0400, David Johnston wrote: > > This addition still needs some work as well as the patch as a whole (see > my > > comments above). The attached PDF is the page that results from &quo

Re: [DOCS] [9.3] Should we mention "set_config(...)" in 18.1.3 in Server Configuration?

2014-09-10 Thread David Johnston
On Wed, Sep 10, 2014 at 4:20 PM, Bruce Momjian wrote: > On Tue, Sep 9, 2014 at 03:40:45PM -0400, David Johnston wrote: > > > "In addition to setting global defaults or attaching" <- add a comma > after > > "defaults" > > I didn'

Re: [DOCS] NULL as a (pseudo-)value not described?

2014-09-11 Thread David Johnston
John, please respond to the list next time. On Thu, Sep 11, 2014 at 9:24 AM, John Lumby wrote: > Thanks David ... but ... (below) > > > > Date: Wed, 10 Sep 2014 18:20:00 -0700 > > From: [email protected] > > To

Re: [DOCS] NULL as a (pseudo-)value not described?

2014-09-11 Thread David Johnston
On Thu, Sep 11, 2014 at 9:24 PM, johnlumby wrote: > On 09/11/14 10:03, David Johnston wrote: > On Thu, Sep 11, 2014 at 9:24 AM, John Lumby wrote: > > ​As I mentioned before the fact that null is a literal/constant is > assumed. My point here is that given that assumption

[DOCS] Fwd: warning about console code page on starting psql

2014-12-16 Thread David Johnston
;t see one come across but for now just reporting this. Would want to research methods for making both these items persist and recommending such. See my other curiosities below... David J. -- Forwarded message ------ From: *David G Johnston [via PostgreSQL]* < ml-node+s1045698n583104

Re: [DOCS] warning about console code page on starting psql

2014-12-16 Thread David Johnston
On Tuesday, December 16, 2014, David Johnston wrote: > Forwarding to -docs for now. > > I suggest simply dropping the "cmd.exe /c"part from the docs and mention > that the command should be run from an active console. A recommendation > for a batch file or similar

[DOCS] Typo in 49.2.1

2014-12-16 Thread David Johnston
not supported any more. The last two sentences are redundant. http://www.postgresql.org/docs/devel/static/protocol-flow.html#PROTOCOL-ASYNC David J.

[DOCS] Add Optional Variadic Invocation Explanation to 35.4.5 (xfunc-sql)

2014-12-19 Thread David Johnston
ation the second attempt succeeds. The alternative is to define an overloaded function without a VARIADIC parameter but with the same non-optional ones." Thoughts? Am I missing something? David J.

[DOCS] libpq "service" parameter not documented as not allowed inside a pg_service file

2014-12-19 Thread David Johnston
tion parameters; see Section 31.1.2 for a list but note that you may not include the "service" parameter within the pg_service file (i.e., aliases are not allowed). Thoughts? David J. P.S. Any chance on actually making this work? The recent comment about "\c service=name" not

Re: [DOCS] The IYYY mess again

2014-12-29 Thread David Johnston
On Mon, Dec 29, 2014 at 12:12 PM, Tom Lane wrote: > David G Johnston writes: > > Tom Lane-2 wrote > >> There is a warning against combining IYYY with MM/DD, but it's buried > >> in trivia far down the page. > > > Can we move this warning/notice into code

[DOCS] Suggest adding reference to pg_db_role_setting in chapter 18; expand catalog page

2015-01-16 Thread David Johnston
parts - which \drds does not do. I am imagine there might be a reason that the catalog pages do not reference the relevant psql meta-commands, or provide human-friendly examples, but I cannot think of what that might be and so here I provide. David J. diff --git a/doc/src/sgml/catalogs.sgml b/doc/src

Re: [DOCS] [HACKERS] "Extension" versus "module"

2011-02-14 Thread David E. Wheeler
hich. But given the precedent of the word "module," I don't suppose there's much choice. Best, David -- Sent via pgsql-docs mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs

[DOCS] [9.3] Should we mention "set_config(...)" in 18.1.3 in Server Configuration?

2014-05-21 Thread David G Johnston
link]set_config[link] function. Also, I would suggest modifying the function definitions in table 9-58 to include the data types: current_setting(setting_name text) set_config(setting_name text, new_value text, is_local boolean) David J. -- View this message in context: http://postgresql.10456

[DOCS] Some qualms with the current description of RegExp s,n,w modes.

2014-06-05 Thread David G Johnston
atch near an embedded newline - you have to use a literal \n to do that and then deal with the newline itself being part of the capture. This is best thought of as a compatibility mode since you can get the same behavior, without losing the unique behavior of ^ and $, in anchor-only mode with

Re: [DOCS] disabling log_rotation_age feature.

2014-06-11 Thread David G Johnston
gest documenting, if correct, that maximum resolution is minutes (rounding down) and thus any sub-1-minute value will be interpreted as zero and disable the feature. David J. -- View this message in context: http://postgresql.1045698.n5.nabble.com/disabling-log-rotation-age-feature-tp5806936

Re: [DOCS] disabling log_rotation_age feature.

2014-06-11 Thread David G Johnston
David G Johnston wrote > > Tomonari Katsumata-2 wrote >> Hi, >> >> I'm reading about log_rotation_age. >> And I noticed that the setting for disabling the feature is not clear. >> >> >> The document tells us to set it to ZERO if we want to

Re: [DOCS] disabling log_rotation_age feature.

2014-06-12 Thread David G Johnston
3 in Server Configuration? http://www.postgresql.org/message-id/cakfquwbbozrqmnx-xryd+vit+mcah6tvc0yn1ajtg5mdsna...@mail.gmail.com would be sufficient. Green field maybe I'd say yes but given that the new behavior could turn features on that are currently off it doesn't seem to be bene

Re: [DOCS] [PATCH] Various documentation typo/grammar fixes

2014-08-30 Thread David G Johnston
form. The goal would be to let them focus on writing but then have some kind of editing process - which is what is going on now - to aid in polishing the final publication. David J. -- View this message in context: http://postgresql.1045698.n5.nabble.com/PATCH-Various-documentation-typo-gramma

Re: [DOCS] NULL as a (pseudo-)value not described?

2014-09-10 Thread David G Johnston
d you go looking for it and where, in order, did you look? I'll agree that it seems that a previous recognition that null can always used as a valid data value is assumed much like it is assumed that 1000 is a valid value for an integer. David J. -- View this message in context: http://p

Re: [DOCS] The IYYY mess again

2014-12-29 Thread David G Johnston
he typical mistake goes away. David J. -- View this message in context: http://postgresql.nabble.com/The-IYYY-mess-again-tp5832272p5832322.html Sent from the PostgreSQL - docs mailing list archive at Nabble.com. -- Sent via pgsql-docs mailing list ([email protected]) To make change

Re: [DOCS] Aggregate expression syntax

2015-01-20 Thread David G Johnston
sting forms, while correct, are repetitive and that is what is being targeted but combining them into a single syntax block. But if that is too hard to read and understand then maybe some other means of simplification, like my example above, would work better. David J. -- View this messa

Re: [DOCS] how do I suggest a small docs change?

2015-01-25 Thread David G Johnston
that it's a page targeted at > beginners. That example uses the numeric type for currency; which is considerably less convoluted then forcing everything to have hundredths resolution and multiplication if you want to show the nominal unit (e.g. dollars). David J. -- View this message in context:

[DOCS] ROW or RANGE not optional in range specification

2015-03-31 Thread David G. Johnston
Y idx BETWEEN 5 PRECEDING AND CURRENT ROW" isn't obviously wrong until you get a syntax error... David J.

[DOCS] Add a new table for Transaction Isolation?

2015-04-13 Thread David G. Johnston
, probably right after the paragraph, with the same columns, three rows, and the corresponding possible/not-possible cell values? David J.

Re: [DOCS] Add a new table for Transaction Isolation?

2015-04-15 Thread David G. Johnston
On Wednesday, April 15, 2015, Bruce Momjian wrote: > On Mon, Apr 13, 2015 at 08:00:38PM -0700, David G. Johnston wrote: > > http://www.postgresql.org/docs/9.4/static/transaction-iso.html > > > > Table 13-1 shows the SQL standard isolation levels and what is and is not >

Re: [DOCS] Add a new table for Transaction Isolation?

2015-04-17 Thread David G. Johnston
ould think to go there for additional information. No like though - just a pointer to it or the Internet generally. It is not obvious to me what means...I suspect 1=yes... David J. On Wed, Apr 15, 2015 at 6:26 PM, David G. Johnston < [email protected]> wrote: > On Wednesday, Ap

Re: [DOCS] Add a new table for Transaction Isolation?

2015-04-24 Thread David G. Johnston
On Fri, Apr 24, 2015 at 9:57 AM, Peter Eisentraut wrote: > On 4/17/15 7:36 PM, David G. Johnston wrote: > > diff --git a/doc/src/sgml/mvcc.sgml b/doc/src/sgml/mvcc.sgml > > index f88b16e..5002138 100644 > > --- a/doc/src/sgml/mvcc.sgml > > +++ b/doc/src/sgml/mvcc

Re: [DOCS] Add a new table for Transaction Isolation?

2015-04-25 Thread David G. Johnston
http://momjian.us/expire/transaction-iso.html Need to add "Serialization Anomalies" to the previous section's definitions list. ​Pondering whether something like: "Possible (not in PG)" and avoiding the additional rows would make reading the table easier. David J.

Re: [DOCS] Add a new table for Transaction Isolation?

2015-04-25 Thread David G. Johnston
On Saturday, April 25, 2015, Kevin Grittner wrote: > Bruce Momjian > wrote: > > On Sat, Apr 25, 2015 at 07:45:35PM +, Kevin Grittner wrote: > > >> We could perhaps have the column header say "Non-Serializable > >> Behavior" or some such; but I think we need to define whatever > >> term we use

Re: [DOCS] Add a new table for Transaction Isolation?

2015-04-25 Thread David G. Johnston
possible (contra-SQL)" and emphasize our implementation and footnote the two differences. David J.

Re: [DOCS] Add a new table for Transaction Isolation?

2015-04-25 Thread David G. Johnston
On Saturday, April 25, 2015, David G. Johnston wrote: > On Saturday, April 25, 2015, Kevin Grittner > wrote: > >> Bruce Momjian wrote: >> > On Sat, Apr 25, 2015 at 07:45:35PM +, Kevin Grittner wrote: >> >> >> We could perhaps have the column heade

Re: [DOCS] "Alter system" command documentation

2015-06-15 Thread David G. Johnston
e public API for the application. Adding mention of pg_reload_conf may be warranted (probably is but I haven't made an independent evaluation) but removing SIGHUP is a separate concern and one that doesn't seem necessary. David J. ​

[DOCS] Omission of "(or C)" in psql's "pset title" header

2015-06-24 Thread David G. Johnston
http://www.postgresql.org/docs/devel/static/app-psql.html The other pset keywords with black-slash aliases include a "(or )" paren after the keyword. "title" does not (should be "C") David J.

[DOCS] Incomplete description in Create Operator (function arg order must match too)

2015-06-29 Thread David G. Johnston
s of arguments but in the reverse order. At least 9.3 appears not to... David J.

Re: [DOCS] Omission of "(or C)" in psql's "pset title" header

2015-08-26 Thread David G. Johnston
On Wed, Aug 26, 2015 at 10:02 PM, Bruce Momjian wrote: > On Wed, Jun 24, 2015 at 06:11:20PM -0400, David G. Johnston wrote: > > http://www.postgresql.org/docs/devel/static/app-psql.html > > > > The other pset keywords with black-slash aliases include a "(or > )

Re: [DOCS] Omission of "(or C)" in psql's "pset title" header

2015-08-27 Thread David G. Johnston
On Thu, Aug 27, 2015 at 11:13 AM, Bruce Momjian wrote: > On Wed, Aug 26, 2015 at 10:51:09PM -0400, David G. Johnston wrote: > > On Wed, Aug 26, 2015 at 10:02 PM, Bruce Momjian > wrote: > > > > On Wed, Jun 24, 2015 at 06:11:20PM -0400, David G. Johnst

Re: [DOCS] Omission of "(or C)" in psql's "pset title" header

2015-08-27 Thread David G. Johnston
On Thursday, August 27, 2015, Bruce Momjian wrote: > On Thu, Aug 27, 2015 at 11:50:53AM -0400, David G. Johnston wrote: > > ​Yes, I read that as "\pset tuples_only" and "\t" are alternate forms of > the > > same thing > > ​ and thought that "\pset

Re: [DOCS] Docs claim that "select myTable.*" wildcard won't let you assign column names

2015-09-21 Thread David G. Johnston
rs to it using * In this case the FROM clause is what is being alised. It is documented though I'd need to look to identify the specific location. It would not be documented in a section regarding the select-list. David J.

Re: [DOCS] Docs claim that "select myTable.*" wildcard won't let you assign column names

2015-09-21 Thread David G. Johnston
ere feature a query example show the use of a > wildcard for columns > >> as well as allowing you to assign names to as many of the leading > columns as you wish: > >> > >> > >> WITH T0 as ( SELECT 1,2,3 ) > >> SELECT T0.* from T0 as T0(foo,bar) ;<

[DOCS] Annoying "split to array" function inconsistency...best way to fix?

2015-09-27 Thread David G. Johnston
uld it be hateful to make it so that both entries appear on both tables? array_to_string(anyarray, text [,text]) could be lumped in with this as well. string_to_array not being on the string functions page is the more glaring omission for me. David J.

[DOCS] max_worker_processes default not documented

2016-05-07 Thread David G. Johnston
using max_worker_processes - provoking the very question as to how many is 2 relative to the default pool size. http://www.postgresql.org/docs/devel/static/runtime-config-resource.html#GUC-MAX-PARALLEL-DEGREE David J.

[DOCS] max_worker_processes default not documented

2016-05-12 Thread David G. Johnston
On Thursday, May 12, 2016, Peter Eisentraut < [email protected] > wrote: > On 5/7/16 11:16 PM, David G. Johnston wrote: > >> While this may be in the postgresql.conf it's absence in the docs is made >> noticeable by the fact both the immediately precedi

[DOCS] Is this example regarding aggregates sourced by subquery correct?

2016-05-20 Thread David G. Johnston
CT x FROM test ORDER BY y DESC)) The example seems expressly permitted by the standard and other database systems. I'll believe that said ordering in the example is not guaranteed but that isn't what it says. David J.

Re: [DOCS] Is this example regarding aggregates sourced by subquery correct?

2016-05-20 Thread David G. Johnston
On Fri, May 20, 2016 at 5:07 PM, Tom Lane wrote: > "David G. Johnston" writes: > > http://www.postgresql.org/docs/9.5/static/functions-aggregate.html > > """ > > SELECT xmlagg(x) FROM (SELECT x FROM test ORDER BY y DESC) AS tab; > > But this s

Re: [DOCS] Is this example regarding aggregates sourced by subquery correct?

2016-05-21 Thread David G. Johnston
On Saturday, May 21, 2016, Tom Lane wrote: > "David G. Johnston" > writes: > > Based upon what you've said I would soften it a bit. Given my own > > experience I'd probably point out what is now obvious to me - that the > > allowance of the ORDER BY

[DOCS] Typo in Create Database Synopsis

2016-05-31 Thread David G. Johnston
The second closing bracket after "connlimit" should be moved after "istemplate ]" The IS_TEMPLATE option can be prefixed by "WITH" when used alone. i.e., create database newdb with is_template false; David J.

[DOCS] Clarification of "void" type

2016-06-15 Thread David G. Johnston
s textually as the empty string. I'd maybe modify the table to read: void : A value that has no content: used to indicate that a function returns no value. https://www.postgresql.org/docs/devel/static/datatype-pseudo.html David J.

Re: [DOCS] Undocumented behavior od DROP SCHEMA ... CASCADE

2016-08-12 Thread David G. Johnston
hould probably add some kind of warning or something. > ​Yeah, it should probably be modified to something like: Automatically drop objects (tables, functions, etc...) that are contained in the schema. Each object dropped is also done with the CASCADE option. This means that others schemas will be affected if they depend on objects in the named schema. David J.​

Re: [DOCS] Undocumented behavior od DROP SCHEMA ... CASCADE

2016-08-12 Thread David G. Johnston
at would also be permitted to destroy data. Having such a dependency listing query distinguish between data-loss and other would be a good intermediate step. I haven't thought this out in depth, and its probably an unlikely area for improvement, but having recently spent a couple hours re-learning this (then confirming its working as intended via the docs) at least makes me want to bring it up. David J.

Re: [DOCS] Window function docs

2017-04-06 Thread David G. Johnston
On Thu, Apr 6, 2017 at 2:49 PM, Bruce Momjian wrote: > As part of writing a talk about window functions, I have done some > cleanups of the window function docs, attached, that I would like to > apply to head. +1 Overall. Some minor technical items noted below. The only conceptual item is whe

Re: [DOCS] Window function docs

2017-04-06 Thread David G. Johnston
On Thu, Apr 6, 2017 at 6:14 PM, Bruce Momjian wrote: > On Thu, Apr 6, 2017 at 03:53:24PM -0700, David G. Johnston wrote: > > > hypothetical-set aggregates as being distinct from ordered-set > aggregates yet > > the tables and the docs here do. > > Do you have

Re: [DOCS] default paramater is off

2017-05-11 Thread David G. Johnston
ct? false == off when dealing with a boolean parameter as described at: https://www.postgresql.org/docs/9.5/static/config-setting.html#CONFIG-SETTING-NAMES-VALUES David J.

Re: [DOCS] typo

2017-05-17 Thread David G. Johnston
t second sentence is part of the overall policy being described. The policy has two components which is why both FK constraints were changed. David J.

Re: [DOCS] Incorrect commands in manual for 9.6

2017-05-25 Thread David G. Johnston
g system's shell. You run "create database" with psql or some other SQL executing client. From your description you appear to be in an SQL executing program hence createdb and other command line applications will not work. David J.

Re: [DOCS] nothing ever works

2017-06-21 Thread David G. Johnston
t how things should work that are not true. Your welcome to your venting but all I see here is a specific case of learning having gone into spiral. The community here is great at helping people get themselves out these kinds of spirals. That the documentation cannot do so all by itself is not

Re: [DOCS] pg_restore documentation

2017-06-28 Thread David G. Johnston
; All -W does is force a prompt. There is no way to actually supply the password on the command line, that is what environment variables or pgpass are for. David J.

Re: [DOCS] ALTER SYSTEM is equal to editing postgresql.auto.conf, not postgres.conf

2017-07-13 Thread David G. Johnston
is not mechanically equivalent since, as you say, the contents of postgres.conf are not actually changed. David J.

Re: [DOCS] pg_dump "Access is denied" Windows 10

2017-07-20 Thread David G. Johnston
cause/solution would not be covered. Plus, frankly, the documentation doesn't go to any great efforts to deal with run-time environment problems (and its update schedule is not really suited for such). A more appropriate forum would be our wiki. https://wiki.postgresql.org/wiki/Main_Page David J.​

Re: [DOCS] recommending change to first example in 7.8.1

2017-07-25 Thread David G. Johnston
ity' to > be summed in the primary SELECT statement. I think this is a mistake. It isn't. > I do > not think this field exists in the WITH virtual table > It wouldn't matter if it did since in the main query the only from item is the orders table which can be reasonably assumed to contain a quantity column. David J.

Re: [DOCS] Confused about a statement in WAL configs

2017-07-31 Thread David G. Johnston
ys a checkpoint has occurred and that every change noted in the WAL files written before the marker entry and now known to exist in the actual data files on disk. Until that happens some of those change may only exist in memory (in the form of dirty data pages). David J.​

Re: [DOCS] Confused about a statement in WAL configs

2017-08-01 Thread David G. Johnston
On Tue, Aug 1, 2017 at 7:23 AM, Jeremy Finzel wrote: > > I *think* I follow now: before the checkpoint, the dirty data pages had > already been written to the WAL files, but not necessarily flushed to > disk. The checkpoint flushes them all to disk as well. > ​Yes, that it correct. David J.​

<    1   2   3   >