type point

2018-10-16 Thread PG Doc comments form
The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/9.4/static/datatype-geometric.html
Description:

I think that the information on points should contain a sentence like this:
"Order is Longitude, Latitude - so if you plot it as the map, it is (x,
y)."

[1] https://www.postgresql.org/docs/current/static/datatype-geometric.html
[2] https://stackoverflow.com/a/47396542/1602492


Re: type point

2018-10-16 Thread Bruce Momjian
On Tue, Oct 16, 2018 at 06:15:08AM +, PG Doc comments form wrote:
> The following documentation comment has been logged on the website:
> 
> Page: https://www.postgresql.org/docs/9.4/static/datatype-geometric.html
> Description:
> 
> I think that the information on points should contain a sentence like this:
> "Order is Longitude, Latitude - so if you plot it as the map, it is (x,
> y)."
> 
> [1] https://www.postgresql.org/docs/current/static/datatype-geometric.html
> [2] https://stackoverflow.com/a/47396542/1602492

Well, as I remember, our geometric types don't know anything about
longitude or latitude.  PostGIS does handle this, but it is a separate
project team.

-- 
  Bruce Momjian  http://momjian.us
  EnterpriseDB http://enterprisedb.com

+ As you are, so once was I.  As I am, so you will be. +
+  Ancient Roman grave inscription +



Re: Proposed HTML Documentation Styles

2018-10-16 Thread Jonathan S. Katz
On 10/4/18 11:50 AM, Jonathan S. Katz wrote:
> Hi,
> 
> As part of the effort to modernize the look and feel of PostgreSQL.org
> and associated web projects, Sarah & I have worked on applying the new
> styles to the documentation. The main goals of the project were:
> 
> - To have the documentation styles match that of the main website
> - To make the documentation easier to view on mobile devices
> - To set up the web-based documentation for future usability changes and
> improvements

Thank you everyone for your feedback. We launched the new documentation
styles this morning. Please let us know if you find any issues or have
any additional feedback.

Thanks,

Jonathan



signature.asc
Description: OpenPGP digital signature


Re: effective_cache_size

2018-10-16 Thread Bruce Momjian
On Thu, Oct 11, 2018 at 01:48:49PM -0400, Bruce Momjian wrote:
> So, I think there are two action items here.  First, rename "disk" to
> "drive" or "storage" in the docs and server variable descriptions. 
> Second, unify the description of effective_cache_size to talk about
> storage cache size, not just kernel storage cache, and maybe even talk
> about the double buffering effect.

I have attached a patch for the second item, which I would like to
backpatch.  I don't think I want to deal with all the "disk" mentions at
this time.

-- 
  Bruce Momjian  http://momjian.us
  EnterpriseDB http://enterprisedb.com

+ As you are, so once was I.  As I am, so you will be. +
+  Ancient Roman grave inscription +
diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index 7554cba..b8e32d7 100644
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -4147,7 +4147,8 @@ ANY num_sync ( 

RE: Proposed HTML Documentation Styles

2018-10-16 Thread Alexander Romanenko
I am having problem with distinguishing tables from the description body
without shadows. Without a shadow, stronger border and headings,  like in
old version, tables likes function parameter lists blends in with
description paragraphs.


Re: Proposed HTML Documentation Styles

2018-10-16 Thread Jonathan S. Katz
Hi Alexander,

On 10/16/18 2:44 PM, Alexander Romanenko wrote:
> I am having problem with distinguishing tables from the description body
> without shadows. Without a shadow, stronger border and headings,  like
> in old version, tables likes function parameter lists blends in with
> description paragraphs.

I went ahead and made a change to make the table section headers to
stand out more in the documentation and verified on the documentation
for all supported versions.

Thanks,

Jonathan



signature.asc
Description: OpenPGP digital signature


Re: Proposed HTML Documentation Styles

2018-10-16 Thread Alexander Romanenko
Thanks for the response! The change did help a bit.
I guess no hope to make shadows come back? If not, I think I can find some
browser extension that modifies  tag CSS for the docs domain to
include it locally.

вт, 16 окт. 2018 г. в 20:23, Jonathan S. Katz :

> Hi Alexander,
>
> On 10/16/18 2:44 PM, Alexander Romanenko wrote:
> > I am having problem with distinguishing tables from the description body
> > without shadows. Without a shadow, stronger border and headings,  like
> > in old version, tables likes function parameter lists blends in with
> > description paragraphs.
>
> I went ahead and made a change to make the table section headers to
> stand out more in the documentation and verified on the documentation
> for all supported versions.
>
> Thanks,
>
> Jonathan
>
>