<doc>
	<legacy_id>2164</legacy_id>
	<name>create folder</name>
	<type>command</type>

	<syntax>
		<example>create folder <i>pathName</i></example>
	</syntax>

	<synonyms>
		<synonym>create directory</synonym>
		<synonym>new folder</synonym>
		<synonym>new directory</synonym>
	</synonyms>

	<summary>Makes a new <property tag="defaultFolder">folder</property>.</summary>

	<examples>
<example>create folder &quot;Translated Documents&quot;</example>
<example>create folder &quot;../My Files/Temp Files&quot;</example>
	</examples>

	<history>
		<introduced version="1.0">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		<changed version="4.6.1">Added Support for Android and iOS.</changed>
	</history>

	<objects>
	</objects>

	<platforms>
		<mac/>
		<windows/>
		<linux/>
		<ios/>
		<android/>
	</platforms>

	<classes>
		<desktop/>
		<server/>
		<web/>
		<mobile/>
	</classes>

	<security>
		<disk/>
	</security>


	<classification>
		<category>Files, Folders, &amp; Resources</category>
	</classification>

	<references>
		<function tag="tempName">tempName Function</function>
		<function tag="specialFolderPath">specialFolderPath Function</function>
		<command tag="revDeleteFolder">revDeleteFolder Command</command>
		<command tag="create alias">create alias Command</command>
		<property tag="umask">umask Property</property>
	</references>

	<description>
	<overview>Use the <b>create folder</b> <glossary tag="command">command</glossary> to make a new <property tag="defaultFolder">folder</property> for a stack's use. For example, if the stack generates temporary <glossary tag="text file">text files</glossary>, creating a <property tag="defaultFolder">folder</property> for the <function tag="files">files</function> prevents them from cluttering the user's system.</overview>

		<parameters>
  <parameter>
    <name>pathName</name>
    <description>Specifies the name and location of the folder. If you specify a name but not a location, the folder is created in the defaultFolder.</description>
  </parameter>		</parameters>

	<value></value>
	<comments>To create a file, use the <b>open file</b> <glossary tag="command">command</glossary>.<p></p><p></p><note>iOS imposes strict controls over what you can and cannot access. Each application in iOS is stored in its own 'sandbox' folder (referred to as the home folder). An application is free to read and write files within this folder and its descendants, but it is not allowed to access anything outside of the 'sandbox'.</note><p></p><p></p><note>An Android application is installed on the phone in the form of its zip package. This means that any assets that are included are not available as discrete files in the native filesystem. In order to manage this the engine essentially 'virtualizes' the asset files you include, allowing (read-only) manipulation with all the standard LiveCode file and folder handling syntax.</note></comments>
	</description>
</doc>