Skip to content

Latest commit

 

History

History
52 lines (43 loc) · 2.18 KB

CONTRIBUTING.org

File metadata and controls

52 lines (43 loc) · 2.18 KB
Raw

Reporting issues

Before reporting a bug, please take a look at:

To understand what’s going on, we need a reproducible bug scenario. It is important that we can rule out interference with other Emacs packages or customizations, therefore use emacs -Q to bypass your init file.

This shortcut will start emacs -Q for you with ivy-mode already loaded:

git clone https://github.com/abo-abo/swiper/
cd swiper
make plain

Contributing code

The basic code style guide is to use:

(setq indent-tabs-mode nil)

It is provided for you in .dir-locals.el, please obey it.

Before submitting a change, run:

  • make compile - check for new compilation warnings
  • make test - check for failing tests
  • make checkdock - check documentation guidelines

Use your own judgment for the commit messages, I recommend a verbose style using magit-commit-add-log.

Copyright Assignment

These packages are subject to the same Copyright Assignment policy as Emacs itself, org-mode, CEDET and other packages in GNU ELPA.

Any legally significant contributions can only be accepted after the author has completed their paperwork. Please see the request form if you want to proceed with the assignment.

The copyright assignment isn’t a big deal, it just says that the copyright for your submitted changes to Emacs belongs to the FSF. This assignment works for all projects related to Emacs. To obtain it you need to:

  • send one email
  • then send one letter (if you live in the US, it’s digital)
  • wait for some time (in my case, I had to wait for one month; but recently it’s less than a week)