wudsn-ide/com.wudsn.ide.lng/help/ide-faq.section.html

<p>Here, you can find the answers to frequently asked questions. If
	your question is unanswered, please review the video tutorials or
	contact me.</p>
<ul>
	<li><a href="#Installation">Installation</a>
		<ul>
			<li><a href="#FAQJavaInstallation">How do I install Java?</a></li>
			<li><a href="#FAQJavaJarStart">When I try to start a .jar
					file via double-click, nothing happens. What is wrong?</a></li>
			<li><a href="#FAQEclipseInstallation">How do I install
					Eclipse?</a></li>
			<li><a href="#FAQEclipseInstallationWin7">When I try to
					start Eclipse, I get an error like "Failed to load the JNI shared
					library 'C:\Program Files (x86)\Java\jre6\bin\client\jvm.dll'".
					What is wrong? </a></li>
			<li><a href="#FAQWUDSNInstallationUpdateSite">Why is WUDSN
					IDE not available via the update site?</a></li>
			<li><a href="#FAQWUDSNInstallationUpdateSiteBlocked">Why do
					I get "Unable to read repository at ... Read timed out" when
					accessing the update site?</a></li>
			<li><a href="#FAQWUDSNInstallationUpdateSiteRequiredItems">Why
					do I get "Cannot complete the install because one or more required
					items could not be found" when updating the plugin from the update
					site?</a></li>
			<li><a href="#FAQEclipseUserGuide">How do I use Eclipse?</a></li>
			<li><a href="#FAQWUDSNInstallationPreferencesNotVisible">Why
					is the "Assembler" section not visible in the preferences?</a></li>
		</ul></li>
	<li><a href="#Configuration">Configuration</a>
		<ul>
			<li><a href="#FAQFileAssociations">How do I associate my
					source file extensions with the correct editor?</a></li>
			<li><a href="#FAQHardwareAnnotation">Why must I put
					";@com.wudsn.ide.lng.hardware=..." in the source file?</a></li>
			<li><a href="#FAQProblemsView">Why do I see wrong messages
					in the "Problems" view?</a></li>
		</ul></li>
	<li><a href="#Editing">Editing</a>
		<ul>
			<li><a href="#FAQEclipseSpeed">Why is editing sometimes
					slow, or is everything blocked, showing the wait cursor?</a></li>
			<li><a href="#FAQSourceVersionControl">Is there support for
					source version control?</a></li>
			<li><a href="#FAQBlockSelectionMode">Is there support for
					the block selection mode?</a></li>
			<li><a href="#FAQContentAssist">Why does "CTRL-Space" not
					open content assist?</a></li>
			<li><a href="#FAQCtrlShiftShortcuts">Why do "CTRL-SHIFT-0/9"
					and other key combinations not work?</a></li>
		</ul></li>
	<li><a href="#Compiling">Compiling</a>
		<ul>
			<li><a href="#FAQPrimaryCompiler">Why is MADS the primary
					compiler?</a></li>
			<li><a href="#FAQPrimaryCompilerExample">Why do I get the
					error "No ORG defined" when compiling the example from the
					tutorial?</a></li>
			<li><a href="#FAQErrorsFromIncludeFiles">Why are the errors
					and warnings from an included file assigned to the primary source
					file in the problems view?</a></li>
			<li><a href="#FAQATASMtoMADSConversion">How do I convert
					from ATASM format to MADS format?</a></li>
			<li><a href="#FAQATASMSegments">How does ATASM generate
					segments in executable files?</a></li>
			<li><a href="#FAQROMImages">How do I compile into ROM
					images?</a></li>
			<li><a href="#FAQDiskImages">How do I compile into disk
					images?</a></li>
			<li><a href="#FAQRunMakefile">How to run a makefile script
					instead of an emulator?</a></li>
		</ul></li>
	<li><a href="#Emulation">Emulation</a>
		<ul>
			<li><a href="#FAQOtherEmulators">How can I use other
					emulators?</a></li>
		</ul></li>
</ul>
<h3 id="Installation">Installation</h3>
<div id="FAQJavaInstallation">
	<h4>How do I install Java?</h4>
	<p>
		I recommend you visit <a href="https://openjdk.java.net">OpenJDK</a>
		and follow the instructions to download and install the latest
		version. Make sure the Java version, the Eclipse version, and your
		operating system have the same architecture. Newer versions of Java
		only support 64-bit architectures.
	</p>
	<div id="FAQJavaJarStart">
		<h4>Nothing happens When I try to start a .jar file via
			double-click. What is wrong?</h4>
		<p>You probably have the wrong Java version installed or set a
			default. Open a shell window and enter "java -jar
			&lt;yourfile.jar&gt;". If this works, then you have the wrong program
			or Java version associated with the ".jar" file extension in the
			registry. You can fix that by setting the path to the correct Java
			installation folder using "REGEDIT.EXE" for
			"Compute\HKEY_CLASSES_ROOT\jarfile\shell\open".</p>
		<p>
			<img src="productions/java/ide/faq/java-jarfile-registry.png"
				alt="Java jar file registry entry" />
		</p>
		<p>If starting from the command line does not work, you should see
			a more detailed error message about why.</p>
	</div>
	<div id="FAQEclipseInstallation">
		<h4>How do I install Eclipse?</h4>
		<p>
			If you are unfamiliar with Eclipse, ensure you have installed the <b>Eclipse
				platform distribution</b> without Java or J2EE tools. This distribution
			is much smaller (typically around 60-80 MB instead of 170 MB) and
			will not confuse you with many features and buttons you do not need.
			See the "Installing Eclipse" section for the required steps on the "
			Installation " tab. If you use Windows, you can use one of the zero
			installation distributions of WUDSN IDE, which are linked on the tab
			"Installation". They are ".zip" archives containing Eclipse and
			everything else."
		</p>
	</div>
	<div id="FAQEclipseInstallationWin7">
		<h4>When I try to start Eclipse, I get an error like "Failed to
			load the JNI shared library 'C:\Program Files
			(x86)\Java\jre6\bin\client\jvm.dll'". What is wrong?</h4>
		<p>The Eclipse version and the Java version on your system are not
			compatible. The Eclipse is not pure Java but uses platform-specific
			native libraries to run and debug Java efficiently. For example, you
			must install the 64-bit version of Java (JRE or JDK) if you want to
			use the 64-bit version of Eclipse. This is a frequent issue under
			Windows 7 because, by default, only the 32-bit version of Java is
			installed. See the "Installing Eclipse" section for the required
			steps on the " Installation " tab.</p>
	</div>
	<div id="FAQEclipseUserGuide">
		<h4>How do I use Eclipse at?</h4>
		<p>Start the built-in help of Eclipse via the "Help/Help Content"
			menu and read the "Workbench User Guide" section.</p>
		<img src="productions/java/ide/faq/ide-workbench-user-guide.png"
			alt="Workbench user guide" />
	</div>
	<div id="FAQWUDSNInstallationUpdateSite">
		<h4>Why is WUDSN IDE not available via the update site?</h4>
		<p>You likely typed in the wrong update site URL, for example,
			using "wusdn" instead of "wudsn". The correct URL is
			"http://www.wudsn.com/update". In addition, you should uncheck the
			checkbox "Hide items that are already installed" to see what is
			there. See the "Installing WUDSN IDE" section for the required steps
			on the " Installation " tab.</p>
		<img src="productions/java/ide/faq/ide-update-site.png"
			alt="Installation dialog with update site" />
	</div>
	<div id="FAQWUDSNInstallationUpdateSiteBlocked">
		<h4>Why do I get "Unable to read repository at ... Read timed
			out" when accessing the update site?</h4>
		<p>This error message indicates the Eclipse program is somehow
			blocked from accessing the site. If you are behind a proxy server,
			check the general proxy server settings in the Eclipse preferences.
			If you use a firewall or internet security tool, make sure
			"Eclipse.exe", "java.exe", "javaw.exe," or the corresponding program
			on your host platform are allowed to cannot to the internet. Maybe
			you have to change the settings so you are prompted to allow access
			interactively.</p>
	</div>
	<div id="FAQWUDSNInstallationUpdateSiteRequiredItems">
		<h4>Why do I get "Cannot complete the install because one or more
			required items could not be found" when updating the plugin from the
			update site?</h4>
		<p>
			This error message indicates that the Eclipse version you are running
			is too old. Check the <a href="index.php/ide/releases"
				target="_blank" rel="noopener noreferrer">releases</a> page for the
			required minimum Eclipse version for every WUDSN IDE release.
		</p>
	</div>
	<div id="FAQWUDSNInstallationPreferencesNotVisible">
		<h4>Why is the "Assembler" section not visible in the
			preferences?</h4>
		<p>
			If the WUDSN IDE sections and features are not visible after a
			successful installation, you probably use an outdated Java version.
			For example, Java 1.6 has been <a
				href="http://www.oracle.com/technetwork/java/eol-135779.html"
				target="_blank" rel="noopener noreferrer">out of maintenance
				since 2013/02</a>. This seems to be a common problem on Mac OS X, even
			in Mavericks (10.9), which still uses Java 1.6 by default. Ensure you
			have at least the Java version mentioned in the installation section
			for the IDE installed and that Eclipse has started using that
			version.
		</p>
	</div>
	<h3 id="Configuration">Configuration</h3>
	<div id="FAQProblemsView">
		<h4>Why do I see wrong messages in the "Problems" view?</h4>
		<p>The default configuration of the "Problems" view shows all
			errors from all files in the current project. While this is a good
			default for Java programming, it is unsuitable for compiling single
			independent assembler files. Therefore, you have to configure the
			"Problems" view accordingly. See the "Installing Eclipse" section for
			the required steps on the " Installation " tab.</p>
	</div>
	<div id="FAQFileAssociations">
		<h4>How do I associate my source file extensions with the correct
			editor?</h4>
		<p>
			The IDE supports many different compilers and provides a specialized
			editor for each. Typically, you have some preferred source file
			extension (".asm" or ".a") and a preferred compiler. The procedure to
			associate the file extension with the editor via the preferences is
			described in this video tutorial <a
				href="http://www.youtube.com/watch?v=QgQOle36hRA">WUDSN IDE
				Tutorial 3: Setting up Editors and File Extensions correctly</a>.
		</p>
	</div>
	<div id="FAQHardwareAnnotation">
		<h4>Why must I put ";@com.wudsn.ide.lng.hardware=..." in the
			source file?</h4>
		<p>The association with the file extension with your compiler's
			editor (done in the preferences; see before) does not determine which
			platform you want to create output. Therefore, this additional
			annotation in the main source file must tell the IDE, which is the
			target platform. It is used to find the correct compiler and emulator
			settings, which can differ per platform. Every compiler has a default
			platform (see the online help in the IDE), but it can also be used on
			every other platform. Therefore, you must specify the target platform
			in the main source file if you use a non-default platform.</p>
	</div>
	<h3 id="Editing">Editing</h3>
	<div id="FAQEclipseSpeed">
		<h4>Why is editing sometimes slow, or is everything blocked,
			showing the wait cursor?</h4>
		<p>The core of WUDSN IDE uses the Eclipse Platform Runtime only
			and does not require any additional plugins. It starts quickly and
			dashes with that configuration, and I use it daily. So, if you
			experience performance problems, try to download and run the zero
			installation distribution of WUDSN IDE. Performance problems are very
			likely caused by additional plugins or themes installed. Often, these
			plugins are not only slow but broken. Check the ".metadata/.log" file
			in the workspace folder. In some Eclipse versions, this is available
			via "Window/Show View.../Error Log".</p>
	</div>
	<div id="FAQSourceVersionControl">
		<h4>Is there support for source version control?</h4>
		<p>Yes, several plugins are available to connect Eclipse to CVS or
			subversion. Also, the "Local History" feature is installed by
			default. You can configure it in the preferences. It automatically
			records all changes to the source file and lets you compare versions
			in place.</p>
		<img src="productions/java/ide/faq/ide-version-control.gif"
			alt="Source version control" />
	</div>
	<div id="FAQBlockSelectionMode">
		<h4>Is there support for a block selection mode?</h4>
		<p>Yes, a toolbar button and the shortcut "ALT+SHIFT+A" to toggle
			block selection mode in all text editors. This can be useful for
			adding and removing common prefixes such as line numbers.</p>
		<img
			src="productions/java/ide/faq/ide-editor-toggle-block-selection-mode.png"
			alt="Toggle block selection mode" />
		<p>If the toolbar button is not visible, you have to set it to
			visible via the menu entry "Customize Perspective" in the context
			menu of the main toolbar. In the customizing dialog, you must
			activate the "Editor Presentation" command group and the toolbar
			entries you want to see.</p>
		<img
			src="productions/java/ide/faq/ide-editor-block-selection-mode-toolbar.gif"
			alt="Toggle block selection mode" />
	</div>
	<div id="FAQContentAssist">
		<h4>Why does "CTRL-Space" not open content assist?</h4>
		<p>There is a known keyboard assignment conflict when using
			Messenger Plus Live! v4.85.0.386 with Microsoft Messenger 2009 on
			Windows 7 Ultimate. This may also occur in other versions, of course.
			Justin Payne has provided the following description of the solution.</p>
		<ol>
			<li>Startup and log into MS Messenger.</li>
			<li>From the main window, hit the ALT key to bring up the main
				menu and select "Plus! | Preferences &amp; Options".</li>
			<li>From the Preferences windows, Select the Messenger tab and
				uncheck "Activate Messenger Lock with a system-wide shortcut" OR
				change the value in its text box to something other than "CTRL +
				Space".</li>
			<li>Press the "OK" button.</li>
		</ol>
		<div id="FAQCtrlShiftShortcuts">
			<h4>Why do CTRL-SHIFT-0/9 and other key combinations not work?</h4>
			<p>You probably have another program outside of Eclipse that has
				already captured these keys or key combinations. A frequent problem
				is the Windows Input Methods Editor (IME), which is used to switch
				keyboard layouts. For example, if you use multiple keyboard layouts,
				the CTRL-Space is mapped to allow you to cycle between the different
				keyboard regional keyboard layouts. You should be aware of how to
				turn the feature off since you're probably using this feature, but
				if you don't...</p>
			<p>Windows 7</p>
			<ol>
				<li>Within "Windows Control Panel", open "Region and Settings".</li>
				<li>Select the "Keyboard and Languages" tab and "Change
					Keyboards...".</li>
				<li>In the "Text Services and Input Languages" windows, select
					"Advanced Key Settings".</li>
				<li>In the "Hot Keys for input languages" list box, select
					"Between input languages" and then select "Change Key Sequence..."</li>
				<li>In the "Change Key Sequence" window, choose another radio
					button other than the one next to CTRL+Shift. At best, you choose
					"(None)".</li>
				<li>Click OK until you close all popup windows.</li>
			</ol>
			<p>Windows 10</p>
			<ol>
				<li>Open "Control Panel\Clock, Language, and
					Region\Language\Advanced settings.</li>
				<li>Click the "Change Language bar hot keys".</li>
				<li>Set all key sequences to "(None)".</li>
				<li>Click OK until you close all popup windows.</li>
			</ol>
			<p>
				Of course, this is Windows 7/10, and we know how Microsoft loves to
				change its layouts and names, but this option is available back to
				Windows XP. <br /> <img
					src="productions/java/ide/faq/windows-text-services-and-input-languages.png"
					alt="Configure Windows IME hot keys" />
			</p>
		</div>
		<h3 id="Compiling">Compiling</h3>
		<div id="FAQPrimaryCompiler">
			<h4>Why is MADS the primary compiler?</h4>
			<p>When I started with WUDSN IDE, ATASM was the first supported
				compiler. The reason was simple: 90% of my sources are in ATASM
				format. ATASM is very comprehensive and fast. Its capabilities to
				define constants and byte sequences are extensive (".BYTE", ".WORD",
				".DBYTE", ".FLOAT", ".SBYTE" for ATASCII, ".CBYTE" for terminated
				strings, separate offset for all constants). Over time, additional
				platform compilers have been added, and their support will be
				completed step by step. When the support for MADS was relatively
				complete, I found it the most powerful compiler I have ever seen and
				used. The support for ".PROC/.ENDPROC" has revolutionized how I
				write assembler code. It allows logical structuring and visibility
				control without any runtime overhead. At the same time, MADS is
				compatible with MAC/65 and XASM, and even ATASM sources can be
				adapted to MADS with a few minor changes described below. Therefore,
				MADS has been the primary compiler since WUDSN IDE version 1.6.0.</p>
		</div>
		<div id="FAQPrimaryCompilerExample">
			<h4>Why do I get the error "No ORG defined" when compiling the
				example from the tutorial?</h4>
			<p>Since WUDSN IDE version 1.6.0 MADS is the primary compiler
				registered for the file extensions ".asm" upon installation. You are
				trying to run the code example for version 1.5.0 or before, which is
				in ATASM format. Therefore, you can either.</p>
			<ul>
				<li>Convert the source to MADS format as described in <a
					href="#FAQATASMtoMADSConversion">How do I convert from ATASM
						format to MADS format?</a> This is the recommended way.
				</li>
				<li>Open the source with the ATASM editor using "Open With..."
					in the context menu of the Project Explorer.</li>
				<li>Change the default editor for the file extension ".asm" in
					the preferences for "File Associations" as described in the video
					tutorial <a
					href="http://www.youtube.com/watch?v=QgQOle36hRA&amp;hd=1"
					target="_blank" rel="noopener noreferrer">Part 3: Setting up
						Editors and File Extensions correctly</a>.
				</li>
			</ul>
		</div>
		<div id="FAQErrorsFromIncludeFiles">
			<h4>Why are the errors and warnings from an included file
				assigned to the primary source file in the problems view?</h4>
			<p>You use a case-insensitive file system and have used different
				upper or lower-case writing in the statement than in the actual file
				system. For example, you have written "ICL 'example.asm'" for a file
				named "Example.asm" on the file system. In Eclipse, the file names
				of all resources are treated as case-sensitive, even if the
				underlying file system is case-insensitive. Therefore, the file name
				issued by the compiler will not match the file name. The IDE assigns
				the error message to the primary source file as a fallback. To fix
				this, you must adapt the spelling of the file name in the source
				include statement.</p>
		</div>
		<div id="FAQATASMtoMADSConversion">
			<h4>How do I convert from ATASM format to MADS format?</h4>
			<p>Because both ATASM's and MADS's syntax are based on the MAC/65
				syntax. There are not many differences. Therefore, manual conversion
				using "Find/Replace (CTRL-F)" is easy.</p>
			<ul>
				<li>Replace the origin definition "* = address" with "ORG
					address".</li>
				<li>Replace ".INCLUDE" with "ICL" for source includes.</li>
				<li>Replace ".INCBIN" with "INS" for binary includes.</li>
				<li>Replace "* = $2E0; .WORD address" with "RUN address" to
					specify the run address.</li>
				<li>Replace "* = $2E2; .WORD address" with "INI address" to
					specify the initialization address.</li>
				<li>Check the quotes of ".BYTE" and "DTA" statements. In MADS,
					single quotes result in ASCII codes and double quotes in ATARI
					screen codes.</li>
				<li>Remove all ".BANK" statements. While ATASM sorts and merges
					all segments within one bank statement, MADS uses the order of
					segments defined in the source file. Every "ORG" statement
					automatically generates a new file segment.</li>
			</ul>
		</div>
		<div id="FAQATASMSegments">
			<h4>How does ATASM generate segments in executable files?</h4>
			<p>A helpful feature for small projects is that, by default,
				ATASM sorts the segments by address and warns if the same address is
				overwritten by code or data. Since version 1.05, the ".BANK"
				directive is available, which allows you to create COM files with
				"INITAD" segments and arbitrary segment counts. If you don't use the
				".BANK" directive, ATASM will sort the segments by their address and
				put consecutive blocks into a single segment by default. While this
				saves some bytes, it might be unclear if you are used to other
				assemblers. Note that you must use the ".SET 6" directive to set the
				assembler origin offset in every bank if you use it in one of the
				banks.</p>
			<div style="font-family: courier, monospace; font-size: 13px;">
				; Bank 0 <br />.bank <br />.set 6,0 <br />* = $8000 <br />start
				lda #0 <br />jmp * <br /> <br />; Bank 1 <br />.bank .set 6,0 <br />*
				= $2e0 <br />.word start; <br /> <br />; Bank 2 <br />.bank <br />.set
				6,$4300-$C000 <br />* = $C000 <br />lda #1 <br />sta label+1 <br />label
				lda #2 <br />jmp *
			</div>
		</div>
		<div id="FAQROMImages">
			<h4>How do I compile into ROM images?</h4>
			<p>Plain ROM Images do not have header bytes by default, or at
				least they do not have the same header bytes as executable files.
				Compiler-specific options must be used to create raw object files
				without headers. Some cases are listed below. See the manual of the
				specific compiler for more details.</p>
			<ul>
				<li>ACME: Use the compiler parameter " <b>-f plain</b> "
					instead of "-f cbm" (default) to switch to "plain" mode without a
					header
				</li>
				<li>ATASM: Extend the compiler parameter "-o${outputFilePath}"
					to " <b>-r</b> -o${outputFilePath}" to switch to "raw" mode without
					header
				</li>
				<li>MADS: Use " <b>OPT h-f+</b> " at the very beginning of the
					source file to turn off the COM header and enable "fill" mode,
					i.e., no segments are created if there are gaps in the object code
				</li>
			</ul>
		</div>
		<div id="FAQDiskImages">
			<h4>How do I compile into disk images?</h4>
			<h5>Atari 8-bit</h5>
			<p>
				For Atari 8-bit, the ATASM compiler has a dedicated parameter to
				write the executable file directly into ".ATR" or ".XFD" disk
				images. The disk image must be formatted with Atari DOS 2.0S, DOS
				2.5, or a compatible DOS. All Atari 8-bit disk formats can be
				created using the "dir2atr.exe" tool of the <a
					href="http://www.horus.com/~hias/atari/" target="_blank"
					rel="noopener noreferrer">AtariSIO tools</a> by Matthias Reichl
				(hias). The command line tool can create a complete disk image with
				arbitrary DOS (Atari DOS 2.5, MyDos, SpartaDOS) and size based on a
				folder that contains "DOS.SYS", "DUP.SYS" (or the equivalent files
				of the respective DOS) and all other files requires. I have packaged
				an example, including the "dir2atr" tool, a batch script to call the
				command line tool and emulator, and this archive's "files" folder.
				Unpack the archive to your output folder. Double-click
				"makefile.bat" to see how the disk image is created and started.
				Read the section "<a href="#FAQRunMakefile">How to run a
					makefile script instead of an emulator?</a>" for the details on
				configuring the call to "makefile.bat". For productive usage, you
				should put the "hias" folder into a central location and use the
				most recent version from Matthias Reichl's website. For MacOS X
				users, the download also contains a "makefile.sh" script and MacOS X
				binaries of Matthias Reichl's tools. The binaries have been provided
				by Fredrick Holst (freetz), and you can find the latest versions on
				his <a href="http://frederik.hol.st/atari/8-bit/AtariSIO4Mac/"
					target="_blank" rel="noopener noreferrer">website</a>.
			</p>
			<h5>Apple II</h5>
			<p>
				For Apple II, WUDSN IDE automatically generates a bootable AppleDos
				3.3 disk image with the extension ".dsk" if one of the predefined
				emulators is used for execution. If you want to use another DOS or
				disk size or if you're going to put more files onto the disk after
				compilation, you can use the command line version of <a
					href="https://sourceforge.net/projects/applecommander/"
					target="_blank" rel="noopener noreferrer">AppleCommander</a> to
				achieve this. Create and configure a makefile script as described in
				"<a href="#FAQRunMakefile">How to run a makefile script instead
					of an emulator?</a>". In the case of Apple Disk images, always remember
				to use the correct file content/load/run address. The IDE needs to
				know the load address of an executable file to store this
				information in the directory entry. The IDE evaluates the file
				extension to detect the load address from the executable file.
				Supported extensions are ".b", ".prg," and ".xex". Here's the logic
				for the built-in disk image creation:
			</p>
			<ul>
				<li>File extension ".b" <br />// AppleDos 3.3 binary file:
					start-lo, start-hi, length-lo, length-hi, data <br />address =
					getWord(outputFileContent, 0);length = length - 4;content =
					getData(outputFileContent, 4);
				</li>
				<li>File extension ".prg" and length &gt; 2 <br />// C64
					program file: start-lo, start-hi, data <br />address =
					getWord(outputFileContent, 0);length = length - 2;content =
					getData(outputFileContent, 2);
				</li>
				<li>File extension ".xex" and length &gt; 6 and
					(getWord(outputFileContent, 0) &amp; 0xffff) == 0xffff) <br />//
					AtariDOS 2.5 binary file:$ff, $ff, start-lo, start-hi, end-lo,
					end-hi, data <br />address = getWord(outputFileContent, 2);length
					= length - 6;content = getData(outputFileContent, 6);
				</li>
			</ul>
			<h5>Other hardware</h5>
			<p>
				If you find a tool similar to "dir2atr.exe" for the Atari 8-bit or
				"AppleCommander" for the Apple II, you can create your script and
				run it as described in "<a href="#FAQRunMakefile">How to run a
					makefile script instead of an emulator?</a>".
			</p>
		</div>
		<div id="FAQRunMakefile">
			<h4>How can I run a makefile or script instead of an emulator?</h4>
			<p>
				Sometimes, running a makefile script instead of the emulator is
				helpful, for example, if the output file is combined with other
				files into a single ATR file. To execute such a script, select "User
				Defined Application" as the "Default Application to open Output
				File". Specify the path to the shell as "Path to Application". On
				the command line, you can then use the standard variables to start
				the command shell and pass the script's name and the file path of
				the compiled output file. Since the working directory during
				execution is the compiler's output folder, you must place the script
				file there or specify the script file with its absolute path. If you
				are using Windows and "cmd.exe" as your shell, you must add "/c"
				before the name of the script to prevent "cmd.exe" from remaining as
				a process after the script has finished. The resulting command line
				is "${runnerExecutablePath} /c makefile.bat ${outputFilePath}",
				assuming "makefile.bat" is located in the output folder". See
				section "<a href="#FAQDiskImages">How do I compile into disk
					images?</a>" for the description of how to use this for compiling
				complete disk images.
			</p>
			<img
				src="productions/java/ide/faq/ide-assembler-preferences-compilers-makefile.png"
				alt="Configure makefile script" />
		</div>
		<h3 id="Emulation">Emulation</h3>
		<div id="FAQOtherEmulators">
			<h4>How can I use other emulators?</h4>
			<p>You can "re-use" the existing tabs and specify another
				emulator's executable. Using "User Defined Application", you can
				select whatever you want. When using "User Defined Application", no
				disk image is created or updated. You can use this setting to have
				your script, which puts the executable file onto a disk image of
				your choice, using additional tools like "dir2atr.exe" or
				"AppleCommander," for example.</p>
		</div>
	</div>
</div>