tools/README.md
author unC0Rr
Thu, 29 Aug 2024 15:28:20 +0200
branchtransitional_engine
changeset 16025 274a5afc2aec
parent 14161 fe5bfe70c3c2
permissions -rw-r--r--
Make pas2c engine work with hwengine-future
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
13511
b62b14aa88d4 Document and clean up tools directory a bit
Wuzzy <Wuzzy2@mail.ru>
parents:
diff changeset
     1
# tools/ directory
b62b14aa88d4 Document and clean up tools directory a bit
Wuzzy <Wuzzy2@mail.ru>
parents:
diff changeset
     2
b62b14aa88d4 Document and clean up tools directory a bit
Wuzzy <Wuzzy2@mail.ru>
parents:
diff changeset
     3
This directory contains various tools for HW development.
b62b14aa88d4 Document and clean up tools directory a bit
Wuzzy <Wuzzy2@mail.ru>
parents:
diff changeset
     4
b62b14aa88d4 Document and clean up tools directory a bit
Wuzzy <Wuzzy2@mail.ru>
parents:
diff changeset
     5
To learn more about each individual tool, open its source file in a text editor,
b62b14aa88d4 Document and clean up tools directory a bit
Wuzzy <Wuzzy2@mail.ru>
parents:
diff changeset
     6
it often contains a brief comment at the top.
b62b14aa88d4 Document and clean up tools directory a bit
Wuzzy <Wuzzy2@mail.ru>
parents:
diff changeset
     7
b62b14aa88d4 Document and clean up tools directory a bit
Wuzzy <Wuzzy2@mail.ru>
parents:
diff changeset
     8
## List of tools (excerpt)
b62b14aa88d4 Document and clean up tools directory a bit
Wuzzy <Wuzzy2@mail.ru>
parents:
diff changeset
     9
b62b14aa88d4 Document and clean up tools directory a bit
Wuzzy <Wuzzy2@mail.ru>
parents:
diff changeset
    10
### Files
b62b14aa88d4 Document and clean up tools directory a bit
Wuzzy <Wuzzy2@mail.ru>
parents:
diff changeset
    11
* `update_locale_files.sh`: Update locale files
13965
fa9b22311390 Add script to check engine locale files for problems
Wuzzy <Wuzzy2@mail.ru>
parents: 13511
diff changeset
    12
* `check_engine_locale_files.sh`: Check the engine locale files for missing translations and problems
13511
b62b14aa88d4 Document and clean up tools directory a bit
Wuzzy <Wuzzy2@mail.ru>
parents:
diff changeset
    13
* `hwmap2lua.sh`: Convert HWMAP files to Lua code for usage in missions
b62b14aa88d4 Document and clean up tools directory a bit
Wuzzy <Wuzzy2@mail.ru>
parents:
diff changeset
    14
* `create_dmg.sh`: Generate a .dmg file (relevant for Mac)
b62b14aa88d4 Document and clean up tools directory a bit
Wuzzy <Wuzzy2@mail.ru>
parents:
diff changeset
    15
* `dmg_pkg_install.sh`: Downloads and install a .dmg from a URL (relevant for Mac)
b62b14aa88d4 Document and clean up tools directory a bit
Wuzzy <Wuzzy2@mail.ru>
parents:
diff changeset
    16
* `docgen.sh`: Generate QTfrontend documentation with Doxygen (it's not very good)
14089
30565866db82 Add some useful translation checker scripts for Lua
Wuzzy <Wuzzy2@mail.ru>
parents: 13965
diff changeset
    17
* `check_translations.sh`: Check most translation files for mistakes and generate a simple progress report
14161
fe5bfe70c3c2 Add nemo's script to check for outdated engine translations with some adaptations
Wuzzy <Wuzzy2@mail.ru>
parents: 14089
diff changeset
    18
* `find_outdated_engine_translations.sh`: Check for strings in engine translations that MIGHT be outdated
13511
b62b14aa88d4 Document and clean up tools directory a bit
Wuzzy <Wuzzy2@mail.ru>
parents:
diff changeset
    19
b62b14aa88d4 Document and clean up tools directory a bit
Wuzzy <Wuzzy2@mail.ru>
parents:
diff changeset
    20
### Directories
b62b14aa88d4 Document and clean up tools directory a bit
Wuzzy <Wuzzy2@mail.ru>
parents:
diff changeset
    21
* `hwmapconverter`: C++ application to edit HWMAP files in text form
b62b14aa88d4 Document and clean up tools directory a bit
Wuzzy <Wuzzy2@mail.ru>
parents:
diff changeset
    22
* `pas2c`: Pascal-to-C rewriter. Used when hwengine is built as C application with `BUILD_ENGINE_C=1`
b62b14aa88d4 Document and clean up tools directory a bit
Wuzzy <Wuzzy2@mail.ru>
parents:
diff changeset
    23
* `old`: Very outdated stuff that needs re-examination and possibly deletion