File: HACKING

package info (click to toggle)
winwrangler 0.2.4-5
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, buster, jessie, jessie-kfreebsd, sid, stretch
  • size: 1,612 kB
  • ctags: 169
  • sloc: sh: 10,265; ansic: 935; makefile: 96
file content (33 lines) | stat: -rw-r--r-- 1,398 bytes parent folder | download | duplicates (2)
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
HACKING WinWrangler
-------------------

Design Ideas:
Ww is very much a KIS (Keep It Simple) project. While it is tempting to
add a daemon with a dbus interface (or simple socket protocol) to trigger
the available layouts, this should not be done. Ww should be kept minimal.

While we should keep the code base simple individual layout (see Terminology 
below) implementations can be however complex they like.

We stick to the EWMH (Extended Window Manager Hints) standard to ensure maximum
compatibility among platforms. To this end libwnck is used over direct X
communications.

Code Terminology:
A 'layout' is a function that performs the actual laying out of windows.


Adding a New Layout:
Implement a WwLayoutHandler as defined in winwrangler.h and add a declaration
in ww-layouts.h and a description in ww-layouts.c. Each layout should be
in a separate file called ww-layout-<name>.c.

Hints for Ubuntu PPA Uploads:
 * First rename the release tarball to winwrangler_VERSION.orig.tar.gz
   and unpack it.
 * Then update debian/changelog, formatting the timestamp with 'date -R'.
 * Run 'debuild -S' from inside the unpacked winwrangler-VERSION dir
 * Just outside the winwrangler-VERSION dir, next to the .orig tarball run
   'dput [dput-target] winwrangler_VERSION-ppa1_source.changes'. You only need
   to set the dput-target if you haven't configured dput to use your PPA
   by default