Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
ru:develop:guidelines [2014/06/21 20:51] – [Documentation] valerius2k | ru:develop:guidelines [2018/08/17 14:28] – [Глобальные/Общие/Приватные файлы заголовков] valerius | ||
---|---|---|---|
Line 24: | Line 24: | ||
* [[http:// | * [[http:// | ||
- | Вы можете [[ru: | + | Вы можете [[ru: |
Перед сборкой проверьте файлы setvars-< | Перед сборкой проверьте файлы setvars-< | ||
Line 38: | Line 38: | ||
==== Дерево каталогов ==== | ==== Дерево каталогов ==== | ||
- | Посмотрите на код в SVN, для понимания принципа размещения файлов. Обратите внимание, | + | Посмотрите на код в Git-репозитории, для понимания принципа размещения файлов. Обратите внимание, |
==== Глобальные/ | ==== Глобальные/ | ||
- | Каждый уровень дерева | + | Каждый уровень дерева |
|// | |// | ||
Line 77: | Line 77: | ||
* Приватный код (не разделяемый ни с каким другим кодом) должен быть документирован только внутри исходника. | * Приватный код (не разделяемый ни с каким другим кодом) должен быть документирован только внутри исходника. | ||
- | * Разделяемый код (разделяемый на одном уровне, | + | * Разделяемый код (разделяемый на одном уровне, |
* ОС API и документация к утилитам тулкита НЕ должна находиться в дереве исходников, | * ОС API и документация к утилитам тулкита НЕ должна находиться в дереве исходников, | ||
* Исходный код должен быть документирован в нем самом (но не во включаемых файлах). | * Исходный код должен быть документирован в нем самом (но не во включаемых файлах). | ||
Line 83: | Line 83: | ||
* Размещайте комментарии в исходном коде таким образом, | * Размещайте комментарии в исходном коде таким образом, | ||
- | ==== When Developing | + | ==== В процессе разработки |
- | * Use static linking, do not use dynamic libraries | + | * Используйте статическую линковку, не используйте динамических библиотек |
- | * Use the makefiles provided with the source tree, don' | + | * Пользуйтесь мейкфайлами из дерева исходников, не изобретайте свои собственные |
- | * Currently | + | * На текущий момент разработка |
- | * We use SVN to share code among developers. | + | * Мы используем |
- | * We use Doxygen | + | * Мы пользуемся |
- | ==== Submitting a Patch (FIX THIS!!!) ==== | + | ==== Присылая патчи с исправлениями |
- | * Make sure your changes follow the coding guidelines above. | + | * Убедитесь, |
- | * Make sure you are using the current versions of the sources so that the resulting diffs are comparing your changes with the head of the source tree. | + | * Убедитесь, |
- | * Create your patch either by using cvs diff -u (if you are using CVS) or diff -u original-file changed-file (if you are using a source archive - you can also create differences for the whole directory contents using diff -r) In the latter case include the old code first, the new code last – in the patch anything you added will be prefixed with a +. | + | * Создавайте ваш патч используя |
- | * Remove all/any lines that reference files without changes. | + | * Удаляйте из патча все несущественные строки. |
- | * Send the patch file as an attachment in your email. Do not paste the patch directly into the email body. | + | * Присылайте патчи в виде прикрепленного к письму файла. Не вставляйте его прямо в тело письма. |
- | * Maintainers will often reply in response to your patch, pointing out things to fix up, etc. before a patch can be checked in. Please always follow the maintainer suggestions closely and respond by sending a new corrected patch. Please do not expect the maintainers to rework your changes, you want to be able to claim all the credit for your great patches! | + | * Мейнтейнеры могут ответить вам на ваш патч, указав необходимые исправления, и др. перед тем, как патч будет принят. Всегда внимательно относитесь к замечаниям мейнтейнера и в ответ присылайте исправенные патчи. Пожалуйста, не считайте, |
~~DISCUSSION~~ | ~~DISCUSSION~~ | ||