From c4bed901fa88246c6b066f6a67db95785f0085e5 Mon Sep 17 00:00:00 2001
From: Marko Kreen <markokr@gmail.com>
Date: Fri, 13 Mar 2009 11:40:31 +0200
Subject: [PATCH] newadm.txt: refresh and mention pending issues

---
 doc/newadm.txt | 36 +++++++++++++++++++++++++++++++++---
 1 file changed, 33 insertions(+), 3 deletions(-)

diff --git a/doc/newadm.txt b/doc/newadm.txt
index 8ee1e263..58942f40 100644
--- a/doc/newadm.txt
+++ b/doc/newadm.txt
@@ -31,6 +31,7 @@ Main feature is psql like tab-completion for everything (queue/consumer names).
 == Command line ==
 
 
+  -Q:: queue name
   -U:: username
   -h:: host
   -p:: port
@@ -58,11 +59,12 @@ Connect to node on default queue:
 Plain queue modification:
 
   CREATE QUEUE <qname> [params?];
-  ALTER QUEUE <qname> SET ..;
-  REGISTER CONSUMER <cons> ON QUEUE <qname> [AT <tick_id>];
-  UNREGISTER CONSUMER <cons> FROM QUEUE <qname>;
+  REGISTER CONSUMER <cons>;
+  UNREGISTER CONSUMER <cons>;
   DROP QUEUE <qname>;
 
+  ALTER QUEUE <qname> SET ..; (only syntax works)
+
 Install code:
 
   INSTALL pgq;      -- txid, pgq, pgq_ext, pgq_node
@@ -90,3 +92,31 @@ Information:
 
 * Default queue vs. queue name in commands.
 
+== ToDo ==
+
+* General:
+  - Lots of useful commands.
+
+* Parsing:
+
+  - Node naming is not consistent, as it has grown, not designed.
+    Suggestions: (Word -> Ident, WList->TokenList?/NodeList?,
+    DynList->DynIdent?, SWord->Param?)
+  - Quoted idents/strings not supported.  Fix: nodes should unquote early.
+    IIRC libpq connect string generation in "connect" code assumes already
+    quoted values, quoting needs to be added there.
+  - Tab-completion of uppercase keywords.
+  - Disable lowercasing of quoted indents. (?)
+  - Tab-completion of quoted idents. (?)
+  - Multi-line commands. (?)
+
+* Cascading: It would be useful to also have cascading commands available in newadm.
+   ( SWITCHOVER / CREATE NODE / PAUSE NODE / CHANGE PROVIDER ).
+   But currently they are implemented using DBScript framework.  And
+   we don't want to have several implementations of the commands.
+   There seems to be 2 ways forward:
+   - Convert newadm to DBScript.  It is possible to make config-less DBScript.
+   - Implement command under newadm in non-DBScript way and make
+     CascadeAdmin call newadm implementation.
+
+
-- 
2.39.5