4.5.5. Zasady obowi�zuj�ce przy modyfikowaniu plik�w biblioteki

Podczas modyfikowania plik�w biblioteki nale�y pami�ta� o nast�puj�cych zasadach:

• Przed dokonaniem zmiany nale�y poinformowa� wszystkie osoby pracuj�ce z drzewem programy o ch�ci jej dokonania. Po zako�czeniu modyfikowania biblioteki i przes�aniu do repozytorium SVN jej najnowszej wersji, r�wnie� nale�y poinformowa� wszystkich zainteresowanych, �e modyfikacje zosta�y zako�czone. Taka procedura ma na celu unikni�cie konflikt�w, kt�re mog�yby wyst�pi�, je�li dwie osoby jednocze�nie modyfikowa�yby ten sam fragment biblioteki. Zapobiega to r�wnie� przypadkowemu wykorzystaniu wersji biblioteki zawieraj�cej b��d podczas jego poprawiania.

• Tworzenie nowych kompilacji biblioteki i nowych wersji biblioteki powinno przebiega� wed�ug ustalonych zasad (opis: Sekcja 4.5.3). Wa�ne jest tak�e, aby nie tworzy� nowych wersji biblioteki wtedy, kiedy nowa kompilacja by�aby zgodna z przyj�tymi zasadami - ma to zapobiec tworzeniu du�ej ilo�ci zb�dnych katalog�w w drzewie programy.

• Po stworzeniu nowej wersji biblioteki nale�y zadba�, aby w katalogu z now� wersj� znajdowa� si� pusty plik prog.log oraz plik lib.log zawieraj�cy jedynie wpis informuj�cy o powstaniu nowej wersji biblioteki i ewentualnie o zmianach w niej wprowadzonych.

• Przy dodawaniu nowych funkcji do biblioteki nale�y pami�ta�, aby opatrzy� je klamr� dyrektyw:

  #ifdef WANT_NAZWA_FUNKCJI
      ...
  #endif

  Je�li dana funkcja korzysta z innych funkcji bibliotecznych, to nale�y r�wnie� pami�ta�, aby na samym pocz�tku danego pliku biblioteki umie�ci� deklaracj� zale�no�ci mi�dzy tymi funkcjami w postaci:

  #ifdef WANT_NAZWA_FUNKCJI
  #define WANT_FUNKCJA_1
  #define WANT_FUNKCJA_2
      ...
  #define WANT_FUNKCJA_N
  #endif