| | 1 | = Attendees = |
| | 2 | |
| | 3 | * Conrad, Elaine, Eric, TomG, Greg, TomF |
| | 4 | |
| | 5 | = Agenda = |
| | 6 | |
| | 7 | * Continuing discussion from February 6th meeting: |
| | 8 | * ~~Think about overlap between view, position, and camera commands |
| | 9 | * ~~Ribbon (cartoon) lingering issues/suggestions [http://www.cgl.ucsf.edu/home/meng/chimera2/user/commands/cartoon3.html Elaine's summary] |
| | 10 | * ~~What is the policy regarding "~"? How do we negate a command? Should we do anything further about "~" or just keep them as aliases? |
| | 11 | * ~~Session saving in alpha release: continue to use pickle or move to msgPack? |
| | 12 | * Need to clean up usage hints |
| | 13 | * "objects" vs. "atom-spec". Usage separates the two concepts (e.g. see select), but help documentation merges them. |
| | 14 | * Should "entity atoms", which means the same molecular entity, be part of the atom-spec? |
| | 15 | * Need more discussion/revision for select **only** option |
| | 16 | * Need to think about visualization of nucleotides |
| | 17 | |
| | 18 | = Discussion = |
| | 19 | * Changes to "usage": |
| | 20 | * optional positional arguments will not be listed as keywords |
| | 21 | * argument types with help URL should be shown as links |
| | 22 | * argument types have "displayed" flag that determines whether or not the type and description are listed below syntax |
| | 23 | * if there are 7 or fewer subcommands then each subcommand should be enumerated, otherwise just list the subcommands with a link to each |
| | 24 | * see additional specific changes below |
| | 25 | * "atom-spec" is too specific for some commands, because some objects are not atoms, and "usage" gives different result than "help" |
| | 26 | |
| | 27 | |
| | 28 | = Action Items = |
| | 29 | * Add magic numbers to session files - Greg & Conrad |
| | 30 | * ~~TomG to merge "position" command into "view" command |
| | 31 | * Conrad will continue working on ribbons |
| | 32 | * ~~Conrad will add "cartoon hide" |
| | 33 | * ~~Greg will add "hidden" keyword to command registration |
| | 34 | * All command descriptions need to have a synopsis - TomG |
| | 35 | * When commands are registered generate warning if synopsis not present - Greg |
| | 36 | * "usage allOptions <command>" shows hidden options - Greg |
| | 37 | * For commands where atom-spec" is too specific, use another word - Elaine |
| | 38 | * Changes to usage as per above - Greg |
| | 39 | |