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/08/26 10:17]
admin
command-line [2017/08/02 03:34] (current)
admin
Line 1: Line 1:
 ====== Command Line Options ====== ====== Command Line Options ======
-This page is a // Work in Progress. // (Details have stubs, will be filled in soon) 
  
   * [[#​specifying_the_tasklist_and_task|Specifying the tasklist and task]]   * [[#​specifying_the_tasklist_and_task|Specifying the tasklist and task]]
Line 55: Line 54:
  
 ^Switch^Value^Description^ ^Switch^Value^Description^
-|[[#​ab|-ab]]| <alloc by> |Sets the '​Allocated By' for the currently selected task| +|[[#-ab|-ab]]| <alloc by> |Sets the '​Allocated By' for the currently selected task| 
-|[[#​at|-at]]| <alloc to> |Modifies the '​Allocated To(s)' for the currently selected task| +|[[#-at|-at]]| <alloc to> |Modifies the '​Allocated To(s)' for the currently selected task| 
-|[[#​bid|-bid]]| <id> |Specifies the sibling task after which to create the new task| +|[[#-bid|-bid]]| <id> |Specifies the sibling task after which to create the new task| 
-|[[#_c|-c]]| <​categories>​ |Modifies the '​Category(s)'​ for the currently selected task| +|[[#-c|-c]]| <​categories>​ |Modifies the '​Category(s)'​ for the currently selected task| 
-|[[#_cd|-cd]]| <​date ​[[time|time]]> |Modifies the '​Completion Date' (and optionally the time) for the currently selected task| +|[[#-cd|-cd]]| <date [time]> |Modifies the '​Completion Date' (and optionally the time) for the currently selected task| 
-|[[#_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| 
-|[[#_cs|-cs]]| <​cost>​ |Modifies the '​Cost'​ for the currently selected task| +|[[#-copy|-copy]]| <​attrib1>​ <​attrib2>​ |Copies the value for '​attrib1'​ to '​attrib2'​ for the currently selected task| 
-|[[#_ct|-ct]]| <​time>​ |Modifies the '​Completion Time' for the currently selected task| +|[[#-cs|-cs]]| <​cost>​ |Modifies the '​Cost'​ for the currently selected task| 
-|[[#_d|-d]]| <id> |Sets the '​Dependency(s)'​ for the currently selected task| +|[[#-ct|-ct]]| <​time>​ |Modifies the '​Completion Time' for the currently selected task| 
-|[[#_dd|-dd]]| <​date ​[[time|time]]> |Modifies the 'Due Date' (and optionally the time) for the currently selected task| +|[[#-d|-d]]| <id> |Sets the '​Dependency(s)'​ for the currently selected task| 
-|[[#_dt|-dt]]| <​time>​ |Modifies the 'Due Time' for the currently selected task| +|[[#-dd|-dd]]| <date [time]> |Modifies the 'Due Date' (and optionally the time) for the currently selected task| 
-|[[#_f|-f]]| <filepath2[[| <filepath3> | <filepath4>​ || <​filepath3>​ | <​filepath4> ]]|Allows additional tasklists to be opened| +|[[#-dt|-dt]]| <​time>​ |Modifies the 'Due Time' for the currently selected task| 
-|[[#_fr|-fr]]| <​path>​ |Sets the 'File Link' for the currently selected task| +|[[#-f|-f]]| ​%%<path2> [ | <p3> | <p4> ]%% |Allows additional tasklists to be opened| 
-|[[#_g|-g]]| |Save intermediate file| +|[[#-fr|-fr]]| <​path>​ |Sets the 'File Link' for the currently selected task| 
-|[[#_h|-h]], -help, -?| |Message box with this information| +|[[#-g|-g]]| |Save intermediate file| 
-|[[#_i|-i]]| <​inipath>​ |Specifies an alternative settings file path| +|[[#-h|-h]], -help, -?| |Message box with this information| 
-|[[#_m|-m]]| <​filepath>​ |Imports the specified file| +|[[#-i|-i]]| <​inipath>​ |Specifies an alternative settings file path| 
-|[[#_md|-md]]| <​date ​[[time|time]]> |Sets the '​Creation Date' (and optionally the time) of the newly created task| +|[[#-m|-m]]| <​filepath>​ |Imports the specified file| 
-|[[#_nt|-nt]]| <​title>​ |Creates a new task in the active tasklist with the specified title| +|[[#-md|-md]]| <date [time]> |Sets the '​Creation Date' (and optionally the time) of the newly created task| 
-|[[#_p|-p]]| <​priority>​ |Modifies the '​Priority'​ for the currently selected task| +|[[#-nt|-nt]]| <​title>​ |Creates a new task in the active tasklist with the specified title| 
-|[[#_pc|-pc]]| <​0-100>​ |Modifies the '​%Complete'​ for the currently selected task| +|[[#-p|-p]]| <​priority>​ |Modifies the '​Priority'​ for the currently selected task| 
-|[[#_pid|-pid]]| <id> |Specifies the parent task in which to create the new task| +|[[#-pc|-pc]]| <​0-100>​ |Modifies the '​%Complete'​ for the currently selected task| 
-|[[#_r|-r]]| <​risk>​ |Sets the '​Risk'​ for the currently selected task| +|[[#-pid|-pid]]| <id> |Specifies the parent task in which to create the new task| 
-|[[#_s|-s]]| <​status>​ |Sets the '​Status'​ for the currently selected task| +|[[#-r|-r]]| <​risk>​ |Sets the '​Risk'​ for the currently selected task| 
-|[[#_sd|-sd]]| <​date ​[[time|time]]> |Modifies the 'Start Date'​(and optionally the time) for the currently selected task| +|[[#-s|-s]]| <​status>​ |Sets the '​Status'​ for the currently selected task| 
-|[[#_st|-st]]| <​time>​ |Modifies the 'Start Time' for the currently selected task| +|[[#-sd|-sd]]| <date [time]> |Modifies the 'Start Date'​(and optionally the time) for the currently selected task| 
-|[[#_te|-te]]| <hrs> |Sets the 'Time Estimate'​ for the currently selected task| +|[[#-st|-st]]| <​time>​ |Modifies the 'Start Time' for the currently selected task| 
-|[[#_tg|-tg]]| <​tags>​ |Sets the '​Tag(s)'​ for the currently selected task| +|[[#-te|-te]]| <hrs> |Sets the 'Time Estimate'​ for the currently selected task| 
-|[[#_tid|-tid]]| <id> |Selects the task in the active tasklist| +|[[#-tg|-tg]]| <​tags>​ |Sets the '​Tag(s)'​ for the currently selected task| 
-|[[#_ts|-ts]]| <hrs> |Modifies the 'Time Spent' for the currently selected task| +|[[#-tid|-tid]]| <id> |Selects the task in the active tasklist| 
-|[[#_tv|-tv]]| <​version>​ |Sets the '​Version'​ for the currently selected task| +|[[#-ts|-ts]]| <hrs> |Modifies the 'Time Spent' for the currently selected task| 
-|[[#_v|-v]]||Forces ToDoList to startup visible regardless of its last saved state| +|[[#-tv|-tv]]| <​version>​ |Sets the '​Version'​ for the currently selected task| 
-|[[#_x|-x]]||Turns off password prompting except when first loading an encrypted tasklist| +|[[#-v|-v]]||Forces ToDoList to startup visible regardless of its last saved state| 
-|[[#_xid|-xid]]| <​ext_id>​ |Sets the '​external ID' for the currently selected task| +|[[#-x|-x]]||Turns off password prompting except when first loading an encrypted tasklist| 
-|[[#_z|-z]]| |Move settings into tasklists|+|[[#-xid|-xid]]| <​ext_id>​ |Sets the '​external ID' for the currently selected task| 
 +|[[#-z|-z]]| |Move settings into tasklists|
 | <​filepath>​ ||Opens/​selects the specified tasklist| | <​filepath>​ ||Opens/​selects the specified tasklist|
  
Line 99: Line 99:
  
  
-==== ab = Sets the '​Allocated By' for the currently selected task====+====-ab==== 
 +===Sets the '​Allocated By' for the currently selected task===
  
 The text following the -ab switch simply sets the Allocated By field to the value following the switch. This is the person (company, department, entity) assigning the task. For example, '-ab Sales' or '-ab "Renee Schmidt"'​. There is only one Allocated By entity. The text following the -ab switch simply sets the Allocated By field to the value following the switch. This is the person (company, department, entity) assigning the task. For example, '-ab Sales' or '-ab "Renee Schmidt"'​. There is only one Allocated By entity.
  
  
-==== -at = Modifies the '​Allocated To' for the currently selected task====+====-at==== 
 +===Modifies the '​Allocated To' for the currently selected task===
  
 The text following the -at switch sets the Allocated To field to the value(s) following the switch. This is the person (company, department, entity) to whom the task is being assigned. Multiple Allocated To values can be specified, where more than one entity is responsible for completion of the task. Examples: The text following the -at switch sets the Allocated To field to the value(s) following the switch. This is the person (company, department, entity) to whom the task is being assigned. Multiple Allocated To values can be specified, where more than one entity is responsible for completion of the task. Examples:
  
-''​todolist.exe -at Sales'' ​    +''​todolist.exe -at Sales'' ​    \\ 
-''​todolist -at "Dave Jones"'' ​  ​ +''​todolist -at "Dave Jones"'' ​   \\ 
-''​todolist -at Connie Dave'' ​  ​ +''​todolist -at Connie Dave'' ​   \\ 
-''​todolist "​C:​\path\list.tdl"​ -tid 4 -at "Dave Jones" "​Connie Smith"'' ​  ​+''​todolist "​C:​\path\list.tdl"​ -tid 4 -at "Dave Jones" "​Connie Smith"'' ​   \\
  
 To __set__ all values, removing prior values, just follow the switch with the name(s) as seen above. To __add__ entities, see [[#​adding_values|Adding Values]]. To __set__ all values, removing prior values, just follow the switch with the name(s) as seen above. To __add__ entities, see [[#​adding_values|Adding Values]].
  
 To clear all values, use two consecutive double quotes ( ""​ ):    ​ To clear all values, use two consecutive double quotes ( ""​ ):    ​
-''​-at ""''​+''​-at ""'' ​\\
  
  
-==== bid = Specifies the sibling task after which to create the new task====+====-bid==== 
 +===Specifies the sibling task after which to create the new task===
  
-Used with the [[#_nt|-nt]] switch to create a New Task, the -bid switch causes the new task to be added after and at the same level as the specified task ID. To create a sub-task, use [[#_pid|-pid]].+Used with the [[#-nt|-nt]] switch to create a New Task, the -bid switch causes the new task to be added after and at the same level as the specified task ID. To create a sub-task, use [[#-pid|-pid]].
  
  
-==== c = Modifies the '​Category(s)'​ for the currently selected task====+====-c==== 
 +===Modifies the '​Category(s)'​ for the currently selected task===
  
 The -c switch must be followed by a category name. Multiple categories are separated by spaces (prior to 7.0.1 the delimiter was comma). If a category includes a space, enclose the value(s) in quotes. Examples: The -c switch must be followed by a category name. Multiple categories are separated by spaces (prior to 7.0.1 the delimiter was comma). If a category includes a space, enclose the value(s) in quotes. Examples:
  
-''​todolist.exe -c MyCategory'' ​    +''​todolist.exe -c MyCategory'' ​    \\ 
-''​todolist -c "My Category"'' ​  ​ +''​todolist -c "My Category"'' ​   \\ 
-''​todolist -c First Second'' ​  ​ +''​todolist -c First Second'' ​   \\ 
-''​todolist "​C:​\path\list.tdl"​ -tid 4 -c "Cat 1" "Cat 2"'' ​  ​+''​todolist "​C:​\path\list.tdl"​ -tid 4 -c "Cat 1" "Cat 2"'' ​   \\
  
 To __set__ all values, removing prior values, just follow the switch with the name(s) as seen above. To __add__ entities, see [[#​adding_values|Adding Values]]. To __set__ all values, removing prior values, just follow the switch with the name(s) as seen above. To __add__ entities, see [[#​adding_values|Adding Values]].
  
 To clear all values, use two consecutive double quotes ( ""​ ):    ​ To clear all values, use two consecutive double quotes ( ""​ ):    ​
-''​-c ""''​+''​-c ""'' ​\\
  
  ​Concerns...  ​Concerns...
Line 144: Line 148:
  
  
-==== -cd = Modifies the '​Completion Date' (and optionally the time) for the currently selected task====+====-cd==== 
 +===Modifies the '​Completion Date' (and optionally the time) for the currently selected task===
  
 See [[#​dates_and_times|Dates and Times]] for specifics on formatting of date and time values. When not specified, the default completion time is 11:59PM. See [[#​dates_and_times|Dates and Times]] for specifics on formatting of date and time values. When not specified, the default completion time is 11:59PM.
Line 150: Line 155:
 Here are examples for using the -cd switch: Here are examples for using the -cd switch:
  
-''​todolist -tid 6 -cd 8/​18'' ​    +''​todolist -tid 6 -cd 8/​18'' ​    \\ 
-''​todolist -cd 2015-8-18'' ​    +''​todolist -cd 2015-8-18'' ​    \\ 
-''​todolist -cd "​8/​18/​15 14:​15"'' ​    +''​todolist -cd "​8/​18/​15 14:​15"'' ​    \\ 
-''​todolist -cd "​7-31-15 4:​20pm"'' ​  +''​todolist -cd "​7-31-15 4:​20pm"'' ​  \\ 
-''​todolist -i "​.\myconfig.ini"​ "​mylist.tdl"​ -tid 3 -cd ""'' ​  +''​todolist -i "​.\myconfig.ini"​ "​mylist.tdl"​ -tid 3 -cd ""'' ​  \\ 
-''​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'' ​    \\ 
-''​-cd -1'' ​   +''​-cd -1'' ​    \\
  
-When the completed date is set, the Status is set to Complete and the Completed Date checkbox is set. This page is a // Work in Progress. // (Add image)+When the completed date is set, the Status is set to Complete and the Completed Date checkbox is set. // Work in Progress. // (Add image)
  
 As seen above, as of v7.0.1 the -cd switch can be used to clear the completed date/time with two consecutive double quotes ( ""​ ). This does not apply to other date fields. As seen above, as of v7.0.1 the -cd switch can be used to clear the completed date/time with two consecutive double quotes ( ""​ ). This does not apply to other date fields.
  
-Setting the time without the date using -cd currently results in an erroneous date of 12/30/1899. See the [[#_ct|-ct]] switch to set the time without the date.+Setting the time without the date using -cd currently results in an erroneous date of 12/30/1899. See the [[#-ct|-ct]] switch to set the time without the date.
  
  When setting a completed date for a parent task when child tasks are not complete, ToDoList will open a Yes/No dialog to ask if you want child tasks to also be flagged as complete. This can be an issue with automation. There is currently no way to suppress the dialog but a [[https://​groups.google.com/​d/​msg/​abstractspoon-todolist-support/​tpimckly7c4/​ilxxxehpcqaj|request]] has been submitted.  When setting a completed date for a parent task when child tasks are not complete, ToDoList will open a Yes/No dialog to ask if you want child tasks to also be flagged as complete. This can be an issue with automation. There is currently no way to suppress the dialog but a [[https://​groups.google.com/​d/​msg/​abstractspoon-todolist-support/​tpimckly7c4/​ilxxxehpcqaj|request]] has been submitted.
  
-The specs for this -cd command are exactly the same as for the [[#_dd|-dd]] switch for setting the Due Date. Similarly -ct and -dt function in the same way.+The specs for this -cd command are exactly the same as for the [[#-dd|-dd]] switch for setting the Due Date. Similarly -ct and -dt function in the same way.
  
  
-==== -cm = Adds to Comments for the currently selected task====+====-cm==== 
 +===Adds to Comments for the currently selected task===
  
 The text following the -cm switch is added to the Comment field. This is very useful in automation which logs task activity. Line breaks are specified with **\n**, which is a common way to add a line feed or x0A value. So to add 3 lines to the current Comment field :    ​ The text following the -cm switch is added to the Comment field. This is very useful in automation which logs task activity. Line breaks are specified with **\n**, which is a common way to add a line feed or x0A value. So to add 3 lines to the current Comment field :    ​
-''​-cm "Line 1\nLine 2\nLine 3"''​+''​-cm "Line 1\nLine 2\nLine 3"'' ​\\
  
   * There is currently no mechanism to change the comment format between plain and rich text.   * There is currently no mechanism to change the comment format between plain and rich text.
Line 186: Line 192:
  
 When ToDoList is opened it can be set to go directly to any command offered in the menu system. Every menu option has an ID which is used with this command. To find the ID for a specific menu item, go to menu > Tools > Preferences > Keyboard Shortcuts. At the bottom of the form, check "Show menu item IDs". The ID number displays next to every menu option. So to open ToDoList and force it to go to Transform Tasklist (under Tools), use :    ​ When ToDoList is opened it can be set to go directly to any command offered in the menu system. Every menu option has an ID which is used with this command. To find the ID for a specific menu item, go to menu > Tools > Preferences > Keyboard Shortcuts. At the bottom of the form, check "Show menu item IDs". The ID number displays next to every menu option. So to open ToDoList and force it to go to Transform Tasklist (under Tools), use :    ​
-''​-cmd 33024''​+''​-cmd 33024'' ​\\
  
 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===
  
-==== -cs = Modifies ​the '​Cost'​ for the currently selected task====+This allows attribute values to be copied between different attributes, subject to the following conditions:
  
-The task gets set with any valid integer or floating-point number (doesn't need to be dollars ​and cents or have two decimal places)Examples:+  * '​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 ieText, 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.
  
-''​-cs 1050'' ​    +Examples: 
-''​-cs 899.98'' ​    +  
-''​-cs 123.4567'' ​    +|''​-copy md sd''​|Copies a task's creation date to its start date| 
-''​-cs ​""​'' ​  ​ +|''​-copy cd cust_mydate''​|Copies a task's completion date to a custom date attribute| 
-''​-cs ​0'' ​   +|''​-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==== 
 +===Modifies the 'Cost' ​for the currently selected task=== 
 + 
 +The task gets set with any valid integer or floating-point number (doesn'​t need to be dollars and cents or have two decimal places). Examples:
  
-As of v7.0.1 the Cost value can be set to "0" ​with ""​ or any value resulting in zero including ​or 0.00.+''​-cs 1050'' ​    \\ 
 +''​-cs 899.98'' ​    \\ 
 +''​-cs 123.4567'' ​    \\ 
 +''​-cs ​""​'' ​   \\ 
 +''​-cs ​0'' ​    \\
  
-As of v7.0.8 a value can be added or subtracted to the cost field by appending a + or - to the value:+value can be added or subtracted to the cost field by appending a + or - to the value:
  
-''​-cs +250.25'' ​    +''​-cs +250.25'' ​    \\ 
-''​-cs -1'' ​   +''​-cs -1'' ​    \\
  
  
-==== -ct = Modifies the '​Completion Time' for the currently selected task====+====-ct==== 
 +===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.
  
  
-==== -d = Sets the '​Dependency(s)'​ for the currently selected task====+====-d==== 
 +===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"'' ​\\
  
-This page is a // Work in Progress. // In v7.0.0-7.0.2 This feature does not appear to be working. 
  
 +====-dd====
 +===Sets the 'Due Date' (and optionally the time) for the currently selected task===
  
-==== -dd = Sets the 'Due Date' (and optionally the time) for the currently selected task==== +The -dd switch sets the Due Date and Time. [[#-dt|-dt]] sets time-only. All of the details are exactly the same as for the [[#-cd|-cd]] switch that sets the completed date/time, except that the Status is not changed and the Completed flag is not set.
- +
-The -dd switch sets the Due Date and Time. [[#_dt|-dt]] sets time-only. All of the details are exactly the same as for the [[#_cd|-cd]] switch that sets the completed date/time, except that the Status is not changed and the Completed flag is not set.+
  
 See [[#​dates_and_times|Dates and Times]] for specifics on formatting of date and time values. When not specified, the default due time is 11:59PM. See [[#​dates_and_times|Dates and Times]] for specifics on formatting of date and time values. When not specified, the default due time is 11:59PM.
  
  
-==== -dt = Modifies the 'Due Time' for the currently selected task====+====-dt==== 
 +===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.
  
  
-==== -f = Allows additional tasklists to be opened====+====-f==== 
 +===Allows additional tasklists to be opened===
  
 If todolist.exe is run without the -i option, the default .ini file is used, and the list of most recently used tasklists from the .ini are used to open tasklists. If todolist.exe is run without the -i option, the default .ini file is used, and the list of most recently used tasklists from the .ini are used to open tasklists.
Line 249: Line 276:
  
 For example: ​   ​ For example: ​   ​
-''​todolist "​c:​\path\list1.tdl"​ -f "​c:​\path\list2.tdl"'' ​    +''​todolist "​c:​\path\list1.tdl"​ -f "​c:​\path\list2.tdl"'' ​    \\ 
-''​todolist -f "​c:​\path\list1.tdl"​ -f "​c:​\path\list2.tdl"​ -f "​c:​\path\list3.tdl"'' ​    +''​todolist -f "​c:​\path\list1.tdl"​ -f "​c:​\path\list2.tdl"​ -f "​c:​\path\list3.tdl"'' ​    \\ 
-''​todolist -i "​c:​\special.ini"​ -f "​c:​\path\list1.tdl"​ -f "​c:​\path\list2.tdl"''​+''​todolist -i "​c:​\special.ini"​ -f "​c:​\path\list1.tdl"​ -f "​c:​\path\list2.tdl"'' ​\\
  
 The INI governs the behaviour of all tasklists that are opened in this manner. Be careful about using more than one INI against a given tasklist, as the data could be confusing and might be modified in a manner that is inconsistent for someone using a different INI. The INI governs the behaviour of all tasklists that are opened in this manner. Be careful about using more than one INI against a given tasklist, as the data could be confusing and might be modified in a manner that is inconsistent for someone using a different INI.
  
  
-==== -fr = Sets the 'File Link' for the currently selected task====+====-fr==== 
 +===Sets the 'File Link' for the currently selected task===
  
 Each task can have one or more file links associated, for documents, web pages, etc. The -fr switch is followed by a filename to add the specified file to the File Link list. The path is converted from an absolute path to a path relative to the Resources folder of the ToDoList.exe install folder. ​ Verify. (Through v7.0.0, only one file link could be added per command-line. This was fixed in 7.0.1.) Each task can have one or more file links associated, for documents, web pages, etc. The -fr switch is followed by a filename to add the specified file to the File Link list. The path is converted from an absolute path to a path relative to the Resources folder of the ToDoList.exe install folder. ​ Verify. (Through v7.0.0, only one file link could be added per command-line. This was fixed in 7.0.1.)
  
 To set all file links, removing prior links, just follow the -fr flag with the file names: ​   ​ To set all file links, removing prior links, just follow the -fr flag with the file names: ​   ​
-''​-fr "​c:​\path\file1.ext"​ file2.ext ..\file3.ext''​+''​-fr "​c:​\path\file1.ext"​ file2.ext ..\file3.ext'' ​\\
  
 To add file links to the existing list, prefix only the first link with a plus sign "​+": ​   ​ To add file links to the existing list, prefix only the first link with a plus sign "​+": ​   ​
-''​-fr +additional_file.ext "​d:​\temp\some other additional file.ext"''​+''​-fr +additional_file.ext "​d:​\temp\some other additional file.ext"'' ​\\
  
 To clear all file links, use two consecutive double quotes ( ""​ ):    ​ To clear all file links, use two consecutive double quotes ( ""​ ):    ​
-''​-fr ""''​+''​-fr ""'' ​\\
  
  Do not add a plus to all files, only the first one. The first file triggers the addition of file names - adding a plus to subsequent file names results in "​undefined"​ behaviour.  Do not add a plus to all files, only the first one. The first file triggers the addition of file names - adding a plus to subsequent file names results in "​undefined"​ behaviour.
  
  
-==== -g = Save intermediate file====+====-g==== 
 +===Save intermediate file===
  
 When using the Transform functionality,​ a new XML tasklist file is created which is a subset of the currently selected list. This subset is filtered and sorted as required. The .xslt transform is then run against this intermediate file, and then the file is deleted. It's often helpful to see this temporary file to diagnose issues in a transformation. The -g switch will cause any transform-generated temporary tasklists to be saved to your Temp folder so that you can inspect them. When using the Transform functionality,​ a new XML tasklist file is created which is a subset of the currently selected list. This subset is filtered and sorted as required. The .xslt transform is then run against this intermediate file, and then the file is deleted. It's often helpful to see this temporary file to diagnose issues in a transformation. The -g switch will cause any transform-generated temporary tasklists to be saved to your Temp folder so that you can inspect them.
Line 281: Line 310:
  
  
-==== -h (also -help and -?) = Message box with this information====+====-h (also -help and -?)==== 
 +===Message box with this information===
  
 With any of the three switches, -h, -help, or -?, a window opens to display a summary of the available switches. This should not be used by "​headless"​ automation. With any of the three switches, -h, -help, or -?, a window opens to display a summary of the available switches. This should not be used by "​headless"​ automation.
  
  
-==== -i = Alternative INI File====+====-i==== 
 +===Alternative INI File===
  
-Multiple instances of ToDoList can be executed simultaneously,​ with each each using a different .ini [[[configuration|[Configuration]]] file. If not specified in the command-line,​ the default configuration file is ToDoList.ini,​ in the root folder along with the .exe and .dll files. ​    +Multiple instances of ToDoList can be executed simultaneously,​ with each using a different .ini [[configuration|Configuration]] file. If not specified in the command-line,​ the default configuration file is ToDoList.ini,​ in the root folder along with the .exe and .dll files. ​    
-''​C:​\SpecialApps\ToDoList\ToDoList.exe -i "​C:​\Users\me\Documents\Tasks\ToDoListLive.ini"''​+''​C:​\SpecialApps\ToDoList\ToDoList.exe -i "​C:​\Users\me\Documents\Tasks\ToDoListLive.ini"'' ​\\
  
 The ini full path follows the -i option. The file name does not need to be the default ToDoList.ini. The ini full path follows the -i option. The file name does not need to be the default ToDoList.ini.
  
  
-==== -m = Imports the specified file====+====-m==== 
 +===Imports the specified file===
  
 Imports the specified file Imports the specified file
  
  
-==== -md = Sets the '​Creation Date' (and optionally the time) of the newly created task====+====-md==== 
 +===Sets the '​Creation Date' (and optionally the time) of the newly created task===
  
 The creation date can only be specified on a new task created with the -nt switch. The creation date cannot be set on an existing task. Example: ​   ​ The creation date can only be specified on a new task created with the -nt switch. The creation date cannot be set on an existing task. Example: ​   ​
-''​todolist.exe -i "​my_default_config.ini"​ -nt "Tasks for Monday"​ -md 9/​6''​+''​todolist.exe -i "​my_default_config.ini"​ -nt "Tasks for Monday"​ -md 9/​6'' ​\\
  
 See [[#​dates_and_times|Dates and Times]] for specifics on formatting of date and time values. See [[#​dates_and_times|Dates and Times]] for specifics on formatting of date and time values.
  
  
-==== -nt = Creates a new task in the active tasklist with the specified title====+====-nt==== 
 +===Creates a new task in the active tasklist with the specified title===
  
-Creates a new task in the active tasklist with the specified title. Use the [[#_bid|-bid]] switch along with -nt to add the task as a sibling of another. Use with the [[#_pid|-pid]] switch to create a sub-task. Defaults not set from the command-line will be set according to the currently active .ini preferences and tasklist-specific defaults.+Creates a new task in the active tasklist with the specified title. Use the [[#-bid|-bid]] switch along with -nt to add the task as a sibling of another. Use with the [[#-pid|-pid]] switch to create a sub-task. Defaults not set from the command-line will be set according to the currently active .ini preferences and tasklist-specific defaults.
  
 Example: ​   ​ Example: ​   ​
-''​todolist.exe -i "​my_default_config.ini"​ -nt "New Task Title"''​+''​todolist.exe -i "​my_default_config.ini"​ -nt "New Task Title"'' ​\\
  
-See the [[#_pid|-pid]] switch to specify the parent task ID for new tasks, or [[#_bid|-bid]] to specify a sibling task ID. When no other task is specified, a new task is added to the top of the tasklist tree.+See the [[#-pid|-pid]] switch to specify the parent task ID for new tasks, or [[#-bid|-bid]] to specify a sibling task ID. When no other task is specified, a new task is added to the top of the tasklist tree.
  
  
-==== -p = Sets the '​Priority'​ for the currently selected task====+====-p==== 
 +===Sets the '​Priority'​ for the currently selected task===
  
 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'' ​    \\ 
-''​-p -1'' ​   +''​-p -1'' ​    \\
  
   * The "​n"​ value may not work correctly in 7.0.8.   * The "​n"​ value may not work correctly in 7.0.8.
Line 332: Line 367:
  
  
-==== -pc = Modifies the '​%Complete'​ for the currently selected task====+====-pc==== 
 +===Modifies the '​%Complete'​ for the currently selected task===
  
 Valid values are from 0 to 100. Do not use the percent sign in the value. Valid values are from 0 to 100. Do not use the percent sign in the value.
Line 338: Line 374:
 A value can be added or subtracted to the priority field by appending a + or - to the value: A value can be added or subtracted to the priority field by appending a + or - to the value:
  
-''​-pc +1'' ​    +''​-pc +1'' ​    \\ 
-''​-pc -1'' ​   +''​-pc -1'' ​    \\
  
   * An attempt to set the value lower than 0 or higher than 100 results in the request being discarded. The min/max value is not set automatically.   * An attempt to set the value lower than 0 or higher than 100 results in the request being discarded. The min/max value is not set automatically.
  
  
-==== -pid = Specifies the parent task in which to create the new task====+====-pid==== 
 +===Specifies the parent task in which to create the new task===
  
-Used with the [[#_nt|-nt]] switch to create a New Task, the -pid switch causes the new task to be added after and as a sub-task of the specified task ID. To create a sibling task, at the same level as another, use [[#_bid|-bid]]. When no other task is specified, a new task is added to the top of the tasklist tree.+Used with the [[#-nt|-nt]] switch to create a New Task, the -pid switch causes the new task to be added after and as a sub-task of the specified task ID. To create a sibling task, at the same level as another, use [[#-bid|-bid]]. When no other task is specified, a new task is added to the top of the tasklist tree.
  
  
-==== -r = Sets the '​Risk'​ for the currently selected task====+====-r==== 
 +===Sets the '​Risk'​ for the currently selected task===
  
 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'' ​    \\ 
-''​-r -1'' ​   +''​-r -1'' ​    \\
  
   * The "​n"​ value may not work correctly in 7.0.8.   * The "​n"​ value may not work correctly in 7.0.8.
Line 362: Line 400:
  
  
-==== -s = Sets the '​Status'​ for the currently selected task====+====-s==== 
 +===Sets the '​Status'​ for the currently selected task===
  
 The specified value is assigned to the Status field. The specified value is assigned to the Status field.
Line 371: Line 410:
  
  
-==== -sd = Sets the 'Start Date' (and optionally the time) for the currently selected task====+====-sd==== 
 +===Sets the 'Start Date' (and optionally the time) for the currently selected task===
  
 This is the date/time when the task is expected to start, or when it actually did start. This is the date/time when the task is expected to start, or when it actually did start.
Line 377: Line 417:
 See [[#​dates_and_times|Dates and Times]] for specifics on formatting of date and time values. When not specified, the default start time is 12:00AM. See [[#​dates_and_times|Dates and Times]] for specifics on formatting of date and time values. When not specified, the default start time is 12:00AM.
  
-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'' ​    \\ 
-''​-sd -1'' ​   +''​-sd -1'' ​    \\
  
  
-==== -st = Modifies the 'Start Time' for the currently selected task====+====-st==== 
 +===Modifies the 'Start Time' for the currently selected task===
  
-New in v7. See the [[#_sd|-sd]] switch for full information about the Start Date and Time. This switch allows for setting the time value only.+New in v7. See the [[#-sd|-sd]] switch for full information about the Start 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.
  
  
-==== -te = Sets the 'Time Estimate'​ for the currently selected task====+====-te==== 
 +===Sets the 'Time Estimate'​ for the currently selected task===
  
-The estimated time to complete the task gets set with any valid integer or floating-point number. See [[#_ts|-ts]] to set the actual time spent. Examples:+The estimated time to complete the task gets set with any valid integer or floating-point number. See [[#-ts|-ts]] to set the actual time spent. Examples:
  
-''​-te 12'' ​    +''​-te 12'' ​    \\ 
-''​-te 3.5'' ​  +''​-te 3.5'' ​  \\ 
-''​-te ""'' ​  ​ +''​-te ""'' ​   \\ 
-''​-te 0'' ​   +''​-te 0'' ​    \\
  
  As of 7.0.2, using this switch resets the Time Estimate Units to Hours. Do not use this switch yet to set days, months, or years.  As of 7.0.2, using this switch resets the Time Estimate Units to Hours. Do not use this switch yet to set days, months, or years.
  
  
-==== -tg = Sets the '​Tag(s)'​ for the currently selected task====+====-tg==== 
 +===Sets the '​Tag(s)'​ for the currently selected task===
  
 This switch follows the same rules as the -c switch to set [[#​categories|Categories]] This switch follows the same rules as the -c switch to set [[#​categories|Categories]]
  
  
-==== -tid = Specify a Task ID====+====-tid==== 
 +===Specify a Task ID===
  
 This executes ToDoList and forces focus to move to the specified task. A task ID without a tasklist specification isn't useful. To open a specific tasklist add the path to the file to the end of the command-line. For example: ​   ​ This executes ToDoList and forces focus to move to the specified task. A task ID without a tasklist specification isn't useful. To open a specific tasklist add the path to the file to the end of the command-line. For example: ​   ​
-''​C:​\SpecialApps\ToDoList\ToDoList.exe -tid 291 "​C:​\Users\me\Documents\Tasks\HomeStuff.tdl"''​+''​C:​\SpecialApps\ToDoList\ToDoList.exe -tid 291 "​C:​\Users\me\Documents\Tasks\HomeStuff.tdl"'' ​\\
  
 To get a [[user-defined-tools|UDT]] to perform an operation on a specific task ID, set the argument as follows: ​   ​ To get a [[user-defined-tools|UDT]] to perform an operation on a specific task ID, set the argument as follows: ​   ​
-''​-tid $(selTID)''​+''​-tid $(selTID)'' ​\\
  
 And to prompt for a task ID in a UDT:    ​ And to prompt for a task ID in a UDT:    ​
-''​-tid $(userText, var, "Task ID"​)''​+''​-tid $(userText, var, "Task ID"​)'' ​\\
  
-Note that issues have been reported if -tid is used to specify a task that does not exist. Do not use -tid with [[#_nt|-nt]] to create a new task - the ID for a new task cannot be specified.+Note that issues have been reported if -tid is used to specify a task that does not exist. Do not use -tid with [[#-nt|-nt]] to create a new task - the ID for a new task cannot be specified.
  
  
-==== -ts = Modifies the 'Time Spent' for the currently selected task====+====-ts==== 
 +===Modifies the 'Time Spent' for the currently selected task===
  
-The actual time spent on the task gets set with any valid integer or floating-point number. See [[#_te|-te]] to set the estimated time versus the actual time. Examples:+The actual time spent on the task gets set with any valid integer or floating-point number. See [[#-te|-te]] to set the estimated time versus the actual time. Examples:
  
-''​-ts 12'' ​    +''​-ts 12'' ​    \\ 
-''​-ts 3.5'' ​    +''​-ts 3.5'' ​    \\ 
-''​-ts ""'' ​    +''​-ts ""'' ​    \\ 
-''​-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'' ​    \\ 
-''​-ts -1'' ​   +''​-ts -1'' ​    \\
  
  ​Cautions: ​    ​Cautions: ​  
Line 443: Line 488:
  
  
-==== -tv = Sets the '​Version'​ for the currently selected task====+====-tv==== 
 +===Sets the '​Version'​ for the currently selected task===
  
 This is freeform text which is intended to identify a version/​release ID where an issue was reported, fixed, or where a fix will be deployed. Usage is entirely defined by the user. The value is added to a tasklist-specific list which is available to all other tasks after first usage. Clear the field using ( ""​ ) as the value. This is freeform text which is intended to identify a version/​release ID where an issue was reported, fixed, or where a fix will be deployed. Usage is entirely defined by the user. The value is added to a tasklist-specific list which is available to all other tasks after first usage. Clear the field using ( ""​ ) as the value.
  
  
-==== -v = Forces ToDoList to startup visible regardless of its last saved state====+====-v==== 
 +===Forces ToDoList to startup visible regardless of its last saved state===
  
 Forces ToDoList to startup visible regardless of its last saved state Forces ToDoList to startup visible regardless of its last saved state
  
  
-==== -x = Turns off password prompting except when first loading an encrypted tasklist====+====-x==== 
 +===Turns off password prompting except when first loading an encrypted tasklist===
  
 Turns off password prompting except when first loading an encrypted tasklist Turns off password prompting except when first loading an encrypted tasklist
  
  
-==== -xid = Sets the '​External ID' for the currently selected task====+====-xid==== 
 +===Sets the '​External ID' for the currently selected task===
  
 This is freeform text which is intended to identify an ID in an external tracking system, like Bugzilla or GitHub Issues. Usage is entirely defined by the user. The value is added to a tasklist-specific list which is available to all other tasks after first usage. Clear the field using ( ""​ ) as the value. This is freeform text which is intended to identify an ID in an external tracking system, like Bugzilla or GitHub Issues. Usage is entirely defined by the user. The value is added to a tasklist-specific list which is available to all other tasks after first usage. Clear the field using ( ""​ ) as the value.
  
  
-==== -z = Move settings into tasklists====+====-z==== 
 +===Move settings into tasklists===
  
 Historically,​ all settings related to a TaskList have been stored in ToDoList.ini for all TaskLists. This isn't a problem until the TaskList is shared on many computers. An example of a problem that arises is that you have to manually say which column is visible on each PC. Columns visibility is just one setting. Also, if you move your TaskList to another computer, your settings don't follow automatically. This can especially be a pain when the new computer already has ToDoList, and you have to manually copy some parts of one ToDoList.ini to another. (This [[http://​www.codeproject.com/​messages/​5069677/​re-current-feature-list-for.aspx|information]] comes from [[https://​github.com/​patricetorchet|@PatriceTorchet]].) Historically,​ all settings related to a TaskList have been stored in ToDoList.ini for all TaskLists. This isn't a problem until the TaskList is shared on many computers. An example of a problem that arises is that you have to manually say which column is visible on each PC. Columns visibility is just one setting. Also, if you move your TaskList to another computer, your settings don't follow automatically. This can especially be a pain when the new computer already has ToDoList, and you have to manually copy some parts of one ToDoList.ini to another. (This [[http://​www.codeproject.com/​messages/​5069677/​re-current-feature-list-for.aspx|information]] comes from [[https://​github.com/​patricetorchet|@PatriceTorchet]].)
Line 482: Line 532:
  
 Examples: ​   ​ Examples: ​   ​
-''​8/​1 13:​30'' ​    +''​8/​1 13:​30'' ​    \\ 
-''​1-aug 7:​15'' ​    +''​1-aug 7:​15'' ​    \\ 
-''​jan-1 12pm'' ​    +''​jan-1 12pm'' ​    \\ 
-''​2015-07-30T08:​19 '' ​   +''​2015-07-30T08:​19 '' ​    \\
  
  
 ===== Adding Values===== ===== Adding Values=====
 To add values to an existing list, prefix only the first value with a plus sign "​+"​. This applies to Allocated To, Categories, Tags, and perhaps other alpha fields: ​   ​ To add values to an existing list, prefix only the first value with a plus sign "​+"​. This applies to Allocated To, Categories, Tags, and perhaps other alpha fields: ​   ​
-''​-at +Sales'' ​    +''​-at +Sales'' ​    \\ 
-''​-c +additional_category "some other additional name"'' ​    +''​-c +additional_category "some other additional name"'' ​    \\ 
-''​-tg +london sydney'' ​   +''​-tg +london sydney'' ​    \\
 The "​+"​ sign is only required on the first value. Other values do not need a +sign but will be added to the list of values. The "​+"​ sign is only required on the first value. Other values do not need a +sign but will be added to the list of values.
  
 When a name is quoted, the plus can be inside or outside of the quotes: ​   ​ When a name is quoted, the plus can be inside or outside of the quotes: ​   ​
-''​-c +"add this" and_this'' ​    +''​-c +"add this" and_this'' ​    \\ 
-''​-c "+add this" and_this'' ​  ​+''​-c "+add this" and_this'' ​   \\
  
   * Currently, the entry field does not immediately reflect a +change but the value is changed.   * Currently, the entry field does not immediately reflect a +change but the value is changed.
command-line.1472206645.txt.gz · Last modified: 2016/08/26 10:17 by admin