<doc>
  <legacy_id>1361</legacy_id>
  <name>mark</name>
  <type>command</type>
  <syntax>
    <example>mark {<i>card</i>  |all cards | cards} where {<i>condition</i>}</example>
    <example>mark cards by finding [<i>form</i>] <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>
  </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 the <b>mark</b> <glossary tag="property">property</glossary> of one or more <glossary tag="card">cards</glossary> to true.</summary>
  <examples>
    <example>mark card "Good &amp; Plenty"</example>
    <example>mark cards where field "Intro" is empty</example>
    <example>mark cards where the short name of this card is not "Template"</example>
    <example>mark cards by finding "?" in field "Nationality"</example>
  </examples>
  <description>
    <p>Use the <b>mark</b> <glossary tag="command">command</glossary> to specify certain <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 card is any card reference.</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>, so for example, a <href tag="reference/object_reference.rev">reference</href> to a <keyword tag="field">field</keyword> is <glossary tag="evaluate">evaluated</glossary> for each <keyword tag="card">card</keyword>.</p><p/><p>The <i>form</i> is one of the following words:</p><p>* normal</p><p>* characters or character (or chars or char)</p><p>* words or word</p><p>* string</p><p>* whole</p><p>If no<i> form </i>is specified normal will be used.</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 mark cards either one at a time, by specifying each card to be marked, or in groups, by using the where <i>condition</i> or by finding forms of the <b>mark</b> <glossary tag="command">command</glossary>. Marking additional <glossary tag="card">cards</glossary> does not change the <b>mark</b> <glossary tag="property">property</glossary> of <glossary tag="card">cards</glossary> that have already been marked.</p><p/><p>You use the <b>mark</b> and <command tag="unmark">unmark</command> <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> <glossary tag="select">selects</glossary> 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>  mark cards by finding "Help" in field "History"</p><p>  unmark cards where the hilite of button "Already Helped" is true</p><p/><p>When using the by finding form, the search operates the same way the normal form of the <b>find</b> <glossary tag="command">command</glossary> does. The <b>mark</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 card, but the <keyword tag="words">words</keyword> do not need to be found together.</p>
  </description>
</doc>