docs/wiki/geda-gschem_ug-autonumbering.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
   2  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   3 <html>
   4 <head>
   5   <link rel="stylesheet" media="screen" type="text/css" href="./style.css" />
   6   <link rel="stylesheet" media="screen" type="text/css" href="./design.css" />
   7   <link rel="stylesheet" media="print" type="text/css" href="./print.css" />
   8
   9   <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  10 </head>
  11 <body>
  12 <a href=.>start</a>&nbsp;=>&nbsp;<a href=geda-gschem_ug.html>gschem_ug</a></br>
  13 <div class="table sectionedit1"><table class="inline">
  14         <tr class="row0">
  15                 <td class="col0 leftalign"> « <a href="geda-gschem_ug-slots.html" class="wikilink1" title="geda-gschem_ug-slots.html">Slots and slotting</a>  </td><td class="col1 centeralign">  <strong><a href="geda-gschem_ug.html" class="wikilink1" title="geda-gschem_ug.html">gEDA gschem User Guide</a></strong>  </td><td class="col2 rightalign">  <a href="geda-gschem_ug-hierarchy.html" class="wikilink1" title="geda-gschem_ug-hierarchy.html">Hierarchy</a> » </td>
  16         </tr>
  17 </table></div>
  18 <!-- EDIT1 TABLE [1-107] -->
  19 <h2 class="sectionedit2" id="autonumbering">Autonumbering</h2>
  20 <div class="level2">
  21
  22 <p>
  23 It is often useful to automatically number <a href="geda-gschem_ug-attributes.html" class="wikilink1" title="geda-gschem_ug-attributes.html">attributes</a> (for example, to set “<code>pinseq=</code>” attributes in bulk when editing a symbol, or to set components&#039; “<code>refdes=</code>” attributes for a large capacitor bank).  The autonumbering facility in gschem can be accessed with <strong>Attributes→Autonumber Text</strong>.
  24 </p>
  25
  26 <p>
  27 The “Autonumber text” window has two sections:
  28 </p>
  29 <ul>
  30 <li class="level1"><div class="li"> The “Scope” section, at the top, is used to specify which attributes should be autonumbered.</div>
  31 </li>
  32 <li class="level1"><div class="li"> The “Options” section below controls how the numbering is carried out.</div>
  33 </li>
  34 </ul>
  35
  36 </div>
  37 <!-- EDIT2 SECTION "Autonumbering" [109-661] -->
  38 <h3 class="sectionedit3" id="choosing_attributes_to_number">Choosing attributes to number</h3>
  39 <div class="level3">
  40
  41 <p>
  42 In the “Search for” field, you should enter the attribute pattern to search for. You can enter <em>wildcards</em> here: “<code>*</code>” matches any number of characters, and “<code>?</code>” matches any single character.  For example, if you enter “<code>refdes=X*</code>”, it will match components named “<code>X1</code>”, “<code>X40</code>”, “<code>X302</code>”, etc.
  43 </p>
  44
  45 <p>
  46 The “Autonumber text in” menu controls where autonumbering looks for attributes to modify.  If “Selected objects” is chosen, only the objects that are currently <a href="geda-gschem_ug-selecting.html" class="wikilink1" title="geda-gschem_ug-selecting.html">selected</a> will be changed; with “Current page”, the whole page will be autonumbered.  If “Whole hierarchy” is chosen, all open pages will be renumbered.
  47 </p>
  48
  49 <p>
  50 If some numbers are already in use, autonumbering will skip them.  You can control where autonumbering looks for numbers to skip using the “Skip numbers found in” menu, which has the same options as the “Autonumber text in” menu described above.
  51 </p>
  52
  53 <p>
  54 If “Overwrite existing numbers” is enabled, all attributes found that match the pattern given in the “Search for” field will be renumbered; otherwise, only those that aren&#039;t already numbered will be changed.
  55 </p>
  56
  57 </div>
  58 <!-- EDIT3 SECTION "Choosing attributes to number" [662-1799] -->
  59 <h3 class="sectionedit4" id="controlling_number_assignment">Controlling number assignment</h3>
  60 <div class="level3">
  61
  62 <p>
  63 The “Starting number” sets the first number that autonumbering will try to assign.  For example, to renumber a page with component numbers <code>U100</code>, <code>R101</code>, etc., set the “Starting number” to 100. The “Sort order” controls what order autonumbering assigns numbers.
  64 </p>
  65
  66 <p>
  67 If the “Remove numbers” option is enabled, then attributes have their numbers reset to “<code>?</code>” (for example, “<code>R10</code>” becomes “<code>R?</code>”).
  68 </p>
  69
  70 </div>
  71 <!-- EDIT4 SECTION "Controlling number assignment" [1800-] --></body>
  72 </html>