0. В этом файле описывается использование Doj's projects репозитория.

1. Зарезервировано.

2. Зарезервировано.

3. Документация на стандарт описания Makefile'ов.

  3.1 Каждая директория должна содержать стандартный Makefile.node, а каждый
      Makefile должен при помощи include подключать его в себя. Это создаёт
      все стандартные цели, определяет корневые директории.

  3.2 Поведение стандартных целей в проекте.

    make [COMPILE_MIDE=debug|release] build
    make release
    make debug
      Скомпилировать проект

    make COMPILE_MODE=debug|release   clean
      Очистить собранные файлы текущей директории или все собранные файлы.

    make [COMPILE_MIDE=debug|release] test
      Запустить тесты текущей директории.
      Если все тесты прошли успешно, то вызов не должен ничего напечатать
      в консоль и должен вернуть код 0.
      В противном случае должны быть выданы diff'ы ошибочных тестов, а
      скрипт — выйти с ошибкой.
      Про тесты подробней написано в 5.

    make ci
      Надстройка над svn commit или TortoiseSVN commit (в windows).

    make up
      Надстройка над svn update или TortoiseSVN update (в windows).

    make vim
      Надстройка над [g]vim -S Session.vim

4. Ресурсы (в разработке)

  Ресурсы хранятся на хостах в шарах, их можно получать простым способом,
  например через rsync/ssh.

  project_dir   — директория до проекта, в который нужно скачать ресурс
  resource_name — имя ресурса
  branch_name   — имя бранча с ресурсом (по умолчанию используется trunk)
  host::share   — условное название хоста и шары с ресурсами

  Искомый ресурс физически должен хранится в
    host::share/branch_name/project_dir/resource_name

  Также нужен файл с таймстемпом последнего обновления
    host::share/branch_name/timestamp

  Возможные действия:
    1) Положить новый ресурс, делается это выкладыванием файла в шару и
		   touch host::share/branch_name/timestamp
    2) Добавить закачку ресурса в проекте, это прописывается в Makefile

  Предположительный синтаксис скачивания (по мере убывания важности параметров):
    $(eval $(call FETCH_RESOURCE, build_mode, resource_name, branch_name, host::share, project_dir))

  Нужна глобальная переменная для перечисления требуемых ресурсов
    EXTERNAL_RESOURCES = resource_name1 \
        resource_name2->project_name \
        host::share/trunk/resource_name3->otherproject_name

  Эта переменная определяет что будет скачивать таргет download-resources

  Они будут автоматически выкачиваться в build целях. При этом в build
	директорию будет сохранятся некоторый .fetch-файл с информацией о скачке.
  Синтаксис будет изменён позже с заменой его во всех Makefile'ах.

  (УСТАРЕВШАЯ ЧАСТЬ)
  Все неверсионные бинарные ресурсы должны храниться на внешнем сервере и
  подкачиваться при необходимости. Пока что в качестве внешнего сервера
  используется http-сервер с хранилищем файлов.

    $(eval $(call FETCH_RESOURCE, name   [, where]))
    TODO $(eval $(call FETCH_RESOURCE, id/xxx [, where]))
      Объявляет правило для скачивания ресурса с именем name в директорию where.

	  TODO Если имя начинается с id, то используется идентификатор ресурса.

      Если where не указано, то скачивает ресурс в директорию $(RESOURCE).
	  По умолчанию RESOURCE содержит путь до директории resource в корне.
      Если where указано, то оно создаёт относительный путь в директории.

      TODO Архивы автоматически разорхивировываются и превращаются в директории.

      Автоматически будет создан файл where/name.fetch, его можно использовать
      в качестве зависимости в тех правилах, где необходим ресурс.

      Пример типичного использования:

      $(eval $(call FETCH_RESOURCE,hello.txt))
      sometarget : $(RESOURCE)/hello.txt.fetch
          cat $(RESOURCE)/hello.txt

5. Написание регрессионных тестов

   1. Если для какой-то определённой программы или библиотеки нужно написать
      специальные тесты, они размещаются в поддиректории tests.
      Далее в Makefile программы прописывается:
        test : test-subdir;

      В подпапке tests тестовый сценарий описывается по обычным правилам.

   2. Если в качестве теста нужно проверять собираемость программы в винде,
      то используется цель windows_build_test
        test : windows_build_test;

   3. Если требуется написать регрессионные тесты, то цель описывается как
        test : regressiontest

6. Написание юнит-тестов

   1. Юнит-тесты принципиально не отличаются от регрессионных тестов.

   2. Для подключения юнит-тестов в паскале, нужно подключить в начале
      программы модуль metapascal.m4. Все функции объявлены в файле unit.m4

	  UT_ADD(Name)       добавить тестирующую процедуру
	  UT_PROCEDURE(Name) объявить процедуру и добавить её в тестирующие
	  UT_BEGIN           начало процедуры (begin) и печать информации о старте
	  UT_END             печать информации об окончании и конец процедуры (end)
	  UT_EOF             окончание файла с юнит-тестами
	  UT_COND(Cond)      проверить условие и если оно не верно, то распечатать
                         об этом и выйти из программы с ошибкой
