mirror of
https://cagebreak.project-repo.co/cagebreak.git
synced 2026-08-24 06:24:19 +02:00
50 lines
1.6 KiB
Markdown
50 lines
1.6 KiB
Markdown
# FAQ for Development
|
|
|
|
## How is cagebreak adjusted to a new wlroots version?
|
|
|
|
There are three steps:
|
|
|
|
1. Try to compile Cagebreak with the new wlroots.
|
|
2. Fix the compiler errors one-by-one using the wlroots
|
|
changelog for reference (https://gitlab.freedesktop.org/wlroots/wlroots/-/releases).
|
|
3. Debug until Cagebreak works again.
|
|
|
|
## How do I add a new test?
|
|
|
|
1. Add a shell script to `test/`
|
|
2. Optionally add test configs to `test/testing-configurations/`
|
|
3. Make sure the files have shebang, copyright and SPDX License identifiers
|
|
(use the other files for reference)
|
|
4. Add the test to `meson.build` as in the example below.
|
|
5. Add paths and env vars as shown in the other tests
|
|
6. Make sure the test is added to the correct suite
|
|
(check out CONTRIBUTING.md for details)
|
|
|
|
```
|
|
test('Scan-build (static analysis)', find_program('test/scan-build'), env : [ ''.join('MESONCURRENTCONFIGDIR=', meson.current_source_dir()) ], suite: 'devel-long')
|
|
```
|
|
|
|
## How do I add a new script?
|
|
|
|
1. Add a shell script to `scripts/`
|
|
2. Make sure the files have shebang, copyright and SPDX License identifiers
|
|
(use the other files for reference)
|
|
3. Add the script to CONTRIBUTING.md
|
|
4. Add the script to meson.build as shown below
|
|
|
|
```
|
|
run_target('create-sigs',
|
|
command : ['scripts/create-signatures', get_option('gpg_id')])
|
|
```
|
|
|
|
## How do I add an example script?
|
|
|
|
Extrapolate from the examples in the `example_scripts` directory.
|
|
|
|
The script should be executable with the .sh library file in the same directory.
|
|
|
|
License, contributors etc. should be appropriate.
|
|
|
|
Shellcheck must pass on any script (judicious use of shellcheck pragmas is allowed but
|
|
discouraged).
|
|
|