diff --git a/share/doc/HACKING b/share/doc/HACKING deleted file mode 100644 index 5d68d0df..00000000 --- a/share/doc/HACKING +++ /dev/null @@ -1,51 +0,0 @@ -Just some tips if you're going to help with HexChat code (patches etc): - -* Use tabs, not spaces, to indent code. - -* Use a tab size of 3 (most editors will let you choose this). - Type :set ts=3 in vim/gvim. - -* Try to stick to the same consistant coding style: - -void -routine (void) -{ - if (function (a, b, c)) - { - x = a + 1; - } -} - - (vertically aligned braces, a space after if, while, functions etc). - -* Don't use "//" C++ style comments, some compilers don't like them. - -* When opening a file with unix level functions (open, read/write, close) - as opposed to the C-level functions (fopen, fwrite/fread, fclose), use - the OFLAGS macro. This makes sure it'll work on Win32 aswell as unix e.g: - - fh = open ("file", OFLAGS | O_RDONLY); - -* Use closesocket() for sockets, and close() for normal files. - -* Don't read() from sockets, instead use recv(). - -* Please provide unified format diffs (run diff -u). - -* Call your patch something more meaningfull than hexchat.diff (I get a - million of these files!). - -* To make a really nice and clean patch, do something like this: - -Have two directories, unpacked from the original archive: -hexchat-2.0.0/ -hexchat-2.0.0p1/ -Then edit/compile the hexchat-2.0.0p1 directory. When you're done, make -a patch with: - -cd hexchat-2.0.0p1 -make distclean -cd .. -diff -urN hexchat-2.0.0 hexchat-2.0.0p1 > hexchat-something.diff - -If using nmake (Windows) replace "make distclean" with "nmake -f makefile.msc clean" diff --git a/share/doc/hacking.md b/share/doc/hacking.md new file mode 100644 index 00000000..bf060531 --- /dev/null +++ b/share/doc/hacking.md @@ -0,0 +1,59 @@ +# HexChat Hacking Guidelines + +Just some tips if you're going to help with HexChat code (patches etc): + +* Use tabs, not spaces, to indent code. + +* Use a tab size of 3 (most editors will let you choose this). + Type :set ts=3 in vim/gvim. + +* Try to stick to the same consistant coding style: + +
void
+routine (void)
+{
+	if (function (a, b, c))
+	{
+		x = a + 1;
+	}
+}
+ + (vertically aligned braces, a space after if, while, functions etc). + +* Don't use "//" C++ style comments, some compilers don't like them. + +* When opening a file with Unix level functions (open, read/write, close) + as opposed to the C level functions (fopen, fwrite/fread, fclose), use + the OFLAGS macro. This makes sure it'll work on Win32 aswell as Unix e.g.: + +
fh = open ("file", OFLAGS | O_RDONLY);
+ +* Use closesocket() for sockets, and close() for normal files. + +* Don't read() from sockets, use recv() instead. + +* Please provide unified format diffs (run diff -u). + +* Call your patch something more meaningfull than hexchat.diff. + +* To make a really nice and clean patch, do something like this: + + * Have two directories, unpacked from the original archive: + +
hexchat-2.9.0/
+		hexchat-2.9.0p1/
+ + * Then edit/compile the hexchat-2.9.0p1 directory. To create a patch: + + * Windows: + +
rmdir /q /s hexchat-2.9.0p1/win32/build
+			rmdir /q /s hexchat-2.9.0p1/win32/build-xp
+			diff -ruN --strip-trailing-cr hexchat-2.9.0 hexchat-2.9.0p1 > hexchat-something.diff
+			
+ + * Unix: + +
diff -ruN hexchat-2.9.0 hexchat-2.9.0p1 > hexchat-something.diff
+ +