/usr/share/doc/winwrangler/HACKING is in winwrangler 0.2.4-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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
|