<page xmlns="http://projectmallard.org/1.0/"
      xmlns:its="http://www.w3.org/2005/11/its"
      type="topic" style="task"
      id="gtg-complete-dismiss-delete-task">

  <info>
    <link type="guide" xref="index#gtg-working-task" group="fifth"/>
    <link type="seealso" xref="gtg-create-new-task"/>
    <link type="seealso" xref="gtg-edit-task"/>
    <link type="seealso" xref="gtg-subtasks"/>
    <link type="seealso" xref="gtg-set-task-date"/>
      
      <revision pkgversion="0.3.1" date="2013-06-18" status="candidate"/>
      <revision pkgversion="0.4.0" date="2020-05-16" status="candidate"/>
      <revision pkgversion="0.5.0" date="2020-11-15" status="candidate"/>
      <revision pkgversion="0.6.0" date="2022-01-31" status="candidate"/>
   <credit type="author copyright">
      <name>Radina Matic</name>
      <email its:translate="no">radina.matic@gmail.com</email>
      <years>2013</years>
    </credit>
    <credit type="editor copyright">
      <name>Danielle Vansia</name>
      <email its:translate="no">daniellevansia@gmail.com</email>
      <years>2020</years>
    </credit>

    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>

  </info>
  <title>Completing, Dismissing, or Deleting Tasks</title>
  <p>There are three actions that you can perform to close tasks or remove them from your <gui>Open</gui> or <gui>Actionable</gui> view modes: complete, dismiss, or delete.</p>
  <note><p>When working from any of the view modes, you can perform the below actions on multiple tasks by selecting the tasks while holding <key>Shift</key>. You can also perform complex, multi-selections using the <key>Ctrl</key> key.</p></note> 
  <section id="complete-task">

  <title>Completing a Task</title>

  <p>When you are finished with a task, you can close the task by performing one of the following actions:</p>
  <list>
  <item><p>In the <gui>Open</gui> or <gui>Actionable</gui> view modes, select the task and use the <keyseq><key>Ctrl</key><key>D</key></keyseq> keyboard shortcut.</p></item>
  <item><p>Right-click the task in the <gui>Task Browser</gui>, and select <gui>Mark as Done</gui> from the context menu.</p></item>
  <item><p>Click the <gui>Mark as Done</gui> button in the <gui>Task Editor</gui> window.</p></item></list> 
  <p>Once a task is marked as done, it is viewable in the <gui>Closed</gui> view mode.</p>
  <section id="reopen-task"><title>Reopening a Complete Task</title>
      <p>You may want to reopen a task that you previously marked as done. From the <gui>Closed</gui> view mode, you can perform one of the following actions:</p>
     <list>
     <item><p>Use the <keyseq><key>Ctrl</key><key>D</key></keyseq> keyboard shortcut.</p></item>
     <item><p>Right-click the task in the <gui>Task Browser</gui>, and select <gui>Reopen</gui> from the context menu.</p></item>
     <item><p>Double click to edit the task, and click the <gui>Mark as Not Done</gui> button in the <gui>Task Editor</gui> window.</p></item></list>
</section>
  </section>
  <section id="dismiss-task">
  <title>Dismissing a Task</title>

  <p>When you decide that a certain task is no longer valid (does not need to be accomplished), you can dismiss it. To dismiss a selected task from the <gui>Open</gui> or <gui>Actionable</gui> view modes, you can perform one of the following actions:</p>
  
  <list>
      <item><p>Select the task, and use the <keyseq><key>Ctrl</key><key>I</key></keyseq> keyboard shortcut.</p></item>
      <item><p>Right-click the task in the <gui>Task Browser</gui>, and select <gui>Dismiss</gui> from the context menu.</p></item>
</list> 
    <p>To dismiss an open <app>GTG</app> task:</p>
<steps>
    <item><p>Click the <media type="image" src="figures/task-toolbar-menu.png"></media> icon in the task's headerbar.</p></item>
    <item><p>Select <gui>Dismiss</gui>.</p></item>
</steps>
    
    <p>You can view all of the tasks that are marked as dismissed in the <gui>Closed</gui> view mode.</p> 

<section id="undismiss-task"><title>Undismissing a Task</title>
      <p>You may want to reopen a task that you previously dismissed. From the <gui>Closed</gui> view mode, you can perform one of the following actions:</p>
     <list>
     <item><p>Use the <keyseq><key>Ctrl</key><key>I</key></keyseq> keyboard shortcut.</p></item>
     <item><p>Right-click the task in the <gui>Task Browser</gui>, and select <gui>Reopen</gui> from the context menu.</p></item>
     <item><p>Double click to open the task, and then click the <media type="image" src="figures/task-toolbar-menu.png"></media> icon in the task's headerbar. Select <gui>Undismiss</gui>.</p></item></list>
</section>
</section>
  <section id="delete">

  <title>Deleting a Task</title>

  <p>To delete a selected task from the main <app>GTG</app> window, you can perform one of the following actions:</p>
  
  <list>
     <item><p>Select the task, and use the <keyseq><key>Ctrl</key><key>Del</key></keyseq> keyboard shortcut.</p></item>
      <item><p>From any of the task view modes, right-click the task in the <gui>Task Browser</gui>, and select <gui>Delete</gui> from the context menu.</p></item>
</list> 
 
   <p>To delete an open <app>GTG</app> task:</p>
<steps><item><p>Click the <media type="image" src="figures/task-toolbar-menu.png"></media> icon in the task's headerbar.</p></item>
<item><p>Select <gui>Delete</gui>.</p></item></steps>

<note style="warning"> <p>Deleting a task is a permanent action. You will be asked to confirm the deletion before proceeding. If you want the ability to undo task deletions, consider using the <gui>Mark as Done</gui> or <gui>Dismiss</gui> actions instead.</p> </note>
</section> 
 
</page>
