File: debugging.md

package info (click to toggle)
rust-ognibuild 0.2.5-4
  • links: PTS, VCS
  • area: main
  • in suites:
  • size: 1,676 kB
  • sloc: makefile: 17
file content (36 lines) | stat: -rw-r--r-- 1,274 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
# Debugging

Hopefully ognibuild just Does The Right Thing™, but sometimes it doesn't. Here
are some tips for debugging.

## Detecting dependencies

If you're trying to build a project and it's failing, it might be because
ognibuild is missing a dependency. You can use ``ogni info``
to see what dependencies ognibuild thinks are missing.

## Log file parsing

If a build fails, ognibuild will attempt to parse the log file with
[buildlog-consultant](https://github.com/jelmer/buildlog-consultant)
to try to find out how to fix the build. If you think it's not doing a good job,
you can run buildlog-consultant manually on the log file, and then
possibly file a bug against buildlog-consultant.

## Failure to build

If onibuild fails to determine how to build a project, it will print out
an error message. If you think it should be able to build the project,
please file a bug.

## Reporting bugs

If you think you've found a bug in ognibuild, please report it! You can do so
on GitHub at https://github.com/jelmer/ognibuild/issues/new

If ognibuild crashed, please include the backtrace with
``RUST_BACKTRACE=full`` set.

If it is possible to reproduce the bug on a particular
open source project, please include the URL of that project,
and the exact command you ran.