public inbox for [email protected]  
help / color / mirror / Atom feed
Extra indentation in first line
3+ messages / 3 participants
[nested] [flat]

* Extra indentation in first line
@ 2018-02-26 13:43  PG Doc comments form <[email protected]>
  0 siblings, 1 reply; 3+ messages in thread

From: PG Doc comments form @ 2018-02-26 13:43 UTC (permalink / raw)
  To: [email protected]; +Cc: [email protected]

The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/10/static/textsearch-features.html
Description:

Hello,

In some queries there is an extra indentation. For example:

          SELECT to_tsquery('fat') <-> to_tsquery('cat | rat');
             ?column?
-----------------------------------
 'fat' <-> 'cat' | 'fat' <-> 'rat'

But there are no indentation (it's correct) here:

SELECT ts_rewrite('a & b'::tsquery,
                  'SELECT t,s FROM aliases WHERE ''a & b''::tsquery @>
t');
 ts_rewrite
------------
 'b' & 'c'

It seems that there are no such indentations within .sgml files.


^ permalink  raw  reply  [nested|flat] 3+ messages in thread

* Re: Extra indentation in first line
@ 2018-02-26 13:50  David G. Johnston <[email protected]>
  parent: PG Doc comments form <[email protected]>
  0 siblings, 1 reply; 3+ messages in thread

From: David G. Johnston @ 2018-02-26 13:50 UTC (permalink / raw)
  To: Artur Zakirov <[email protected]>; [email protected]

On Mon, Feb 26, 2018 at 6:43 AM, PG Doc comments form <
[email protected]> wrote:

> In some queries there is an extra indentation
> ​.
>

​I just now noticed the same thing while looking a report on GRANT syntax.
I've spotted checked a couple of other pages and found the same.  The
"code" blocks housing examples sometimes has extra leading whitespace
(indentation).​

We have recently switched to new tooling around the documentation so this
appearing now is not that surprising though I don't recall any recent
changes and this is the first report of such behavior I've seen.

David J.


^ permalink  raw  reply  [nested|flat] 3+ messages in thread

* Re: Extra indentation in first line
@ 2018-02-26 22:42  Tom Lane <[email protected]>
  parent: David G. Johnston <[email protected]>
  0 siblings, 0 replies; 3+ messages in thread

From: Tom Lane @ 2018-02-26 22:42 UTC (permalink / raw)
  To: David G. Johnston <[email protected]>; +Cc: Artur Zakirov <[email protected]>; [email protected]; [email protected]

"David G. Johnston" <[email protected]> writes:
> On Mon, Feb 26, 2018 at 6:43 AM, PG Doc comments form <
> [email protected]> wrote:
>> Page: https://www.postgresql.org/docs/10/static/textsearch-features.html
>> In some queries there is an extra indentation

> I just now noticed the same thing while looking a report on GRANT syntax.
> I've spotted checked a couple of other pages and found the same.  The
> "code" blocks housing examples sometimes has extra leading whitespace
> (indentation).​

> We have recently switched to new tooling around the documentation so this
> appearing now is not that surprising though I don't recall any recent
> changes and this is the first report of such behavior I've seen.

If you compare the different branches' versions of that page, it's OK in
"devel", and OK in some very old branches like 9.2, but not OK in any
of 9.3 through 10.  So I'm thinking that somebody broke some
version-specific website markup.  No idea how to investigate further,
but I'm cc'ing the www list for comment.

			regards, tom lane





^ permalink  raw  reply  [nested|flat] 3+ messages in thread


end of thread, other threads:[~2018-02-26 22:42 UTC | newest]

Thread overview: 3+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2018-02-26 13:43 Extra indentation in first line PG Doc comments form <[email protected]>
2018-02-26 13:50 ` David G. Johnston <[email protected]>
2018-02-26 22:42   ` Tom Lane <[email protected]>

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox