1.1. BringOver (aka QBO)
Some actions require confirmation, which is an action that can either be performed by program or by the user. The default action is to automatically refuse confirmation if the action looks like a blunder, and accept it if it does not. Switches can change this behavior: -y will always accept the action; -h will always ask the user via the command tool; and -a will consult the user for apparent blunders and automatically accept non-blunders.
If a directory is given instead of a switch or file name, then that directory is used instead of the current working directory for the rest of the short DF file names (those without explicit directories).
Switches
-a (auto confirm) - confirm all operations, unless they look like blunders, in which case the user is queried via the command tool
-b (origin: derived) - accept only derived files (*.bcd, *.boot, *.press, *.signals)
-c (check remote) - check that remote versions exist
-d (date check) - trying to fetch or attach remote files that have earlier dates than the local files requires confirmation {default}
-e (enter attachments) - check that remote versions exist {default}
-f (action: fetch) - force the actual transfer of the accepted files - implies ~e
-h (confirm by hand) - yes/no choices passed to the user in the command tool streams
-i into following directory
-j (just trust me) - skip torch check
-m (try map) - for short DF names try using the source version maps to fill out the prefix
-o (selected files) - accept only the files following the -o switch up to the last file specified or the -x switch (the last file listed OR the file following the -x switch is the DF file)
-p (access: public) - accept only exported files
-q (quietly) - print only warnings, errors, and summary
-r (reference: imported) - accept only imported files
-s (origin: source) - accept only non-derived files
-t (touchy) - let warnings cause the command to fail; ordinarily only errors do
-u (uh) reset switches to default values
-v (verify) - don't do actions, just see what's needed
-w (reference: defining) - accept only files directly listed in the DF file (not imports)
-x (execute) - start execution with the next file (useful after the -o switch when used on multiple files)
-y (yes always) - confirm all operations, even if they look like blunders
-z (zounds) - bring over DF files being processed {defaults FALSE}
Examples
BringOver -p /Cedar10.0/Top/DF.df
takes the exported files specified by /Cedar10.0/Top/DF.df and creates local attachments for them in the current working directory
BringOver Rope -p IO
takes all files described by Rope.df and the exported files described by IO.df and creates local attachments for them in the current working directory
BringOver -o RopeDoc.tioga Rope
takes the version of RopeDoc.tioga described by Rope.df and creates a local attachment for it in the current working directory
QBO -mp Rope
uses the version maps to find the prefix for Rope.df ([PCedar2.0]<Top>Rope.df) and brings over the public files from that DF file. Note that the highest version number on the remote server is used, not the version named in the version map, so slightly out-of-date version maps will not cause confusion.