From 64724402848cf96745d80efbcbefd859b7c328a4 Mon Sep 17 00:00:00 2001 From: Peter Dell Date: Wed, 30 Aug 2023 20:43:50 +0200 Subject: [PATCH] Update documentation for "WUDSN_LANGUAGE". --- com.wudsn.ide.lng/help/ide-faq.section.html | 11 +++++++---- com.wudsn.ide.lng/help/ide-features.section.html | 1 + .../help/ide-installation.section.html | 15 +++++++++++---- 3 files changed, 19 insertions(+), 8 deletions(-) diff --git a/com.wudsn.ide.lng/help/ide-faq.section.html b/com.wudsn.ide.lng/help/ide-faq.section.html index 90918e10..87b126af 100644 --- a/com.wudsn.ide.lng/help/ide-faq.section.html +++ b/com.wudsn.ide.lng/help/ide-faq.section.html @@ -11,6 +11,7 @@
  • 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?
  • How do I use Eclipse?
  • Why is the "Assembler" section not visible in the preferences?
    • +
  • How do I select the translation for the menus and messages?
  • Configuration @@ -86,6 +87,10 @@

    Why is the "Assembler" section not visible in the preferences?

    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 out of maintenance since 2013/02. 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.

    +
    +

    How do I select the translation for the menus and messages?

    +

    The WUDSN IDE installer installs English and German translations for Eclipse and WUDSN IDE by default. When you start WUDSN IDE, the translation for the primary language of your operating system is used. Use can override this selection by setting the environment variable "WUDSN_LANGUAGE" to "en" "de".

    +

    Configuration

    Why do I see wrong messages in the "Problems" view?

    @@ -99,7 +104,6 @@

    Why must I put ";@com.wudsn.ide.lng.hardware=..." in the source file?

    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.

    -

    Editing

    Why is editing sometimes slow, or is everything blocked, showing the wait cursor?

    @@ -149,7 +153,7 @@

    Building

    Why is MADS the primary assembler?

    -

    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.

    +

    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 potent 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.

    Why do I get the error "No ORG defined" when compiling the example from the tutorial?

    @@ -214,5 +218,4 @@

    How can I use other emulators?

    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.

    -
    - +
    \ No newline at end of file diff --git a/com.wudsn.ide.lng/help/ide-features.section.html b/com.wudsn.ide.lng/help/ide-features.section.html index 97aae6e4..4994834d 100644 --- a/com.wudsn.ide.lng/help/ide-features.section.html +++ b/com.wudsn.ide.lng/help/ide-features.section.html @@ -15,6 +15,7 @@
    General IDE Enhancements
      +
    • The environment variable "WUDSN_LANGUAGE" can be set to "en" or "de" to override the default locale of the IDE used for all menu and message texts.
    • The "Open Folder" context menu is available for all folders and files.
    • The "Sort" context menu with sub-menu is available for all text files, including
        diff --git a/com.wudsn.ide.lng/help/ide-installation.section.html b/com.wudsn.ide.lng/help/ide-installation.section.html index 24863d28..4534b296 100644 --- a/com.wudsn.ide.lng/help/ide-installation.section.html +++ b/com.wudsn.ide.lng/help/ide-installation.section.html @@ -24,6 +24,7 @@
      Installing WUDSN IDE
        +
        • Start Eclipse
        • Select the entry "Install New Software..." from the menu "Help".
        • Enter "https://www.wudsn.com/update/stable" in the "Work with" field and press ENTER.
          • @@ -32,8 +33,14 @@
        • Read the license agreement, choose "I accept..." and press the " Finish " button.
        • If you get a security warning that the content is unsigned, confirm the alert by pressing the " OK " button.
        • When prompted to restart Eclipse now, press the " Yes " button.
          • -
        • As always, with updates, the update may fail for whatever reason, or the installed version has severe issues. For example, the required Java version might not be available on your machine. In this case, uninstall it via the link "What is already installed" in the "Install New Software..." dialog and restart the IDE. Then, you can reinstall the latest version from "https://www.wudsn.com/update/stable" or previously released versions from the locations listed on the Releases page.
          IDE installation steps
          • +
        • Updates may fail for whatever reason, or the installed version has severe issues. For example, the required Java version might not be available on your machine. In this case, uninstall it via the link "What is already installed" in the "Install New Software..." dialog and restart the IDE. Then, you can reinstall the latest version from "https://www.wudsn.com/update/stable" or previously released versions from the locations listed on the Releases page.
          IDE installation steps
        +
      +
      Installing Language Packs
      +
        +
          The Eclipse runtime is, by default, installed with the English language pack. Additional language packs can be downloaded from
        +
      +

      . The WUDSN IDE plugin contains English and German translations. The WUDSN IDE installer automatically installs the German Language Pack for Eclipse. This way, English and German translations are always complete in an installation.

      Installing Assemblers and Compilers like ATASM, MADS, XASM...
      • Start Eclipse
        • @@ -107,10 +114,10 @@
      • The default parameters are used if no explicit assembler/compiler parameters are specified.
      • The default parameters are ignored if explicit assembler/compiler parameters are specified.
      • The absolute path to the source file replaces the variable "${sourceFilePath}".
        The absolute path to the output file replaces the variable "${outputFilePath}".
        For more variables, see the "Preferences for assembling and compiling" section on the "Features" page.
        • -
      • Choose to use the source or temporary folders as the output folder.
        • +
      • Choose the source or temporary folders as the output folder.
      • Choose the file extension for the output file, for example, ".xex" or ".bin".
      • Press the button "OK".
        • -
      • All values are reset using the "Restore Defaults" button, except for the paths to the assembler/compilers.

        Configuration of aseembler / compiler executable path
        • +
      • All values are reset using the "Restore Defaults" button, except for the paths to the assembler/compilers.

        Configuration of assembler / compiler executable path
      • Using the button "Default" in the "File Associations" preferences, you can set the default editor for a file extension, for example, "MADS" for "*.asm".
        IDE file associations
      Installing Altirra, Atari800, and other emulators
      @@ -133,7 +140,7 @@
    • Press the button "OK".
    • If you also need the Atari ROM files, you can find them in the file PCXF380.ZIP, which is available at http://www.emulators.com.Configuration of emulator executable path
    -
    Creating and Building the Example project
    +
    Creating and Building the Example Project
    • Start Eclipse.
    • Select the entry "New/Project" from the menu "File".