Improve ctct(1)

- Try to conform to man-pages(7).
 `- Try to avoid technical information.
 `- Remove the CONFIGURATION section.  It's contents are to reappear in
    ctct_config(5) which ctct(1) already references.
- Add some commented blank lines to improve readability.

Also, in the main script:
- Add EXIT_* variables.  Not yet used.
- Improve the naming in the help output.
- Stop option parsing on '--'.
- In the default case (i.e. no special option), return 1 if only a non
  exact match was found.

1 files changed, 19 insertions, 8 deletions

diff --git a/TODO b/TODO
index 6dea8e3..09b7fab 100644
--- a/TODO
+++ b/TODO
@@ -4,23 +4,34 @@ TODO file for ctct
 * consider using an array for *_program to specify arguments
  `- to circumvent the necessity for eval
 * Honor $VISUAL.
+* Use git tags for future versions.
+* Rename ctct/config.sh to ctct_config.
+* On `ctct -s <pattern>', do not match illegal sequences (e.g. a+b).
+* On `ctct -l', do only list legal names (e.g. not a+b).
+* [consider] On `ctct -d', check format of string.
+* [consider] Remove character restriction except '.', '/'.
+* [consider] Use `grep -F' for --search-by-name.
+* Use the EXIT_* variables.
 
 [CONFIGURE SCRIPT]
 * Take care of some_dir=/ (man page).
 
 [FEATURES]
-* care about pictures/ subdirectory
-* care about directories in general
-* autocompletion for '--search-by-name' (questionable)
-* upon a single result ('--search-by-*), directly display the contents of the
-  entry
+* [consider] Allow for directories with special meaning (e.g. pictures/).
+* [consider] Autocompletion for '--search-by-name' (questionable).
+* [consider] Upon a single result ('--search-by-*), directly display the
+  contents of the entry
  `- should be made customizable
 * [optional] Do not create a new entry if nothing is entered in the editor.
+* Support templates.
+* Different return types for errors and non-matches.
+* Quiet option for --search-by-*.
+
+[MANUAL]
+* Split off ctct_config(5).
+* Add an EXAMPLE section to ctct(1).
 
 [BUGS]
 * strange behaviour:
  `- `ctct -S $'mobile\nabc'
  `- `ctct -S $'mobile\na'
-
-[MISC]
-* Merge the many versions' different CHANGELOGs.