summaryrefslogtreecommitdiff
path: root/HACKING
blob: 6c50ce4e3399571f1bc9580cdd6fc0277c6cb092 (plain)
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
37
38
39
40
41
HACKING

DISCLAIMER: We realise the code doesn't necessarily follow all the rules.
This is an attempt to establish a standard coding style for future
development.

Coding style guidelines
-----------------------
Column width: 79 columns or less within reason.

Indentation: tabs (standard eight column width)
Please don't add any mode lines. Adjust your editor to display tabs to your
preferred width. Generally code should work with the standard eight column
tabs.

PHP
---
No short open tags. '<?'
Do not end files with a close tag. '?>'
Try embedding as little HTML in the PHP as possible.
Consider creating templates for HTML.

MySQL queries should generally go into functions.

Submitting patches
------------------
Please test your patches before submitting.
Submit uncompressed git-formatted patches to aur-dev@archlinux.org.
Base your patches on the master branch as forward development is done there.
When writing patches please keep unnecessary changes to a minimum.
Smaller patches are much easier to review and have a better chance of being
pushed more quickly into the main repo.

Try to make your commit messages brief but descriptive.

Glossary
--------
git-formatted patch:
	A patch that is produced via `git format-patch` and is sent via
	`git send-email` or as an inline attachment of an email.