bdk-blender/tools/readme.rst
Sergey Sharybin 03806d0b67 Re-design of submodules used in blender.git
This commit implements described in the #104573.

The goal is to fix the confusion of the submodule hashes change, which are not
ideal for any of the supported git-module configuration (they are either always
visible causing confusion, or silently staged and committed, also causing
confusion).

This commit replaces submodules with a checkout of addons and addons_contrib,
covered by the .gitignore, and locale and developer tools are moved to the
main repository.

This also changes the paths:
- /release/scripts are moved to the /scripts
- /source/tools are moved to the /tools
- /release/datafiles/locale is moved to /locale

This is done to avoid conflicts when using bisect, and also allow buildbot to
automatically "recover" wgen building older or newer branches/patches.

Running `make update` will initialize the local checkout to the changed
repository configuration.

Another aspect of the change is that the make update will support Github style
of remote organization (origin remote pointing to thy fork, upstream remote
pointing to the upstream blender/blender.git).

Pull Request #104755
2023-02-21 16:39:58 +01:00

1.2 KiB
Raw Permalink Blame History

Blender Dev Tools

This repository is intended for miscellaneous tools, utilities, configurations and anything that helps with Blender development, but arent directly related to building Blender.

Some of the tools included may be used stand-alone, others expect Blenders source code to be available.

Usage

While this is a stand-alone repository, some of the scripts which access Blenders source code assume this repository will be located at tools within Blenders source code repository. At some point this may be included as a submodule.

Some tools also rely on the blender binary, this is assumed to be located at: ../../blender.bin. The root directory of Blenders git repository

Categories

Check Source

Any tools for scanning source files to report issues with code, style, conventions, deprecated features etc.

Config

Configuration for 3rd party applications (IDEs, code-analysis, debugging tools… etc).

Git

Scripts and utilities for working with git.

Utils

Programs (scripts) to help with development (currently for converting formats, creating mouse cursor, updating themes).