<doc>
	<legacy_id>1667</legacy_id>
	<name>compact</name>
	<type>command</type>

	<syntax>
		<example>compact <i>stack</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Reclaims unused space within a <glossary tag="stack">stack's</glossary> <keyword tag="file">file</keyword> structure.</summary>

	<examples>
<example>compact this stack</example>
<example>compact stack "Project 1"</example>
	</examples>

	<history>
		<introduced version="1.0">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		
		<experimental version=""></experimental>
		<nonexperimental version=""></nonexperimental>
	</history>

	<objects>
	</objects>

	<platforms>
		<mac/>
		<windows/>
		<linux/>
	</platforms>

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

	<security>
	</security>


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

	<references>
		<command tag="delete">delete Command</command>
	</references>

	<description>When you cut or delete a card, some free space is left within the stack. This empty space is reclaimed when you choose <b>File menu</b>. Use the <b>compact</b> <glossary tag="command">command</glossary> to reclaim this empty space without having to save the <object tag="stack">stack</object>.<p></p><p><b>Parameters:</b></p><p>The <i>stack</i> is any stack reference.</p><p></p><p><b>Comments:</b></p><p>This command is especially useful when a handler performs multiple rearrangements of cards without saving the stack.</p><p></p><p>The "Save" menu item in the File menu automatically compacts the stack. However, the <b>save</b> <glossary tag="command">command</glossary> does not do so.</p></description>
</doc>