Dear all,
here's a draft for the bibdocadmin CLI tool for managing docfiles.

syntax:
bibdocadmin <query> <action> [url:<url>] [docname:<docname>] [format:<format>]
   [description:<description>] [comment:<comment>] [restriction:<restriction>]
   [icon:<icon>] [newdocname:<newdocname>]

<query> should be any query that perform_request_search understand.
Depending on the query returning 1 element (e.g. recid:123) or more than one, 
than various action will be possible:

one or more result <action>:
list_docname
list_docfiles (their urls and filesystem path)
list_info (all the possibile informartion about bibdoc and bibdocfiles)
list_statistics (total size of the latest versions and total size in general)
delete
purge
expunge
fix

one and only result <action>:
add (to add a docname)
append (to append a new format or icon)
revise to revise a document (by optionally providing a new url)

To let revise/add/append more than one data at a time we can think of having 
special symbols to divide them: say a '-' and '--' with the semantic:
xxx - yyy: yyy will keep all the previous description/comment of xxx if they 
are not re-specified in yyy. The format if not specified is auto-discovered 
from the filename if possible. The restriction and icons applies at docname 
level.
xxx -- yyy: yyy will be a completly new set of information applied to the same 
pair query,action, regardless of xxx.

e.g.:

bibdocadmin recid:1234567 revise docname:foo icon:http://cds.cern.ch/cds.gif

What do you think?
Best regards,
        Sam

-- 
.O.
..O
OOO

Reply via email to