Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision |
ru:develop:guidelines [2014/06/21 21:52] – [Submitting a Patch (FIX THIS!!!)] valerius2k | ru:develop:guidelines [2018/08/17 14:39] – [В процессе разработки] valerius |
---|
* [[http://regina-rexx.sf.net/]] для ReginaREXX | * [[http://regina-rexx.sf.net/]] для ReginaREXX |
| |
Вы можете [[ru:download|загрузить]] нерегулярно обновляемые снапшоты исходников с этого сайта, или самые последние версии с SVN. Исходники osFree находятся на [[http://osfree.svn.sourceforge.net/viewvc/osfree/|Sourceforge SVN]]. Sourceforge также позволяет скачать любую ревизию в виде .tar.gz архива. | Вы можете [[ru:download|загрузить]] нерегулярно обновляемые снапшоты исходников с этого сайта, или самые последние версии из Git. Исходники osFree находятся на [[https://github.com/osfree-project/osfree/|GitHub]]. GitHub также позволяет скачать любую ревизию в виде .tar.gz архива. |
| |
Перед сборкой проверьте файлы setvars-<somename>.cmd и <somename>.conf, И поменяйте настройки (в основном, пути к инструментам разработки). После этого откройте сеанс командной строки и запустите setvars-<somename>.cmd и введите | Перед сборкой проверьте файлы setvars-<somename>.cmd и <somename>.conf, И поменяйте настройки (в основном, пути к инструментам разработки). После этого откройте сеанс командной строки и запустите setvars-<somename>.cmd и введите |
==== Дерево каталогов ==== | ==== Дерево каталогов ==== |
| |
Посмотрите на код в SVN, для понимания принципа размещения файлов. Обратите внимание, что дерево файлов в SVN osFree состоит из исходных кодов операционной системы и инструментов тулкита. Пожалуйста, НЕ помещайте сюда приложения и инструменты, не соответствующие назначению тулкита. Тулкит это вспомогательные утилиты, собираемые под ту систему, под которой ведется сборка и необходимые для сборки файлов ОС. | Посмотрите на код в Git-репозитории, для понимания принципа размещения файлов. Обратите внимание, что дерево файлов в SVN osFree состоит из исходных кодов операционной системы и инструментов тулкита. Пожалуйста, НЕ помещайте сюда приложения и инструменты, не соответствующие назначению тулкита. Тулкит это вспомогательные утилиты, собираемые под ту систему, под которой ведется сборка и необходимые для сборки файлов ОС. |
| |
==== Глобальные/Общие/Приватные файлы заголовков ==== | ==== Глобальные/Общие/Приватные файлы заголовков ==== |
| |
Каждый уровень дерева SVN содержит два стандартных каталога: <code>FIX THIS! Сейчас это немного не так!</code> | Каждый уровень дерева исходных текстов содержит два стандартных каталога: <code>FIX THIS! Сейчас это немного не так!</code> |
| |
|//shared// |Содержит код, общий для данного и более глубокого уровней вложенности каталогов | | |//shared// |Содержит код, общий для данного и более глубокого уровней вложенности каталогов | |
|//include// |Содержит заголовки для всего выше перечисленного | | |//include// |Содержит заголовки для всего выше перечисленного | |
| |
Каждая часть/уровень ОС должен иметь отдельный префикс (какталог верхнего уровня), позволяющий разработчику легко найти часть ОС, к которой заголовочный/библиотечный файл принадлежит. Например, код, общий для всего дерева исходников, должен включать: | Каждая часть/уровень ОС должен иметь отдельный префикс, позволяющий разработчику легко найти часть ОС, к которой заголовочный/библиотечный файл принадлежит. Например, код, общий для всего дерева исходников, должен включать: |
| |
<code c>#include <all_shared.h></code> | <code c>#include <all_shared.h></code> |
| |
* Приватный код (не разделяемый ни с каким другим кодом) должен быть документирован только внутри исходника. | * Приватный код (не разделяемый ни с каким другим кодом) должен быть документирован только внутри исходника. |
* Разделяемый код (разделяемый на одном уровне, или же разделяемый со всеми уровнями) должен быть документирован в исходнике и в документе “[[en:develop:blddev|Разработка и сборка исходников]]”. | * Разделяемый код (разделяемый на одном уровне, или же разделяемый со всеми уровнями) должен быть документирован в исходнике и в документе “[[en:develop:bldenv|Разработка и сборка исходников]]”. |
* ОС API и документация к утилитам тулкита НЕ должна находиться в дереве исходников, а должна быть в тулките и в комплекте каждого релиза. | * ОС API и документация к утилитам тулкита НЕ должна находиться в дереве исходников, а должна быть в тулките и в комплекте каждого релиза. |
* Исходный код должен быть документирован в нем самом (но не во включаемых файлах). | * Исходный код должен быть документирован в нем самом (но не во включаемых файлах). |
* Пользуйтесь мейкфайлами из дерева исходников, не изобретайте свои собственные “велосипеды”. | * Пользуйтесь мейкфайлами из дерева исходников, не изобретайте свои собственные “велосипеды”. |
* На текущий момент разработка osFree происходит в среде OS/2 (как минимум, Warp 4), но в будущем разработка будет производиться в самой osFree ("self-hosting"). | * На текущий момент разработка osFree происходит в среде OS/2 (как минимум, Warp 4), но в будущем разработка будет производиться в самой osFree ("self-hosting"). |
* Мы используем SVN для совместной разработки. | * Мы используем Git для совместной разработки. |
* Мы пользуемся Doxygen и Wiki для документирования своей работы. | * Мы пользуемся Doxygen и Wiki для документирования своей работы. |
| |