Difference between revisions of "DebugIni"

From AwasuWiki
Jump to: navigation, search
m (Updated some links.)
 
Line 1: Line 1:
Sometimes you will be advised to create a file called <tt>DEBUG.INI</tt> that contains settings to control hidden features of Awasu. This file should be created in your user's [http://www.awasu.com/help/2.3/goto.php?url=Appendix/02-FileLayout.html local data directory].
+
Sometimes you will be advised to create a file called <tt>DEBUG.INI</tt> that contains settings to control hidden features of Awasu. This file should be created in your user's [https://awasu.com/help/3.1/goto.php?url=Appendix/02-FileLayout.html local data directory].
  
 
Very occasionally, you will be asked to create a <tt>DEBUG.INI</tt> file in the Awasu installation directory (e.g. <tt>C:\Program Files\Awasu\</tt>, if you have installed to the default location).
 
Very occasionally, you will be asked to create a <tt>DEBUG.INI</tt> file in the Awasu installation directory (e.g. <tt>C:\Program Files\Awasu\</tt>, if you have installed to the default location).
Line 12: Line 12:
 
     Startup=1
 
     Startup=1
 
</pre>
 
</pre>
Run Awasu and check the <tt>Awasu.log</tt> file in your user's [http://www.awasu.com/help/2.3/goto.php?url=Appendix/02-FileLayout.html Logs sub-directory] - it should contain a series of messages describing what Awasu is doing as it starts up.
+
Run Awasu and check the <tt>Awasu.log</tt> file in your user's [https://awasu.com/help/3.1/goto.php?url=Appendix/02-FileLayout.html Logs sub-directory] - it should contain a series of messages describing what Awasu is doing as it starts up.
 
</em></small>
 
</em></small>
  

Latest revision as of 09:50, 28 July 2017

Sometimes you will be advised to create a file called DEBUG.INI that contains settings to control hidden features of Awasu. This file should be created in your user's local data directory.

Very occasionally, you will be asked to create a DEBUG.INI file in the Awasu installation directory (e.g. C:\Program Files\Awasu\, if you have installed to the default location).

Creating the DEBUG.INI file

To create this file, start Notepad and enter the settings that you have been advised to make. Then choose File|Save As to save the file to the appropriate location. Of course, if you already have a DEBUG.INI file, just open it (File|Open) and make the necessary changes (see next section).

If you need to create the file in your local data directory and you want to check you've put it in the right place, add the following lines to the file (using the rules described below):

    [MessageLog]
    Startup=1

Run Awasu and check the Awasu.log file in your user's Logs sub-directory - it should contain a series of messages describing what Awasu is doing as it starts up.

Managing the DEBUG.INI file

DEBUG.INI files are divided into sections, where each new section starts with a line enclosed in square brackets e.g. [Debug]. If you need to make several changes to your DEBUG.INI file, you should combine all the settings so that they live in the one section. So, for example, if you are advised to make the following change to your DEBUG.INI file:

[Debug]
TheAnswer=42

and then later are also advised to add the following:

[Debug]
foo=bar

then your final DEBUG.INI file should look like this:

[Debug]
TheAnswer=42
foo=bar

The order in which settings appear is not important.