User Tools

Site Tools


command-line

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
command-line [2016/10/11 00:19]
editor
command-line [2017/08/02 03:34] (current)
admin
Line 61: Line 61:
 |[[#​-cm|-cm]]| <​comments>​ |Sets the '​Comments'​ for the currently selected task| |[[#​-cm|-cm]]| <​comments>​ |Sets the '​Comments'​ for the currently selected task|
 |[[#​-cmd|-cmd]]| <id> |Sends the specified command to ToDoList'​s main window| |[[#​-cmd|-cmd]]| <id> |Sends the specified command to ToDoList'​s main window|
 +|[[#​-copy|-copy]]| <​attrib1>​ <​attrib2>​ |Copies the value for '​attrib1'​ to '​attrib2'​ for the currently selected task|
 |[[#​-cs|-cs]]| <​cost>​ |Modifies the '​Cost'​ for the currently selected task| |[[#​-cs|-cs]]| <​cost>​ |Modifies the '​Cost'​ for the currently selected task|
 |[[#​-ct|-ct]]| <​time>​ |Modifies the '​Completion Time' for the currently selected task| |[[#​-ct|-ct]]| <​time>​ |Modifies the '​Completion Time' for the currently selected task|
Line 161: Line 162:
 ''​todolist -tid 6 -cd 2015-07-30T08:​19'' ​   \\ ''​todolist -tid 6 -cd 2015-07-30T08:​19'' ​   \\
  
-As of v7.0.8 a number of days can be added or subtracted to the date field by appending a + or - to the value:+number of days can be added or subtracted to the date field by appending a + or - to the value:
  
 ''​-cd +7'' ​    \\ ''​-cd +7'' ​    \\
Line 195: Line 196:
 At this time text and other selections cannot be forced to a dialog/​window once it opens. So with the Transform example, the window will open but a user must enter specs and click OK to continue. At this time text and other selections cannot be forced to a dialog/​window once it opens. So with the Transform example, the window will open but a user must enter specs and click OK to continue.
  
 +====-copy====
 +===Copies the value for '​attrib1'​ to '​attrib2'​ for the currently selected task===
  
 +This allows attribute values to be copied between different attributes, subject to the following conditions:
 +
 +  * '​attrib1'​ and/or '​attrib2'​ can reference:
 +    * Built-in attributes, using the corresponding command-line identifiers elsewhere on this page
 +    * Custom attributes, using their unique identifier name
 +  * Creation Date and Created By cannot be changed
 +  * The two attributes must have equivalent types ie. Text, Numbers, People
 +  * Some built-in attributes can only be copied to custom attributes and not to other built-in attributes: case Cost, Recurrence, Colour, Percent Completion, Comments, Dependencies,​ File Links.
 +
 +Examples:
 + 
 +|''​-copy md sd''​|Copies a task's creation date to its start date|
 +|''​-copy cd cust_mydate''​|Copies a task's completion date to a custom date attribute|
 +|''​-copy at cust_mylist''​|Copies a task's '​Allocated to' to a multi-list custom text attribute|
 +|''​-copy cs cust_mynumber''​|Copies a task's '​Cost'​ value to a custom number (whole or fractional) attribute|
 +|''​-copy cust_mytext1 cust_mytext2''​|Copies a task's value between two custom text attributes|
 + 
 ====-cs==== ====-cs====
 ===Modifies the '​Cost'​ for the currently selected task=== ===Modifies the '​Cost'​ for the currently selected task===
Line 207: Line 227:
 ''​-cs 0'' ​    \\ ''​-cs 0'' ​    \\
  
-As of v7.0.1 the Cost value can be set to "​0"​ with ""​ or any value resulting in zero including 0 or 0.00. +value can be added or subtracted to the cost field by appending a + or - to the value:
- +
-As of v7.0.8 a value can be added or subtracted to the cost field by appending a + or - to the value:+
  
 ''​-cs +250.25'' ​    \\ ''​-cs +250.25'' ​    \\
Line 218: Line 236:
 ===Modifies the '​Completion Time' for the currently selected task=== ===Modifies the '​Completion Time' for the currently selected task===
  
-New in v7. See the [[#​-cd|-cd]] switch for full information about the Completion Date and Time. This switch allows for setting the time value only.+See the [[#​-cd|-cd]] switch for full information about the Completion Date and Time. This switch allows for setting the time value only.
  
 This switch does not currently support a +/- prefix to add/​subtract to the time. This switch does not currently support a +/- prefix to add/​subtract to the time.
Line 226: Line 244:
 ===Sets the '​Dependency(s)'​ for the currently selected task=== ===Sets the '​Dependency(s)'​ for the currently selected task===
  
-The task ID which follows the -d switch must be complete before the current task can be flagged as completed. Stated another way, the specified task is a requirement/​pre-requisite ​for the current task. More than one such tasks can be specified by enclosing the task IDs in a single space-delimited,​ quoted value: ​   ​+The task ID which follows the -d switch must be complete before the current task can be flagged as completed. Stated another way, the specified task is a requirement/​prerequisite ​for the current task. More than one such tasks can be specified by enclosing the task IDs in a single space-delimited,​ quoted value: ​   ​
 ''​todolist -tid 10 -d "2 6 7"''​ \\ ''​todolist -tid 10 -d "2 6 7"''​ \\
- 
-// Work in Progress. // In v7.0.0-7.0.2 This feature does not appear to be working. 
  
  
Line 243: Line 259:
 ===Modifies the 'Due Time' for the currently selected task=== ===Modifies the 'Due Time' for the currently selected task===
  
-New in v7. See the [[#​-dd|-dd]] switch about the Due Date and Time. This switch allows for setting the time value only.+See the [[#​-dd|-dd]] switch about the Due Date and Time. This switch allows for setting the time value only.
  
 This switch does not currently support a +/- prefix to add/​subtract to the time. This switch does not currently support a +/- prefix to add/​subtract to the time.
Line 340: Line 356:
 Valid values are from 0 to 10 (lowest to highest), or "​n"​ for None. If the value "​n"​ is used, it must be in quotes, otherwise the value is set to zero. Valid values are from 0 to 10 (lowest to highest), or "​n"​ for None. If the value "​n"​ is used, it must be in quotes, otherwise the value is set to zero.
  
-As of v7.0.8 a value can be added or subtracted to the priority field by appending a + or - to the value:+value can be added or subtracted to the priority field by appending a + or - to the value:
  
 ''​-p +1'' ​    \\ ''​-p +1'' ​    \\
Line 375: Line 391:
 Valid values are from 0 to 10 (lowest to highest), or "​n"​ for None. If the value "​n"​ is used, it must be in quotes, otherwise the value is set to zero. Valid values are from 0 to 10 (lowest to highest), or "​n"​ for None. If the value "​n"​ is used, it must be in quotes, otherwise the value is set to zero.
  
-As of v7.0.8 a value can be added or subtracted to the risk field by appending a + or - to the value:+value can be added or subtracted to the risk field by appending a + or - to the value:
  
 ''​-r +1'' ​    \\ ''​-r +1'' ​    \\
Line 403: Line 419:
 Setting the time without the date using -sd currently results in an erroneous date of 12/30/1899. See the [[#​-st|-st]] switch to set the time without the date. Setting the time without the date using -sd currently results in an erroneous date of 12/30/1899. See the [[#​-st|-st]] switch to set the time without the date.
  
-As of v7.0.8 a number of days can be added or subtracted to the date field by appending a + or - to the value:+number of days can be added or subtracted to the date field by appending a + or - to the value:
  
 ''​-sd +7'' ​    \\ ''​-sd +7'' ​    \\
Line 461: Line 477:
 ''​-ts 0'' ​    \\ ''​-ts 0'' ​    \\
  
-As of v7.0.8 time can be added or subtracted to the time spent field by appending a + or - to the value:+Time can be added or subtracted to the time spent field by appending a + or - to the value:
  
 ''​-ts +2.5'' ​    \\ ''​-ts +2.5'' ​    \\
command-line.1476145155.txt.gz · Last modified: 2016/10/11 00:19 by editor