Re: proposal: psql –help reflecting service or URI usage

> On Mar 8, 2021, at 8:40 AM, Paul Förster wrote: > > Hi Mark, > >> On 08. Mar, 2021, at 16:39, Mark Dilger wrote: >> >> Fortunately, the man pages and html docs are generated from the same >> sources. Those sources are written in sgml, and the tools to build the docs >> must be installe

Re: proposal: psql –help reflecting service or URI usage

Hi Mark, > On 08. Mar, 2021, at 16:39, Mark Dilger wrote: > > Fortunately, the man pages and html docs are generated from the same sources. > Those sources are written in sgml, and the tools to build the docs must be > installed. From the top directory, execute `make docs` and if it complain

Re: proposal: psql –help reflecting service or URI usage

> On Mar 6, 2021, at 5:55 AM, Paul Förster wrote: > > Hi Mark, > > sorry for the delay. > >> On 01. Mar, 2021, at 17:02, Mark Dilger wrote: >> >> The output from --help should fit in a terminal window with only 80 >> characters width. For example, in src/bin/scripts/createuser.c the line

Re: proposal: psql –help reflecting service or URI usage

Hi Euler, > On 01. Mar, 2021, at 15:42, Euler Taveira wrote: > > We try to limit it to 80 characters but it is not a hard limit. Long > descriptions should certainly be split into multiple lines. got that, thanks. > The question is: how popular is service and connection URIs? well, we use th

Re: proposal: psql –help reflecting service or URI usage

Hi Mark, sorry for the delay. > On 01. Mar, 2021, at 17:02, Mark Dilger wrote: > > The output from --help should fit in a terminal window with only 80 > characters width. For example, in src/bin/scripts/createuser.c the line > about --interactive is wrapped: I see. > You can find counter-e

Re: proposal: psql –help reflecting service or URI usage

> On Feb 28, 2021, at 10:10 AM, Paul Förster wrote: > > Hi Mark, > >> On 28. Feb, 2021, at 17:54, Mark Dilger wrote: >> >> "definited" is a typo. > > yes, definitely a typo, sorry. Thanks for pointing this out. > >> Should this say "as defined in pg_service.conf"? That's the default, but

Re: proposal: psql –help reflecting service or URI usage

On Mon, Mar 1, 2021, at 10:32 AM, Paul Förster wrote: > still, what is the line length limit? Where do I find it? We try to limit it to 80 characters but it is not a hard limit. Long descriptions should certainly be split into multiple lines.

Re: proposal: psql –help reflecting service or URI usage

Hi Mark, I revisited my first admittedly naive and faulty attempt. > On 28. Feb, 2021, at 19:10, Paul Förster wrote: > >> but of course being careful to still fit in the line length limit. > I agree to all, thanks. What is the line length limit? still, what is the line length limit? Where do I

Re: proposal: psql –help reflecting service or URI usage

Hi Mark, > On 28. Feb, 2021, at 17:54, Mark Dilger wrote: > > "definited" is a typo. yes, definitely a typo, sorry. Thanks for pointing this out. > Should this say "as defined in pg_service.conf"? That's the default, but the > user might have $PGSERVICEFILE set to something else. Perhaps yo

Re: proposal: psql –help reflecting service or URI usage

> On Feb 28, 2021, at 1:57 AM, Paul Förster wrote: > > Hi, > > I'd like to propose a patch to psql --help output: > > Currently it is: > > Usage: > psql [OPTION]... [DBNAME [USERNAME]] > > ... > > Connection options: > -h, --host=HOSTNAME database server host or socket directory (d

proposal: psql –help reflecting service or URI usage

Hi, I'd like to propose a patch to psql --help output: Currently it is: Usage: psql [OPTION]... [DBNAME [USERNAME]] ... Connection options: -h, --host=HOSTNAME database server host or socket directory (default: "local socket") -p, --port=PORT database server port (default: