16,741
edits
Changes
From Gramps
→Action options
=== Action options ===
The action to perform on the imported data can be specified with the <precode>-a action</precode> or <precode>--action=action</precode> option. This is done after all imports are successfully completed.
The following actions remain the same:
*''tool'': This action allows to run a tool from the command line.
Reports and tools generally have many options of their own, so these actions should be followed by the report/tool option string. The string is given using the <precode>-p option_string</precode> or <precode>--options=option_string</precode> option.
The actions available in older versions of Gramps which were relocated in Gramps 3.3 are:
{{man tip| Tip |If an option is not supplied, the last used value will be used. If this report has never been generated before, then the value from last generated report will be used when applicable. Otherwise, the default value will be used.}}
When more than one output action is given, each has to be preceded by <precode>-a</precode> flag. The actions are performed one by one, in the specified order.
{{man tip| lists |Some reports have options or arguments which are interpreted (by the report) to be on multiple lines. For instance some reports allow you to format how the information will be shown, perhaps with a name on one line and the person's birth date on the next line. Such multiple-line options or arguments are called "lists" by Gramps.}}
On the command line such lists must always start with a left square bracket<precode>[</precode>and must always end with a right square bracket<precode>]</precode>but since such square brackets are usually "special" to the "shell" (they mean something to the command interpreter
you are typing the command to), you must "escape" them so that they are ignored by your shell.
The details vary with each shell but (in linux/UNIX) usually you can precede such a square bracket with a backslash<precode>\</precode>or put quotation marks around the square bracket, usually either "single" or "double" ones.
The Hourglass Graph report allows you to put a "note" at the top of the report and such a "note" is an example of a "list" option. Here is an example:
