diff --git a/pages/common/psql.md b/pages/common/psql.md
index da93b0c13..92336a7e8 100644
--- a/pages/common/psql.md
+++ b/pages/common/psql.md
@@ -2,22 +2,22 @@
 
 > PostgreSQL command-line client.
 
-- Connect to *database*. It connects to localhost using default port *5432* with default user:
+- Connect to database. It connects to localhost using default port 5432 with default user as currently logged in user:
 
 `psql {{database}}`
 
-- Connect to *database* on given server *host* running on given *port* with *username* given, no password prompt:
+- Connect to database on given server host running on given port with given username, without a password prompt:
 
 `psql -h {{host}} -p {{port}} -U {{username}} {{database}}`
 
-- Connect to *database*, user will be prompted for password:
+- Connect to database; user will be prompted for password:
 
 `psql -h {{host}} -p {{port}} -U {{username}} -W {{database}}`
 
-- Run single *query* against the given *database*. Note: useful in shell scripts:
+- Execute a single SQL query or PostgreSQL command on the given database. Note: useful in shell scripts:
 
 `psql -c '{{query}}' {{database}}`
 
-- Run several queries against the given *database*. Note: useful in shell scripts:
+- Execute commands from a file on the given database:
 
-`echo '{{query1}}; {{query2}}' | psql {{database}}`
+`psql {{database}} -f {{file.sql}}`