If an argument is specified in the help text for a command
with the symbol
<colid-list> it means you
must give a string which identifies a list of zero, one or more
of the existing columns in a table.
The string you specify is a separated into separate tokens by
whitespace, which means that you will normally
have to surround it in single or double quotes to ensure
that it is treated as a single argument and not several of them.
Each token in the
<colid-list> string may be one of
*' which matches any sequence of characters. To match an unknown sequence at the start or end of the string an asterisk must be given explicitly. Other than that, matching is usually case insensitive. The order of the expanded list is the same as the order in which the columns appear in the table.
col*" will match columns named
*MAG*" will match columns named
*" on its own
expands to a list of all the columns of the table in order.
<first-colid>-<last-colid>, where the syntax for
<last-colid>is a Single Column Identifier as above (as long as it doesn't contain a "
-" character). The range is inclusive, so the first and last column are both included. The
<last-colid>part (but not both) may be omitted, to indicate all the columns from the start or all the columns to the end, respectively.
RA-PARALLAX" means all the columns starting with
the one named
RA and ending with
the one named
1-100" or "
means the first hundred columns in the table;
101-" or "
means all the columns apart from the first hundred,
PARALLAX and all
subsequent columns, etc.
Specifying a list which contains a given column more than once is not usually an error, but what effect it has depends on the function you are executing.