1 # tools/ directory

     2 

     3 This directory contains various tools for HW development.

     4 

     5 To learn more about each individual tool, open its source file in a text editor,

     6 it often contains a brief comment at the top.

     7 

     8 ## List of tools (excerpt)

     9 

    10 ### Files

    11 * `update_locale_files.sh`: Update locale files

    12 * `hwmap2lua.sh`: Convert HWMAP files to Lua code for usage in missions

    13 * `create_dmg.sh`: Generate a .dmg file (relevant for Mac)

    14 * `dmg_pkg_install.sh`: Downloads and install a .dmg from a URL (relevant for Mac)

    15 * `docgen.sh`: Generate QTfrontend documentation with Doxygen (it's not very good)

    16 

    17 ### Directories

    18 * `hwmapconverter`: C++ application to edit HWMAP files in text form

    19 * `pas2c`: Pascal-to-C rewriter. Used when hwengine is built as C application with `BUILD_ENGINE_C=1`

    20 * `old`: Very outdated stuff that needs re-examination and possibly deletion