3c3
< <title>EAGLE Help Version 5.10.0</title>
---
> <title>EAGLE Help Version 5.11.0</title>
8c8
< <td align=left>EAGLE Help Version 5.10.0</td>
---
> <td align=left>EAGLE Help Version 5.11.0</td>
583a584
> <tr><td><tt>-Uxxx</tt></td>  <td width=20><td>User settings file</td></tr>
623a625,636
> <h2>User settings</h2>
> User settings are stored in the <tt>eaglerc</tt> file, which, by default, is stored
> in <tt>$HOME/.eaglerc</tt>.
> <table><tr><td valign="top"><img src="platforms-win.png"></td><td valign="middle">
> On <b>Windows</b> it is stored in the file <tt>eaglerc.usr</tt> under
> the directory that is defined by the registry key "HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders\AppData"
> if no environment variable named HOME is defined.
> </td></tr></table>
> The command line option <tt>-U</tt> can be used to overwrite this and have the
> <tt>eaglerc</tt> file be stored at the given location.
> If a <tt>'-'</tt> sign is given as the file name, as in <tt>-U-</tt>, no <tt>eaglerc</tt>
> file will be read or written.
4217,4219c4230,4233
< option    := command | menu | delimiter
< command   := text [ ':' text ]
< menu      := text '{' option [ '|' option ] '}'
---
> option    := command | submenu | delimiter
> command   := [ icon ] text1 [ ':' text2 ]
> submenu   := [ icon ] text '{' option [ '|' option ] '}'
> icon      := '[' filename ']'
4222c4236
< A menu option can either be a simple command, as in
---
> A menu option can be a simple command, as in
4226,4227c4240,4242
< which would set the menu to the commands <tt>Display</tt> and <tt>Grid</tt>;
< an aliased command, as in
---
> which would set the menu to the commands <tt>Display</tt> and <tt>Grid</tt>.
> <tt>Display</tt> and <tt>Grid</tt> are interpreted both as menu text and as commands.
> <br>It can be an aliased command, as in
4232,4234c4247,4248
< and actually execute the command sequence behind the <tt>':'</tt> of each option when
< the respective button is clicked;
< or a submenu button as in
---
> and actually execute the command sequence behind the <tt>':'</tt> of each option (<tt>text2</tt>, see above) when the respective button is clicked.<br>
> It can also be a submenu button as in
4238,4239c4252,4255
< which would define a button labelled <tt>Grid</tt> that, when clicked opens a
< submenu with the two options <tt>Fine</tt> and <tt>Coarse</tt>.
---
> which would define a button labeled <tt>Grid</tt> that, when clicked opens a
> submenu with the two options <tt>Fine</tt> and <tt>Coarse</tt>.<br>
> Character <tt>'|'</tt> is only necessary as a separator in submenu entries
> (<tt>submenu</tt>, see above).
4243a4260,4276
> A command button can display an icon by preceding the button text with the
> file name of an icon, enclosed in square brackets, as in
> <pre>
> MENU '[/path/to/myicon.png] Set a fine grid : Grid inch 0.001;';
> </pre>
> Here the button will display only the given icon, and "Set a fine grid" will
> be used as a "tool tip" that gets displayed when the mouse cursor is moved
> over the button. The filename needs not be enquoted additionally
> (like for masking spaces).<br>
> If an icon is used in a popup menu, like
> <pre>
> MENU 'Grid { [/path/to/myicon.png] Set a fine grid : Grid inch 0.001; }';
> </pre>
> then both the icon and the text will be displayed, as with any other popup menu.<br>
> If the icon's file name doesn't include a directory path, it is searched for
> in the current working directory and in the EAGLE 'bin' directory.
> <p>
4256c4289
< <h2>Example</h2>
---
> <h2>Examples</h2>
4268d4300
< <p>
4270a4303,4328
> <p>
> Complex example:
> <p>
> <pre>
> MENU '[draw.png] Draw {\
>                         Wire {\
>                                Continous : CHANGE STYLE Continuous; WIRE |\
>                                DashDot :  CHANGE STYLE DashDot; WIRE |\
>                                Help : HELP WIRE;\
>                              }|\
>                         Rectangle {\
>                                     RECT |\
>                                     Help : HELP RECT; \
>                                   }\
>                        }\
>       [export.png] Export {\
>                             Script : EXPORT SCRIPT |\
>                             Image : EXPORT IMAGE\
>                           }\
>       MyScript : SCRIPT MyScript.scr;';
> </pre>
> This menu consists of the 3 entries Draw, Export and MyScript, whereat Draw and Export
> have submenus and are supplied with icons. Draw consists of the submenus Wire and
> Rectangle, whereat Wire consists of the entries Continous, DashDot and Help and Rectangle
> consists of the entries RECT (text and command RECT) and Help. <br>
> The submenu of Export has the entries Script and Image.
4936c4994
< has a label. If no label is present, a new name is generated if the previous
---
> has a label, or is connected to a supply pin. Otherwise a new name is generated if the previous
6385c6443
< <tr><td>                         </td><td width=20><td>The <a href=#29>ADD</a> command checks whether a pin has been connected to every pad (with <a href=#40>CONNECT</a>). This check can be switched off. Nevertheless, no board can be generated from a schematic if a device is found which does not have a package.</td></tr>
---
> <tr><td>                         </td><td width=20><td>The <a href=#29>ADD</a> command checks whether every pin has been connected to a pad (with <a href=#40>CONNECT</a>). This check can be switched off. Nevertheless, no board can be generated from a schematic if a device is found which does not have a package.</td></tr>
6389a6448,6449
> <tr><td>Autom. confirmation      </td><td width=20><td><tt>SET CONFIRM OFF | NO | YES;</tt></td></tr>
> <tr><td>                         </td><td width=20><td>Allows confirmation dialogs to be handled automatically (see below for details).</td></tr>
6468a6529,6564
> <h2>Automatic Confirmation</h2>
> At times EAGLE prompts the user with informational or warning messages,
> or requires a decision on how to proceed. This may be unwanted in automated
> processes (like <a href=#91>script files</a>).
> The command
> <pre>
> SET CONFIRM YES
> </pre>
> will automatically confirm every message dialog as if the user had clicked on
> the "positive" button ("OK" or "Yes"). The dialog itself isn't even presented
> to the user.
> Similarly, the command
> <pre>
> SET CONFIRM NO
> </pre>
> acts as if the user had clicked on the "negative" button ("No"), if such a button
> is present. Otherwise it just confirms the dialog.<br>
> Finally, the command
> <pre>
> SET CONFIRM OFF
> </pre>
> turns off automatic confirmation. If automatic confirmation is not turned off
> explicitly, it will automatically fall back to <tt>OFF</tt> the next time the
> editor window accepts some interactive input from the user.
> <p>
> You should not put a <tt>SET CONFIRM YES</tt> at the beginning of a script
> and then execute lots of commands "silently". It is better to explicitly
> put this around individual commands, as in
> <pre>
> SET CONFIRM YES
> REMOVE <i>filename</i>
> SET CONFIRM OFF
> </pre>
> <b>Be extremely careful when using this command! Blindly confirming message
> dialogs may cause important messages to be overlooked. The result may then
> not be what the user expected.</b>
6492a6589,6599
> <dt><b>Cmd.Name.RenameEntireNetByDefault</b>
> <dd>
> If a net consists of more than one segment, the NAME command by default acts only
> upon the selected segment. By setting this parameter to '1' this can be changed
> to rename the entire net by default.
> This parameter also applies to busses.
> <dt><b>Cmd.Name.RenameEntireSignalByDefault</b>
> <dd>
> If a signal contains a polygon, and the NAME command is applied to that polygon,
> by default only the polygon gets renamed. Setting this parameter to '1' makes
> the NAME command act upon the entire signal by default.
6538a6646,6652
> <dt><b>Option.AutoLoadMatchingDrawingFile</b>
> <dd>
> If you have a board and schematic editor window open and load an other board
> (or schematic) in one of these windows, and if that other drawing has a matching
> schematic (or board), EAGLE asks whether that other drawing shall also be loaded.
> By setting this parameter to '1', this query can be suppressed, and EAGLE will
> always automatically load the other drawing.
10752a10867,10871
> <p>
> When determining the column and row of a net on a sheet, first the column and then
> the row within that column is taken into account. Here XREF labels take precedence
> over normal labels, which again take precedence over net wires.
> <p>
11665c11784,11787
< cover that layer (or if that layer isn't used in the layer setup at all).
---
> cover that layer (or if that layer isn't used in the layer setup at all).<br>
> If the given layer is a supply layer on which the via is connected, and the
> <a href=#133>Design Rules</a> parameter "Supply/Generate thermals for vias"
> is turned off, <tt>diameter</tt> will be 0 and <tt>shape</tt> will be <tt>VIA_SHAPE_ROUND</tt>.
13657,13664d13778
< <p>
< As a security precaution, you will be prompted with the <tt>command</tt>
< string before the command is executed, in order to make sure there is no "evil"
< ULP that executes unwanted external commands.
< If this dialog is canceled, the <tt>system()</tt> call will return <tt>-1</tt>.
< If the dialog is confirmed, any future <tt>system()</tt> calls in the current
< EAGLE session with exactly the same command string will be executed without
< any further confirmation dialog.
13714a13829,13841
> <p>
> If you want to have control over what system commands are actually executed,
> you can write a wrapper function that prompts the user for confirmation before
> executing the command, like
> <pre>
> int MySystem(string command)
> {
>   if (dlgMessageBox("!Ok to execute the following command?&lt;p&gt;&lt;tt&gt;" + command + "&lt;/tt&gt;", "&amp;Yes", "&amp;No") == 0)
>      return system(command);
>   return -1;
> }
> int result = MySystem("simulate -f filename");
> </pre>
13853a13981,13983
> <p>
> If you need to use a proxy to access the Internet with HTTP or HTTPS, you can set
> that up in the "Configure" dialog under "Help/Check for Update" in the Control Panel.
13910a14041,14043
> <p>
> If you need to use a proxy to access the Internet with HTTP or HTTPS, you can set
> that up in the "Configure" dialog under "Help/Check for Update" in the Control Panel.
14190c14323
< If <tt>separator</tt> is the newline character (<tt>"\n"</tt>) the resulting
---
> If <tt>separator</tt> is the newline character (<tt>'\n'</tt>) the resulting
14348c14481
< If <tt>separator</tt> is the newline character (<tt>"\n"</tt>) the last field
---
> If <tt>separator</tt> is the newline character (<tt>'\n'</tt>) the last field
15845c15978
< If the dialog is simply closed, the return value will be <tt>0</tt>.
---
> If the dialog is simply closed, the return value will be <tt>-1</tt>.
16429c16562
< <tt>dlgStringEdit(string &amp;Text)</tt>
---
> <tt>dlgStringEdit(string &amp;Text[, string &amp;History[][, int Size]])</tt>
16438c16571,16580
< The <tt>dlgStringEdit</tt> statement defines a text entry field with the given <tt>Text</tt>.
---
> The <tt>dlgStringEdit</tt> statement defines a one line text entry field with the given <tt>Text</tt>.
> <p>
> If <tt>History</tt> is given, the strings the user has entered over time are stored
> in that string array. The entry field then has a button that allows the user to
> select from previously entered strings. If a <tt>Size</tt> greater than zero is given,
> only at most that number of strings are stored in the array. If <tt>History</tt>
> contains data when the dialog is newly opened, that data will be used to initialize
> the history. The most recently entered user input is stored at index 0.<br>
> None of the strings in <tt>History</tt> may be empty (if there is an empty string,
> all strings after and including that one will be dropped).
16997c17139,17140
< <tr><td>&lt;html&gt;...&lt;/html&gt;</td><td width=20><td>An HTML document. It understands the following attributes
---
> <tr><td>&lt;html&gt;...&lt;/html&gt;</td><td width=20><td>An HTML document.</td></tr>
> <tr><td>&lt;html&gt;...&lt;/html&gt;</td><td width=20><td>The body of an HTML document. It understands the following attribute
17000,17002c17143
< <li><tt>background</tt> - The background pixmap, for example <tt>background="granit.xpm"</tt>.
< <li><tt>text</tt> - The default text color, for example <tt>text="red"</tt>.
< <li><tt>link</tt> - The link color, for example <tt>link="green"</tt>.
---
>                        This attribute works only within a <a href=#341>dlgTextView</a>.
17017a17159
>                     If you want to link to a local file that has a blank in its name, you need to prepend the file name with <tt>file:</tt>, as in <tt>&lt;a href="file:/path with blanks/target.html"&gt;...&lt;/a&gt;</tt>.
