Re: [HACKERS] psql: new help related to variables are not too readable - Mailing list pgsql-hackers

From Pavel Stehule
Subject Re: [HACKERS] psql: new help related to variables are not too readable
Date
Msg-id CAFj8pRC3hn5_vP2gByR7Sv6fb5QvDsv8M=DPDW9RenTrf8L=Lg@mail.gmail.com
Whole thread Raw
In response to Re: [HACKERS] psql: new help related to variables are not tooreadable  (Alvaro Herrera <alvherre@alvh.no-ip.org>)
List pgsql-hackers


2017-09-18 11:44 GMT+02:00 Alvaro Herrera <alvherre@alvh.no-ip.org>:
Pavel Stehule wrote:

> I am looking on man pagers - and there are very well readable
>
> The rules are simply - when some variables are short - less than 6 chars,
> then it description and label are on same line. Between items are empty
> line

I was having a similar idea.  I'm not sure how many lines we would save
that way, but it seems to me we could use a slightly longer threshold --
say 8 chars before we cause a newline and wrap.

Maybe we need to come up with guidelines for translators, also.  As
somebody noted, I've always gone to some trouble to produce translate
output that preserves the original's constraints; I don't see any reason
forother translations to behave differently.

(By all means, if we add entry-separating newlines, let's not put them
as part of the translatable string.)

+1

Pavel


--
Álvaro Herrera                https://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services

pgsql-hackers by date:

Previous
From: Tom Lane
Date:
Subject: Re: [HACKERS] src/test/subscription/t/005_encoding.pl is broken
Next
From: Andres Freund
Date:
Subject: Re: [HACKERS] Re: [COMMITTERS] pgsql: Perform only oneReadControlFile() during startup.