tools/README.md
author Wuzzy <Wuzzy2@mail.ru>
Thu, 25 Apr 2019 23:01:05 +0200
changeset 14844 e239378a9400
parent 14166 fe5bfe70c3c2
permissions -rw-r--r--
Prevent entering “/”, “\” and “:” in team and scheme names. The name of teams and schems is saved in the file name itself, so these characters would cause trouble as they are used in path names in Linux and Windows.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
13516
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
13970
fa9b22311390 Add script to check engine locale files for problems
Wuzzy <Wuzzy2@mail.ru>
parents: 13516
diff changeset
    12
* `check_engine_locale_files.sh`: Check the engine locale files for missing translations and problems
13516
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)
14094
30565866db82 Add some useful translation checker scripts for Lua
Wuzzy <Wuzzy2@mail.ru>
parents: 13970
diff changeset
    17
* `check_translations.sh`: Check most translation files for mistakes and generate a simple progress report
14166
fe5bfe70c3c2 Add nemo's script to check for outdated engine translations with some adaptations
Wuzzy <Wuzzy2@mail.ru>
parents: 14094
diff changeset
    18
* `find_outdated_engine_translations.sh`: Check for strings in engine translations that MIGHT be outdated
13516
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