https://sbnwiki.astro.umd.edu/wiki/index.php?title=Validate_Tool_Configuration_File&feed=atom&action=historyValidate Tool Configuration File - Revision history2024-03-29T10:30:30ZRevision history for this page on the wikiMediaWiki 1.34.1https://sbnwiki.astro.umd.edu/wiki/index.php?title=Validate_Tool_Configuration_File&diff=2406&oldid=prevRaugh at 16:10, 14 August 20172017-08-14T16:10:17Z<p></p>
<table class="diff diff-contentalign-left" data-mw="interface">
<col class="diff-marker" />
<col class="diff-content" />
<col class="diff-marker" />
<col class="diff-content" />
<tr class="diff-title" lang="en">
<td colspan="2" style="background-color: #fff; color: #222; text-align: center;">← Older revision</td>
<td colspan="2" style="background-color: #fff; color: #222; text-align: center;">Revision as of 16:10, 14 August 2017</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l1" >Line 1:</td>
<td colspan="2" class="diff-lineno">Line 1:</td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>The ''Validate Tool'' has a large number of command options, many of which can take multiple arguments. The configuration file option allows you to code a set of complex and their arguments into a single file for re-use or just convenient editing.</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>The ''Validate Tool'' has a large number of command options, many of which can take multiple arguments. The configuration file option allows you to code a set of complex and their arguments into a single file for re-use or just convenient editing.</div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;"></ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">''Last update: 14 August - ''Validate'' version 1.11.1''</ins></div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>== File Syntax ==</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>== File Syntax ==</div></td></tr>
</table>Raughhttps://sbnwiki.astro.umd.edu/wiki/index.php?title=Validate_Tool_Configuration_File&diff=2227&oldid=prevRaugh: Safety Save2017-05-29T22:17:27Z<p>Safety Save</p>
<table class="diff diff-contentalign-left" data-mw="interface">
<col class="diff-marker" />
<col class="diff-content" />
<col class="diff-marker" />
<col class="diff-content" />
<tr class="diff-title" lang="en">
<td colspan="2" style="background-color: #fff; color: #222; text-align: center;">← Older revision</td>
<td colspan="2" style="background-color: #fff; color: #222; text-align: center;">Revision as of 22:17, 29 May 2017</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l13" >Line 13:</td>
<td colspan="2" class="diff-lineno">Line 13:</td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>All option keywords begin with "''validate.''", and must be followed by an equal sign ('=') and the value. Space around '=' is not significant. Keywords are listed in alphabetical here. For details on the referenced command line options, see the "[[Using Validate Tool]]" page on this wiki, where the option are listed by functional group.</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>All option keywords begin with "''validate.''", and must be followed by an equal sign ('=') and the value. Space around '=' is not significant. Keywords are listed in alphabetical here. For details on the referenced command line options, see the "[[Using Validate Tool]]" page on this wiki, where the option are listed by functional group.</div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;"></ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">=== ''validate.basePath'' ===</ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;"></ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">This option keyword is equivalent to the '''-base-path''' command line option. </ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;"></ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">{| class="wikitable" style="background-color: yellow"</ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">| '''Note:''' ''Contrary to what is stated in the ''Validate Tool - Operation'' document, the explicit use of the '''-checksum-manifest''' command option will only supersede what is in the configuration file if the '''-checksum-manifest''' option comes ''after'' the '''-config''' option on the command line.</ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">|}</ins></div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>=== ''validate.catalog'' ===</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>=== ''validate.catalog'' ===</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'>−</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>This option keyword is equivalent to the '''-catalog''' command line option, and thus largely useless.</div></td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>This option keyword is equivalent to the '''-catalog''' command line option, and thus largely useless. <ins class="diffchange diffchange-inline"> In general, using the ''validate.schema'' and ''validate.schematron'' or equivalent command line options will be simpler. The exception might be in the case where a catalog file is used to resolve a reference to a core ("pds") schema file that cannot be referenced in any other way because of various constraints or issues with other options. This has not been tested.</ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div> </div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins class="diffchange diffchange-inline">=== ''validate.checksum'' ===</ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div> </div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins class="diffchange diffchange-inline">This keyword is used to specify an MD5 checksum manifest file for integrity checking.</ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div> </div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins class="diffchange diffchange-inline">{| class="wikitable" style="background-color: yellow"</ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins class="diffchange diffchange-inline">| '''Note:''' ''Contrary to what is stated in the ''Validate Tool - Operation'' document, the explicit use of the '''-checksum-manifest''' command option will only supersede what is in the configuration file if the '''-checksum-manifest''' option comes ''after'' the '''-config''' option on the command line.</ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins class="diffchange diffchange-inline">|}</ins></div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>=== ''validate.force'' ===</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>=== ''validate.force'' ===</div></td></tr>
<tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l64" >Line 64:</td>
<td colspan="2" class="diff-lineno">Line 80:</td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>{| class="wikitable" style="background-color: yellow"</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>{| class="wikitable" style="background-color: yellow"</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>| '''Note:''' ''Contrary to what is stated in the ''Validate Tool - Operation'' document, the explicit use of the '''-report-style''' command option will only supersede what is in the configuration file if the '''-report-style''' option comes ''after'' the '''-config''' option on the command line.</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>| '''Note:''' ''Contrary to what is stated in the ''Validate Tool - Operation'' document, the explicit use of the '''-report-style''' command option will only supersede what is in the configuration file if the '''-report-style''' option comes ''after'' the '''-config''' option on the command line.</div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">|}</ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;"></ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">=== ''validate.rule'' ===</ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;"></ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">This keyword option takes the same values as the ''-rule'' command line option: '''pds4.label''', '''pds4.folder''', '''pds4.collection''', '''pds4.bundle''', and '''pds3.volume'''.</ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;"></ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">{| class="wikitable" style="background-color: yellow"</ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">| '''Note:''' ''Contrary to what is stated in the ''Validate Tool - Operation'' document, the explicit use of the '''-rule''' command option will only supersede what is in the configuration file if the '''-rule''' option comes ''after'' the '''-config''' option on the command line. </ins></div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>|}</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>|}</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l93" >Line 93:</td>
<td colspan="2" class="diff-lineno">Line 117:</td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>| '''Note:''' ''Contrary to what is stated in the ''Validate Tool - Operation'' document, the explicit use of the '''-verbose''' command option will only supersede what is in the configuration file if the '''-verbose''' option comes ''after'' the '''-config''' option on the command line.</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>| '''Note:''' ''Contrary to what is stated in the ''Validate Tool - Operation'' document, the explicit use of the '''-verbose''' command option will only supersede what is in the configuration file if the '''-verbose''' option comes ''after'' the '''-config''' option on the command line.</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>|}</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>|}</div></td></tr>
<tr><td class='diff-marker'>−</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div><del style="font-weight: bold; text-decoration: none;"></del></div></td><td colspan="2"> </td></tr>
<tr><td class='diff-marker'>−</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div><del style="font-weight: bold; text-decoration: none;"></del></div></td><td colspan="2"> </td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>== Usage Notes ==</div></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"><div>== Usage Notes ==</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td><td class='diff-marker'> </td><td style="background-color: #f8f9fa; color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;"></td></tr>
<tr><td class='diff-marker'>−</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>* Unlike options on the command line, if a boolean option keyword is repeated in the configuration file it is the ''first'' occurrence that takes precedence, rather than the last.</div></td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>* Unlike options on the command line, if a boolean option keyword is repeated in the configuration file it is the ''first'' occurrence <ins class="diffchange diffchange-inline">in the configuration file </ins>that takes precedence, rather than the last<ins class="diffchange diffchange-inline">.</ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins class="diffchange diffchange-inline">* In all cases tested, command line options override configuration options ''only'' when the '''-config''' option ''precedes'' the overriding option on the command line.</ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color: #222; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins class="diffchange diffchange-inline">* While it is an error to list multiple configuration files in a single '''-config''' option, it is not a syntax error to use the '''-config''' option multiple times in the same command line. This is probably a bad idea. The various configuration specifications seem to be combined in a way that is difficult to track or predict</ins>.</div></td></tr>
</table>Raughhttps://sbnwiki.astro.umd.edu/wiki/index.php?title=Validate_Tool_Configuration_File&diff=2226&oldid=prevRaugh: Safety Save2017-05-29T21:17:19Z<p>Safety Save</p>
<p><b>New page</b></p><div>The ''Validate Tool'' has a large number of command options, many of which can take multiple arguments. The configuration file option allows you to code a set of complex and their arguments into a single file for re-use or just convenient editing.<br />
<br />
== File Syntax ==<br />
<br />
The syntax rules for the file are similar to syntax rules for shell scripts or batch files, with some additions:<br />
* Blank lines and lines beginning with the character '#' are ignored.<br />
* Option lines begin with the option keyword, followed by '=', followed by the argument list.<br />
* The argument list can be continued on the next line by ending the previous line with '\'.<br />
* The '\' character can be escaped (in a file specification, for example) by using two in succession ("\\")<br />
* On Windows machines, the usual directory separator '\' can either be escaped, or replaced with '/'.<br />
<br />
== Option Keywords ==<br />
<br />
All option keywords begin with "''validate.''", and must be followed by an equal sign ('=') and the value. Space around '=' is not significant. Keywords are listed in alphabetical here. For details on the referenced command line options, see the "[[Using Validate Tool]]" page on this wiki, where the option are listed by functional group.<br />
<br />
=== ''validate.catalog'' ===<br />
<br />
This option keyword is equivalent to the '''-catalog''' command line option, and thus largely useless.<br />
<br />
=== ''validate.force'' ===<br />
<br />
This keyword takes a boolean argument. Setting it to "true" causes the same behavior as specifying the '''-force''' command line option - directory recursion is suppressed. Values indicating "true" are: '''True''', '''true''', '''Yes''', and '''yes'''. Values indicating "false" are: '''False''', '''false''', '''No''', and '''no'''. Anything else is a syntax error. The default value for this option is "true".<br />
<br />
{| class="wikitable" style="background-color: yellow"<br />
| '''Note:''' ''Contrary to what is stated in the ''Validate Tool - Operation'' document, the explicit use of the '''-force''' command option will only supersede what is in the configuration file if the '''-force''' option comes ''after'' the '''-config''' option on the command line.<br />
|}<br />
<br />
=== ''validate.local'' ===<br />
<br />
This keyword takes a boolean argument. Setting it to "true" causes the same behavior as specifying the '''-local''' command line option - directory recursion is suppressed. Values indicating "true" are: '''True''', '''true''', '''Yes''', and '''yes'''. Values indicating "false" are: '''False''', '''false''', '''No''', and '''no'''. Anything else is a syntax error. The default value for this option is "true".<br />
<br />
{| class="wikitable" style="background-color: yellow"<br />
| '''Note:''' ''Contrary to what is stated in the ''Validate Tool - Operation'' document, the explicit use of the '''-local''' command option will only supersede what is in the configuration file if the '''-local''' option comes ''after'' the '''-config''' option on the command line.<br />
|}<br />
<br />
=== ''validate.model'' ===<br />
<br />
The option keyword takes the same values as the corresponding '''-mode-version''' command line option.<br />
<br />
{| class="wikitable" style="background-color: yellow"<br />
| '''Note:''' ''Contrary to what is stated in the ''Validate Tool - Operation'' document, the explicit use of the '''-model-version''' command option will only supersede what is in the configuration file if the '''-model-version''' option comes ''after'' the '''-config''' option on the command line.<br />
|}<br />
<br />
=== ''validate.regexp'' ===<br />
<br />
This keyword takes a list of file-globbing patterns, each enclosed in double quotes, to select file for validation. The input syntax and limitations are identical to those defined for the '''-regexp''' command option.<br />
<br />
{| class="wikitable" style="background-color: yellow"<br />
| '''Note:''' ''Contrary to what is stated in the ''Validate Tool - Operation'' document, the explicit use of the '''-regexp''' command option will only supersede what is in the configuration file if the '''-regexp''' options comes ''after'' the '''-config''' option on the command line.<br />
|}<br />
<br />
=== ''validate.report'' ===<br />
<br />
This keyword takes a filename argument and directs the standard report output to the named file.<br />
<br />
{| class="wikitable" style="background-color: yellow"<br />
| '''Note:''' ''Contrary to what is stated in the ''Validate Tool - Operation'' document, the explicit use of the '''-report-file''' command option will only supersede what is in the configuration file if the '''-report-file''' option comes ''after'' the '''-config''' option on the command line.<br />
|}<br />
<br />
=== ''validate.reportStyle'' ===<br />
<br />
This keyword takes one of the values '''full''', '''json''', or '''xml'''. The default is '''full'''.<br />
<br />
{| class="wikitable" style="background-color: yellow"<br />
| '''Note:''' ''Contrary to what is stated in the ''Validate Tool - Operation'' document, the explicit use of the '''-report-style''' command option will only supersede what is in the configuration file if the '''-report-style''' option comes ''after'' the '''-config''' option on the command line.<br />
|}<br />
<br />
=== ''validate.schema'' ===<br />
<br />
This keyword is supposed to be the equivalent for the '''-schema''' option on the command line, but it is not. It can be used to provide references to schema files for discipline and local dictionaries, however. As with the command line '''-schema''' option, you should also use the ''validate.schematron'' option to indicate the corresponding Schematron file to get full schema validation.<br />
<br />
{| class="wikitable" style="background-color: yellow"<br />
| '''Note:''' ''This option '''cannot'' be used to supply an alternate schema location for the core ("pds") namespace. Doing so will not produce an error, and the schema indicated will be listed as the "User Specified Schema", but it '''will not''' be applied. You can use the '''-model-version''' command-line option to override the default schema. Attempting to use the '''-schema''' command line option with the '''-config''' option will also cause the referenced core schema to be listed but ignored.''<br />
|}<br />
<br />
=== ''validate.schematron'' ===<br />
<br />
This keyword is the equivalent of the '''-schematron''' command line option.<br />
<br />
{| class="wikitable" style="background-color: yellow"<br />
| '''Note:''' ''Unlike other option keywords, this option keyword '''is not''' overridden by the equivalent command-line option irrespective of the actual command line sequence. The total cumulative list of all Schematron files named in options is applied to labels - once for each time the file is referenced. There is one exception - if a Schematron for the core namespace is included in the list (as determined by the file contents), the default Schematron file for the core namespace is not applied.''<br />
|}<br />
<br />
=== ''validate.target'' ===<br />
<br />
This keyword takes the same sort of value list as the '''-target''' option. This keyword is ignored if targets are supplied for either the ''validate'' command or the '''-target''' option. <br />
<br />
=== ''validate.verbose'' ===<br />
<br />
This keyword takes one of the values: '''1''', '''2''', or '''3''', indicating the severity level of messages reported in the "Validation Details" list in the output report.<br />
<br />
{| class="wikitable" style="background-color: yellow"<br />
| '''Note:''' ''Contrary to what is stated in the ''Validate Tool - Operation'' document, the explicit use of the '''-verbose''' command option will only supersede what is in the configuration file if the '''-verbose''' option comes ''after'' the '''-config''' option on the command line.<br />
|}<br />
<br />
<br />
<br />
== Usage Notes ==<br />
<br />
* Unlike options on the command line, if a boolean option keyword is repeated in the configuration file it is the ''first'' occurrence that takes precedence, rather than the last.</div>Raugh