DesignGuidelines/ru: what changed
Revision 0 to 1. Removed lines have a minus sign; added lines have a plus sign.
Title: DesignGuidelines/ru
| Old | New | Line | |
|---|---|---|---|
| 1 | + | ## Указания по кодированию для Lazarus | |
| 2 | + | ||
| 3 | + | Стиль кодирования | |
| 4 | + | ||
| 5 | + | ||
| 6 | + | * Поскольку один стиль легче для чтения, Lazarus следует стилю, принятому для Delphi: [Object Pascal Style Guide](<http://edn.embarcadero.com/article/10280>). Конечно, почти любой найдёт там моменты, которые посчитает менее удобными для чтения, чем в других стилях. Это нормально, просто попробуйте следовать этому стилю хотя бы на 90%. В качестве примера смотрите LCL. | |
| 7 | + | * Старайтесь избегать взаимных (циклических) ссылок модулей (**uses** в секциях **implementation**). Причины: | |
| 8 | + | ||
| 9 | + | 1. FPC имеет проблемы с ними. | |
| 10 | + | 2. Это позволяет разделить модули и пакеты, когда они становятся слишком большими. | |
| 11 | + | ||
| 12 | + | * Минимизируйте количество вызовов LCL интефейсами при выполнении действия, запрошенного LCL. Интерфейсы только уведомляют LCL, не заставляя что-либо делать. Решение принимает LCL. | |
| 13 | + | * Соглашения об именовании: см. [[Nomenclature]] | |
| 14 | + | * Весь код должен работать при всех включенных проверках (range, I/O, overflow, stack). Помимо того, что это помогает отладке, некоторые пользователи устанавливают эти проверки в fpc.cfg, поэтому они применяются ко всему Lazarus, включая пакеты и примеры. | |
| 15 | + | * Имена в комментариях: Комментарии должны помогать читателю. Они - не для прославления писателя. Вы можете добавить имя, если: | |
| 16 | + | ||
| 17 | + | 1. Вы занимаетесь поддержкой, т.е. являетесь тем, кто принимает отчёты об ошибках. | |
| 18 | + | 2. Имя удобно для поисковых запросов, чтобы найти помощь по этой теме. | |
| 19 | + | ||
| 20 | + | Новые файлы | |
| 21 | + | ||
| 22 | + | ||
| 23 | + | * Каждый файл должен начинаться с заголовка, содержащего лицензию и несколько строк, описывающих содержание. | |
| 24 | + | * Исходные файлы на языке Pascal (.pas, .pp, .inc, .lfm, .lrs) должны иметь имена в нижнем регистре. Можно использовать CamelCase в именах модулей. | |
| 25 | + | ||
| 26 | + | Включаемые файлы | |
| 27 | + | ||
| 28 | + | ||
| 29 | + | * Должны начинаться директивой {%MainUnit } | |
| 30 | + | ||
| 31 | + | Пакеты | |
| 32 | + | ||
| 33 | + | ||
| 34 | + | * Должны иметь запись .lpl в packager/globallinks/ | |
| 35 | + | * Должны иметь автора, описание и лицензию | |
| 36 | + | ||
| 37 | + | Пункты главного меню | |
| 38 | + | ||
| 39 | + | ||
| 40 | + | * Должны иметь клавишу в keymapping.pp | |
| 41 | + | ||
| 42 | + | * * * | |
| 43 | + | ||
| 44 | + | _Надёжная версия может быть найдена в[svn](<http://svn.freepascal.org/svn/lazarus/trunk/docs/DesignGuidelines.txt>). Предложения по улучшению могут быть добавлены на странице обсуждения_. | |
| 45 | + | ||
| 46 | + | ### GUI | |
| 47 | + | ||
| 48 | + | См. [[GUI design guidelines]] | |
| 49 | + | ||
| 50 | + | ## См. также | |
| 51 | + | ||
| 52 | + | * [Описание стиля кодирования Delphi: Object Pascal Style Guide (Charles Calvert)](<http://edn.embarcadero.com/article/10280>) | |
| 53 | + | * Стандарт кодирования для Free Pascal (FPC) (используется для компилятора и другого кода FPC): [[Coding style/ru]] | |
| 54 | + | ||
| 55 | + | --- | |
| 56 | + | *From the Free Pascal wiki, page "DesignGuidelines/ru", as the Internet Archive kept it on 2025-03-23. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).* |