File: development.md

package info (click to toggle)
alttab 1.7.1-5
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 3,828 kB
  • sloc: ansic: 4,263; sh: 1,825; makefile: 17
file content (50 lines) | stat: -rw-r--r-- 1,342 bytes parent folder | download | duplicates (3)
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
42
43
44
45
46
47
48
49
50

Stability
---------

Alttab is considered stable.

Repository, bug reporting
-------------------------

[On github](https://github.com/sagb/alttab).

Maintainer script
-----------------

To rebuild autotools stuff use bootstrap.sh.

Also, this script updates man page and README which are maintained 
as ronn(1) (markdown-like) file.
This is not included in makefiles to not require casual user 
to install ronn.

Coding
------

Functions return 0 on failure, positive on success.  
No strict requirements are imposed, but for the time present, the code
adheres to the following:

* Satisfy `-Wall` compiler option
* Use the following indent: `indent -nbad -bap -nbc -bbo -hnl -br -brs -c33 -cd33 -ncdb -ce -ci4 -cli0 -d0 -di1 -nfc1 -i4 -ip0 -l80 -lp -npcs -nprs -npsl -sai -saf -saw -ncs -nsc -sob -nfca -cp33 -ss -ts4 -il1 -nut`
* Pass Clang Static Analyzer check (scan-build make) without warnings, except of those about uthash internals and obvious false-positives

The only global variables are: g, dpy, scr, root, ee\_complain.

X error handler doesn't abort on error. To disable even the error message,
temporary set ee\_complain to false.

Test suite
----------

`make check` should work.

Debug
-----

On USR1 signal alttab dumps some debug information on STDERR.

/* vim:tabstop=4:shiftwidth=4:smarttab:expandtab:smartindent  
*/