parę wymagań dla developerów:

1) gdy coś poprawiasz/dodajesz, zachowuj styl reszty kodu. wcięcia rób
   znakami tabulacji, a nie spacjami. stawiaj spacje po przecinkach i
   średnikach. jeśli masz inny styl, a podesłane poprawki będą dobre
   i/lub potrzebne, nie zdziw się, jeśli Twój kod zostanie przeregadowany.

2) dopisuj się do copyrightów na początku pliku. inaczej zakładam, że
   zrzekasz się praw do podesłanych kawałków kodu. oczywiście podsyłany
   kod musi być na takiej samej licencji, co reszta. w innym wypadku 
   nie trać czasu i go nie przysyłaj.

3) zachowuj przyjętą konwencję. jeśli wszystkie zmienne danej struktury
   mają nazwy typu ,,foobar_count'', nie dodawaj ,,foocount'', czy
   ,,nfoo''.

4) nie zmieniaj api bez powodu. nawet jeśli chcesz to zrobić, skonsultuj
   z resztą developerów.

5) tworząc większy kawałek/moduł/plik przeznaczony do jakiejś konkretnej
   funkcji, staraj się nazywać funkcje i zmienne tak, by było wiadomo,
   do czego służą. przykład: funkcje dotyczące list zaczynają się list_*,
   funkcje dotyczące userlisty to userlist_*, konfiguracja to config_*.

6) do alokacji pamięci używaj funkcji xmalloc(), xcalloc(), xrealloc()
   i xstrdup(). nie musisz sprawdzać zwracanej wartości. jeśli zabraknie
   pamięci, funkcje te same zajmą się grzecznym zamknięciem programu.
   dbaj o zwalnianie buforów, gdy nie są one już potrzebne.

7) jeśli nie masz pojęcia o alokacji pamięci i obsłudze stringów w C,
   najlepiej daj sobie spokój. nawet jeśli kod działa, ale nie trzyma
   się kupy, zostanie odrzucony.

8) podsyłając patche, twórz je poleceniem ,,diff -u''. diff bez parametrów
   generuje patche, które nie zawierają żadnego kontekstu i ciężko je
   dołączyć do źródła, gdy zmieniła się wcześniej chociaż jedna linijka.
   patche najlepiej generować względem najświeższej wersji, ale nie jest
   to wymagane, jeśli w międzyczasie nie było poważnych zmian w kodzie.

9) jeśli poprawka jest niewielka (jedna, dwie linijki), nie trać swojego,
   ani mojego czasu, tylko po prostu wklej oryginał i poprawioną wersję do
   treści listu.

broń Boże nie mam zamiaru się zachowywać jak jakiś Linus, i wrzucać do
źródeł tylko to, co mi się podoba, albo tylko patche ludzi, z którymi piwo
pijam. byle tylko były zachowane pewne zasady i nie było po miesiącu
burdelu w kodzie. oczywiście będę przeglądać _wszystkie_ zmiany i w razie
czego będę krzyczeć ;)

$Id: devel-hints.txt,v 1.6 2002/06/22 16:31:17 wojtekka Exp $