Page History

...

All commands that users are expected to invoke should have manual pages. The manual pages should be up to date and accurate. Manual pages should be installed and shipped in source and binary distributions. The traffic_line subcommands should be coalesced into a single page. It's unlikely that anyone doing "man exit" is looking for the traffic_line subcommand.

Commands should be "self-documenting" as much as possible,\.

Command option consistency

...

I would like to rename some of the commands, eg. traffic_sac. This raises a binary compatibility problem that might not be surmountable. Generating consensus will be a problem

Reducing the number of commands

Are there opportunities to reduce the number of commands a TrafficServer user needs to know? For example, do we really need traffic_line and traffic_shell?

Improve error messages and behaviour

For example:

blacko:~ jpeach$ sudo /opt/ats/bin/traffic_shell 
[connect] ERROR (main_socket_fd 3): No such file or directory
TSInit 5: Failed to initialize MgmtAPI in /opt/ats/var/trafficserver
[connect] ERROR (main_socket_fd 23): No such file or directory
% [connect] ERROR (main_socket_fd 25): No such file or directory
[connect] ERROR (main_socket_fd 25): No such file or directory
[connect] ERROR (main_socket_fd 25): No such file or directory
...

Huh?