Shallow clones cause issues with `git push --recurse-submodules=check|on-demand` such as in https://github.com/DFHack/dfhack/runs/3307192897?check_suite_focus=true: ``` The following submodule paths contain changes that can not be found on any remote: depends/luacov Please try git push --recurse-submodules=on-demand or cd to the path and use git push to push them to a remote. ``` (in this case, the changes *are* on the remote, and on-demand doesn't help) Our submodules also aren't currently very large on disk even with full clones - libexpat is the largest: 616K .git/modules/depends/clsocket 744K .git/modules/depends/luacov 924K .git/modules/depends/xlsxio 1.8M .git/modules/depends/libzip 3.7M .git/modules/depends/jsoncpp 8.2M .git/modules/depends/libexpat If a shallow clone of submodules is desired, `git clone --shallow-submodules` is still an option. |
||
|---|---|---|
| .github | ||
| CMake | ||
| build | ||
| ci | ||
| data | ||
| depends | ||
| dfhack-config | ||
| docs | ||
| library | ||
| package | ||
| plugins | ||
| scripts@f3c5cd2ba5 | ||
| test | ||
| travis | ||
| .gitignore | ||
| .gitmodules | ||
| .ycm_extra_conf.py | ||
| CMakeLists.txt | ||
| CMakeSettings.json | ||
| LICENSE.rst | ||
| README.html | ||
| README.md | ||
| conf.py | ||
| dfhack.init-example | ||
| index.rst | ||
| onLoad.init-example | ||
README.md
DFHack Readme
DFHack is a Dwarf Fortress memory access library, distributed with scripts and plugins implementing a wide variety of useful functions and tools.
The full documentation is available online here,
from the README.html page in the DFHack distribution, or as raw text in the ./docs folder.
If you're an end-user, modder, or interested in contributing to DFHack -
go read those docs.
If that's unclear or you need more help, try the Bay12 forums thread or the #dfhack IRC channel on freenode.