<doc>
  <legacy_id>1953</legacy_id>
  <name>unmark</name>
  <type>command</type>
  <syntax>
    <example>unmark {<i>card</i> | all cards | cards where <i>condition</i>}</example>
    <example>unmark cards by finding <i>findString</i> [in <i>field</i>]</example>
  </syntax>
  <library></library>
  <objects>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Database Operations</category>
  </classification>
  <references>
    <command tag="find">find Command</command>
    <keyword tag="marked">marked Keyword</keyword>
    <property tag="mark">mark Property</property>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
    <ios/>
    <android/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
    <mobile/>
  </classes>
  <security>
  </security>
  <summary>Sets a <glossary tag="card">card's</glossary> <command tag="mark">mark</command> <glossary tag="property">property</glossary> to false.</summary>
  <examples>
    <example>unmark this card</example>
    <example>unmark cards where the label of button "Category Popup" is "None"</example>
    <example>unmark cards by finding it</example>
  </examples>
  <description>
    <p>Use the <b>unmark</b> <glossary tag="command">command</glossary> in conjunction with the <command tag="mark">mark</command> command to narrow down a list of <glossary tag="card">cards</glossary> for printing or for special treatment by the <command tag="go">go</command> and <command tag="sort">sort</command> <glossary tag="command">commands</glossary>.</p><p/><p><b>Parameters:</b></p><p>The <i>card</i> is any <href tag="reference/object_reference.rev">card reference</href>.</p><p/><p>The <i>condition</i> is an <glossary tag="expression">expression</glossary> that <glossary tag="evaluate">evaluates</glossary> to true or false for each <keyword tag="card">card</keyword> in the <glossary tag="current stack">current stack</glossary>. Any <href tag="reference/object_reference.rev">object references</href> within the <i>condition</i> are treated as pertaining to each <keyword tag="card">card</keyword> being <glossary tag="evaluate">evaluated</glossary>. For example, a <href tag="reference/object_reference.rev">reference</href> to a <keyword tag="field">field</keyword> is <glossary tag="evaluate">evaluated</glossary> according to that <glossary tag="field">field's</glossary> contents on each <keyword tag="card">card</keyword>.</p><p/><p>The <i>findString</i> is an <glossary tag="expression">expression</glossary> that <glossary tag="evaluate">evaluates</glossary> to a <keyword tag="string">string</keyword>.</p><p/><p>The <i>field</i> is any <href tag="reference/object_reference.rev">field reference</href>.</p><p/><p><b>Comments:</b></p><p>You can unmark cards either one at a time, by specifying each card to be unmarked, or in batches, by using the<code> where <i>condition</i> </code>or<code> by finding </code>forms of the <b>unmark</b> command. Unmarking additional <glossary tag="card">cards</glossary> does not change the <command tag="mark">mark</command> <glossary tag="property">property</glossary> of <glossary tag="card">cards</glossary> that have already been marked or unmarked.</p><p/><p>You can use the <b>mark</b> and <b>unmark</b> <glossary tag="command">commands</glossary> in succession to further narrow down the set of <glossary tag="card">cards</glossary>. For example, this sequence of <glossary tag="command">commands</glossary> selects only the <glossary tag="card">cards</glossary> where the user has asked for help and the request has not yet been fulfilled:</p><p/><p><code>  mark cards by finding "Help" in field "History"</code></p><p><code>  unmark cards where the hilite of button "Already Helped" is true</code></p><p/><p>When using the<code> by finding </code>form, the search operates the same way the<code> normal </code>form of the <b>find</b> <glossary tag="command">command</glossary> does. The <b>unmark</b> <glossary tag="command">command</glossary> searches for <glossary tag="card">cards</glossary> that contain each <keyword tag="word">word</keyword> in the <i>findString</i>. The <keyword tag="words">words</keyword> in the <i>findString</i> must be found at the beginning of a <keyword tag="word">word</keyword> on the <keyword tag="card">card</keyword>, but the <keyword tag="words">words</keyword> do not need to be found together.</p>
  </description>
</doc>