okbob / pspg

Unix pager (with very rich functionality) designed for work with tables. Designed for PostgreSQL, but MySQL is supported too. Works well with pgcli too. Can be used as CSV or TSV viewer too. It supports searching, selecting rows, columns, or block and export selected area to clipboard.
BSD 2-Clause "Simplified" License
2.48k stars 86 forks source link

Clearer + more visible installation instructions? #234

Closed karlhorky closed 10 months ago

karlhorky commented 10 months ago

Hi there, thanks for this project! Looks amazing.

I would like to recommend it to our students, but the installation + configuration guide is a bit spread out in the readme.

Would you be open to:

  1. Consolidating the installation + configuration parts (only 1 single guide to follow, not multiple)
  2. Making it more visible in the readme (eg. moving it up to directly below a brief introduction of what the tool is and what it can do

Would be great and I would imagine would help with more users installing this great tool.

okbob commented 10 months ago

Maybe as author of pspg I living in own bubble, because installation is just sudo dnf install pspg and necessary configuration is export PSQL_PAGER=pspg. But sure, I invite any PR to readme to be better for beginners or students (I am not sure, if I able to do - I have minimal language skills in English language, and I am little bit isolated from students or beginners now, so I maybe I don't understand what they prefer.

okbob commented 10 months ago

I wrote new section 3c336951585bf3253bd47375a7842af89851dc1a

karlhorky commented 10 months ago

@okbob nice! What about also including brew install pspg (macOS) in the shorter installation instructions section?

okbob commented 10 months ago

so 30. 12. 2023 v 1:47 odesílatel Karl Horky @.***> napsal:

@okbob https://github.com/okbob nice! What about also including brew install pspg (macOS) in the shorter installation instructions section?

it is there already

https://github.com/okbob/pspg#homebrew-for-linux--macos

— Reply to this email directly, view it on GitHub https://github.com/okbob/pspg/issues/234#issuecomment-1872409304, or unsubscribe https://github.com/notifications/unsubscribe-auth/AAEFO45KM7ZCTKNBW2UNUFDYL5QB5AVCNFSM6AAAAABAXRU7MGVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMYTQNZSGQYDSMZQGQ . You are receiving this because you were mentioned.Message ID: @.***>

okbob commented 10 months ago

d7e1a581258c1c08d69fddbca07513fb35e4f2c2

karlhorky commented 10 months ago

Nice, thanks!

These new commits seem to resolve this issue, so I'm closing it now.