diff options
author | cos <cos> | 2013-05-19 16:11:32 +0200 |
---|---|---|
committer | cos <cos> | 2013-05-19 16:11:32 +0200 |
commit | cd481a01174468188d23b9d544cb738471c7fb52 (patch) | |
tree | f84d9595128f5542a8a1b83d8a65ad7fcd1bc183 /README.developers | |
parent | 43ad739ad0bc13c4be46ca1982a41acaa8b106a5 (diff) | |
download | ratpoison-cr/implement_gnumber_uglyhack.zip |
Obsoleted branch.cr/implement_gnumber_uglyhack
Please look at cr/implement_gnumber_hack instead.
Diffstat (limited to 'README.developers')
-rw-r--r-- | README.developers | 57 |
1 files changed, 0 insertions, 57 deletions
diff --git a/README.developers b/README.developers deleted file mode 100644 index 887db45..0000000 --- a/README.developers +++ /dev/null @@ -1,57 +0,0 @@ --*- outline -*- - -This file is intented to give people who would like to modify -ratpoison an idea the utility functions I've built up in ratpoison and -the structure of the code. - -* Utility Functions - -** String Manipulation - -String manipulation is something C is seriously lacking, and something -everyone does all the time. When writing ratpoison code, you SHOULD -NOT be malloc'ing temporary string buffers then using strcat, strcpy, -etc to patch strings together. The following structures and functions -should give you just about everything you need. - -If there's something you want to do but can't with the following -utils, then you should consider adding that functionality (Don't just -hack it!) to them. Chances are, someone else will want to do it too. - -*** struct sbuf -When you need to build a string by concating a bunch together or some -messy frankensteinish string manipulation sbuf is nice to use. It -handles all the memory allocation and you just say what you want to do -with the sbuf_* commands. See sbuf.h. - -*** char *xstrdup(char *) -If you need to copy a string, use this. - -*** char *xsprintf (char *fmt, ...) If you need to printf something -into a string, don't go xmalloc'ing strlen(s)+20. Use xsprintf, it -returns a new string, which you need to free when you're -done. Guaranteed. - -*** char *xvsprintf (char *fmt, va_list ap) -This is just like xsprintf except it takes a va_list argument. - -*** str_comp (char *s1, char *s2, int len) -Just like strncmp, except that it's case-insensitive. - -** Memory - -*** xmalloc and xrealloc -These functions are exactly like malloc and realloc, but they will -NEVER return NULL. - -** Lists -Ratpoison has taken a double-linked list implementation from the Linux -kernel. Look at linkedlist.h. For an example of how to use it...read -the source! - -* Coding Style - -Ratpoison follows the GNU coding style as described in the GNU Coding -Standards Document (http://www.gnu.org/prep/standards.html). If you -see something not compliant with the GNU Standard, fix it and send me -a patch! |