|author||Olli Salli <email@example.com>||2008-01-12 12:49:31 +0000|
|committer||Olli Salli <firstname.lastname@example.org>||2008-01-12 12:49:31 +0000|
Add HACKING file
Diffstat (limited to 'HACKING')
1 files changed, 70 insertions, 0 deletions
diff --git a/HACKING b/HACKING
new file mode 100644
@@ -0,0 +1,70 @@
+To compile telepathy-idle from darcs source, you need:
+- GNU autoconf
+- GNU automake
+- GNU libtool
+additionally, as when compiling a idle release, you need these libraries:
+and obviously, a working C compiler and make.
+Run autogen.sh in the telepathy-idle source root to create and run the
+"configure" script, which creates necessary Makefiles for compiling
+and installing telepathy-idle. Finally, run make.
+telepathy-idle is maintained in a Darcs repository at
+Patches for telepathy-idle are welcome. The recommended way to submit them is to
+file a bug at
+with the product "Telepathy" and component "telepathy-idle" and include a URL to
+a Darcs branch with your patches, or if this is not possible, attach a patch
+file produced by diff -unr.
+All patches for telepathy-idle should follow a coding style defined as follows:
+- Function names are lower_case, words separated by underscores
+- Type names are CamelCase, with no additional word separators
+- Macro names are ALL_UPPER_CASE, words separated by underscores
+- Indent with a single tab per indentation level
+- Control keywords (if, for, while, switch) have a single space between them and
+the opening paren
+- Function calls have no space between the function name and the opening paren
+- Opening braces on the same line
+- Public interface functions of classes should be namespaced properly (ie.
+ IdleConnection::send() -> idle_connection_send())
+- Don't hard-break lines, but break very long lines at logical breakpoints using
+- Follow the usual GLib conventions regarding eg. GError usage.
+Idle trunk code should more or less follow these rules, but due to historical
+reasons some inconsistency in formatting might have survived. All new code
+should be written in this way though.