Atomineer Pro Documentation
===========================

Due to differences in versions of Visual Studio and Atmel Studio, it is unfortunately
necessary to provide a number of different Atomineer installers. All installed versions
of Atomineer will automatically share preferences and customisations, and can safely be
installed/upgraded/uninstalled independently whenever you wish.

The installers in this zip archive are as follows:

    VS 2022-2026\AtomineerProDocumentation2022-2026.vsix
        Double click to install or update Atomineer (for Visual Studio 2022 and 2026)

    VS 2015-2019\AtomineerProDocumentation2015-2019.vsix
        Double click to install or update Atomineer (for Visual Studio 2015, 2017, and 2019)

	Double-click AtomineerSpelling (2015 or 2017-2019 as appropriate) if you also wish
	to install the optional spell checker. For details on how the spell checker works,
        please visit  https://www.atomineerutils.com/spellcheck.php

    VS 2005-2013 + Atmel 5-6\AtomineerUtilsSetup.exe (Note: frozen at v 9.49)
        Double-click to install or update Atomineer for:
            - Visual Studio 2005, 2008, 2010, 2012 & 2013
            - Atmel Studio versions 5.x and 6.x

    Atmel 7\AtomineerProDocumentation.vsix
        Double click to install or update Atomineer for Atmel Studio 7.x
        (Please note that this vsix intentionally does not have a digital
        signature for compatibility reasons)


Upgrading from a Trial version
==============================
If upgrading the 2022 or 2015-2019 version, please uninstall the trial version before
installing the full version. This will prevent it showing any spurious messages about
the expiry of your trial license.

The process is quick and easy:

* For Visual Studio 2015-2026 and Atmel 7, Atomineer must be uninstalled using the
  built-in Extension manager. In Visual Studio or Atmel, go to
  Extensions > Extension Manager (or Tools > Extensions and Updates, in older versions)
  and find the Atomineer Pro Documentation entry. Click it to select it, and an Uninstall
  button will appear - click this button and then restart Visual Studio to complete the
  process.

The installer for older versions (2005-2013) will automatically upgrade any trial version,
so in this case you do not need to uninstall first.


Common Installation Errors
==========================

    If the install fails with the error "This extension is not installable
    on any currently installed products" (in particular after installing Visual
    Studio 2017, 2019, 2022 or 2026 alongside an earlier version) then you may need to manually
    run the correct version of the VSIX installer, as follows:
          - From your Start menu, run the "Developer Command Prompt for Visual Studio 20xx"
            (where xx denotes the correct version number) or "Atmel Studio 7.0 Command Prompt"
          - Execute:
                VSIXInstaller.exe c:\AtomineerProDocumentation.vsix
            (where the parameter is the full pathname to your Atomineer installer).
            This should then use the correct VSIX installation tool to install correctly.


Other problems or questions?
============================

If you encounter any problems installing, or have any questions or suggestions, please don't
hesitate to contact us by email, including details of which product and version you are
installing into, at:

    support@atomineerutils.com

We will endeavour to reply within 24 hours, and can usually resolve any issues very quickly.

