Changes between Initial Version and Version 1 of 2017-02-13


Ignore:
Timestamp:
Feb 13, 2017, 1:33:56 PM (9 years ago)
Author:
Tom Ferrin
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • 2017-02-13

    v1 v1  
     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