docs

Author: gggeek

doc/TODO.md

@@ -75,7 +75,7 @@
     + sqllite in default output mode is even worse... (see below)
   + try to have mssql use a smaller (but dynamic) col width for varchar results
   + investigate the possibility of having the clients emitting directly json results instead of plaintext
-    + also: sqlite 3 has a more 'tabular' mode to display results, but it seems not to be able to calculate col. width automatically...
+    + also: sqlite 3 has a 'tabular' mode to display results, but it seems not to be able to calculate col. width automatically...
   + test selecting string with length > 200 chars: ok
 
 - improve travis testing:
@@ -116,13 +116,14 @@
   + remove more unused stuff from containers, such as fdisk?, etc...
 
 - host: improve cli scripts:
-  + add a script that removes docker images and containers (eg. docker-compose down)
+  + add removal of docker images and containers (eg. docker-compose down)
   + move from bash to sh ? also, reduce the number of cli commands we use (listed in readme)
   + add shell completion for commands of dbstack
 
 - worker: improve cli scripts
   + allow to drop many dbs, users in single commands
   + add a user:create command which takes as option the list of dbs to grant access to
+  + add --database option to database:shell command
   + either remove ./vendor/bin/doctrine-dbal or make it actually work
   + make it possible to have uniform table formatting for SELECT-like queries
     - test with rows containing multiple cols, newlines, ...

doc/WHATSNEW.md

@@ -1,26 +1,28 @@
-Version ?? (unreleased)
------------------------
+Version 0.10
+------------
 
-- Breaking changed: renamed `stack.sh` to `dbstack`, removed `cleanup-databases.sh`, `cleanup-docker-images.sh`, and
-  `cleanup-logs.sh` (functionality of the last 3 has been added to `dbstack`)
+- Breaking change: renamed `stack.sh` to `dbstack`
 
-- New: added `./bin/dbconsole` as quicker notation for `./bin/dbstack dbconsole`
+- Breaking change: removed `cleanup-databases.sh`, `cleanup-docker-images.sh`, and `cleanup-logs.sh` - the functionality
+  of these scripts has been added to `dbstack`
+
+- New: added `./bin/dbconsole` as quicker shortcut for `./bin/dbstack dbconsole`
 
 - New: added dbconsole command: `user:drop`
 
 - New: added dbconsole command: `database:shell`. This starts an interactive sql session to one of the configured
   instances, using the native command-line client. Handy to avoid typing username and password every time
 
-- Improved: results of SELECT commands are now displayed using table formatting for MariaDB and MySQL databases
-  when running dbconsole command `sql:execute`. Also, results for PostgeSQL databases are more terse (no more footer)
+- Improved: for MariaDB and MySQL databases, the results of SELECT commands are now displayed using table formatting
+  when running dbconsole command `sql:execute`. Also, the results for PostgeSQL databases are more terse (no more footer)
 
-- Improved: the `database:drop` command reports failures more consistently when trying to drop non-existing databases
+- Improved: the `database:drop` dbconsole command reports failures more consistently when trying to drop non-existing databases
 
-- Improved: `stack.sh` has learned a new command: `cleanup`. Run `./bin/stack.sh -h` for details
+- Improved: `dbstack` has learned a new command: `cleanup`. Run `./bin/dbstack -h` for details
 
 - Improved: updated the application dependencies to Symfony 4.4.2
 
-- Changed: the `database:create` and `database:drop` commands do _not_ create/drop an user account by default any more.
+- Changed: the `database:create` and `database:drop` dbconsole commands do _not_ create/drop an user account by default any more.
   In order to force them do so, you should use the `--user` option