This is a github repository for issues and bugs related to Abinit. Users are invited to commit input files that can be used by developers to reproduce the issue, confirm the bug and work on the bug fix. Please note that the purpose of this repository is to facilitate the exchange of input files between Abinit users and developers. This repo is not meant to replace our support forum that represents the official reference to be consulted if you are encountering a problem or you need some help.
Search the forum and the github issue tracker to ensure that your issue is not a duplicate
If you think you've discovered a real bug, fork the repository and create a new issue on github (follow the instructions reported below)
Select the Issues tab
on the github interface and click the New Issue
button.
Give a meaningful Title to your post that may help us to find/remember your post easily.
Fill the sections in the issue template. Be clear and concise in your description and take advantage of GitHub Flavored Markdown
Submit the issue and take note of the issue identifier generated by github. At this point, you can add the files needed to reproduce the issue. Please follow the instruction reported in the next section.
Fork the repository on github and get a local copy with:
git clone git@github.com:YOURNAME/abinit_issues.git
Create a new directory named issue_id
where id
is the identifier associated
to the the issue you've just created on github.
Please provide whole/complete files neeeded to reproduce the error. More specifically:
config.log
file produced by configure
(if available)
or, alternatively, a file with the output of abinit -b
Add the files to the repo with git add issue_id
where issue_id
is the directory containing your file.
Commit the changes with git commit -a
and push them to github with git push
Send us a pull request on github and mention the issue on the Abinit forum (just cut&paste the github issue and put a link to it so that other users of the forum will be aware of the problem)