|
|
<!-- --- title: Submitting Issues -->
|
|
|
|
|
|
## Bug Reporting
|
|
|
[![home](/icons/home.svg "wiki home")](/home)
|
|
|
|
|
|
When [reporting a bug in OpenFOAM](https://develop.openfoam.com/Development/openfoam/issues),
|
|
|
## Bug Reporting ![bug](/icons/bug.svg "bug")
|
|
|
|
|
|
When [reporting a bug in OpenFOAM][foam-issues],
|
|
|
please provide sufficient detail for us to understand your problem.
|
|
|
This should include:
|
|
|
- OpenFOAM version
|
|
|
- Find your OpenFOAM version by running `foamVersion`.
|
|
|
- Find your OpenFOAM version by running `foamVersion` or `wmake -version`
|
|
|
- Operating system, compiler, etc.
|
|
|
- Check your installation by running `foamInstallationTest`. This will return an extended log, from which you can focus on the "Basic setup" and "Software Components" sections.
|
|
|
- Find your Linux distribution and version by running `lsb_release -a`.
|
... | ... | @@ -16,19 +18,28 @@ This should include: |
|
|
- Prepare a minimal working example, using a small mesh and just the conditions that trigger the issue, if possible.
|
|
|
- Use an official tutorial to demonstrate the problem, if possible.
|
|
|
- and, if possible, provide a suggested fix.
|
|
|
- You can prepare a patch using [git-format-patch](https://git-scm.com/docs/git-format-patch). Please use the latest state of the `develop` branch as a starting point. For example, running `git format-patch origin` will extract all the commits in your local branch but not in the remote repository.
|
|
|
- See also the pages [Code Development](page-code-development) and [Coding Style Guide](Coding-Style-Guide).
|
|
|
- You can prepare a patch using [git-format-patch](https://git-scm.com/docs/git-format-patch).
|
|
|
Please use the latest state of the `develop` branch as a starting point.
|
|
|
For example, running `git format-patch origin` will extract all the commits in your local branch but not in the remote repository.
|
|
|
- See also the pages [Code Development][code-devel] and [Coding Style Guide][code-style].
|
|
|
|
|
|
*Please do not submit issues related to general user support.*
|
|
|
These will be monitored and closed accordingly.
|
|
|
|
|
|
## Feature Requests
|
|
|
|
|
|
We are keen to hear feedback from our users and welcome
|
|
|
[feature requests](page-feature-requests)!
|
|
|
|
|
|
## General guidelines for submitting issues
|
|
|
|
|
|
- Use a title that precisely describes your issue
|
|
|
- Use [Markdown](https://docs.gitlab.com/ee/user/markdown.html) to format your message (and especially [code snippets](https://docs.gitlab.com/ee/user/markdown.html#code-spans-and-blocks))
|
|
|
- Find out more about [using the GitLab environment to create issues](https://docs.gitlab.com/ee/user/project/issues/issue_data_and_actions.html).
|
|
|
|
|
|
|
|
|
## Feature Requests
|
|
|
|
|
|
We are keen to hear feedback from our users and welcome
|
|
|
[feature requests](/page-feature-requests)!
|
|
|
|
|
|
[foam-issues]: https://develop.openfoam.com/Development/openfoam/-/issues
|
|
|
|
|
|
[code-devel]: /coding/git-workflow
|
|
|
[code-style]: /coding/style/style |