<doc>
  <legacy_id>2525</legacy_id>
  <name>externals</name>
  <type>property</type>
  <syntax>
    <example>set the externals of <i>stack</i> to <i>filePathsList</i></example>
  </syntax>
  <library></library>
  <objects>
    <stack/>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Writing LiveCode</category>
  </classification>
  <references>
    <property tag="imagePixmapID">imagePixmapID Property</property>
    <property tag="externalPackages">externalPackages Property</property>
    <function tag="deleteResource">deleteResource Function</function>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
    <changed version="2.0"></changed>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
  </classes>
  <security>
  </security>
  <summary>Specifies a list of <function tag="files">files</function> containing external code that are to be <glossary tag="loaded into memory">loaded into memory</glossary> when the <object tag="stack">stack</object> opens.</summary>
  <examples>
    <example>set the externals of stack "Apps" to field "Executables"</example>
  </examples>
  <description>
    <p>Use the <b>externals</b> <glossary tag="property">property</glossary> to use the <property tag="externals">externals</property> in the specified <function tag="files">files</function>.</p><p/><p><b>Value:</b></p><p>The <b>externals</b> of a <object tag="stack">stack</object> reports a list of <glossary tag="file path">file paths</glossary>, one per line.</p><p/><p><b>Comments:</b></p><p>Each line of the <b>externals</b> specifies the <glossary tag="file path">name and location</glossary> of a <keyword tag="file">file</keyword> containing <glossary tag="external">external commands</glossary> and <glossary tag="external">external functions</glossary>. If you specify a name but not a location, the <keyword tag="file">file</keyword> is assumed to be in the <property tag="defaultFolder">defaultFolder</property>.</p><p/><p>The files are executed when the stack is opened, making the externals in them available to handlers in the stack.</p><p/><p><img src="202653"/> <b>Important!</b> When you install a new <glossary tag="external">external</glossary> by setting a <glossary tag="stack">stack's</glossary> <property tag="externals">externals</property> <glossary tag="property">property</glossary>, LiveCode cannot use it until you either quit LiveCode and then reopen the <object tag="stack">stack</object>, or close the <object tag="stack">stack</object> (after setting its <property tag="destroyWindow">destroyWindow</property> <glossary tag="property">property</glossary> to true) and then reopen it.</p><p/><p><img src="202654"/> <b>Cross-platform caution!</b> It is not possible to load externals written for PowerPC in an application running natively on an Intel Mac. To get around this limitation either use Universal Binary externals, or run the program under Rosetta.</p><p/><p><b>Changes:</b></p><p>Support for using the <b>externals</b> property on <glossary tag="OS X">OS X systems</glossary> was added in version 2.0.</p>
  </description>
</doc>