How do I create a bug report/ru: what changed
Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.
| Old | New | Line | |
|---|---|---|---|
| 1 | 1 | Этот документ содержит некоторые рекомендации по использованию [багтрекера](https://gitlab.com/freepascal.org/) FPC/Lazarus в качестве репортера. Этот документ написан для пользователей FPC / Lazarus, которые выявляют ошибки, имеют рекомендации, хотят отправить исправления или найти другие проблемы и хотят сообщить о них команде разработчиков Lazarus. | |
| 2 | 2 | ||
| 3 | 3 | ## Ошибки компиляции кода | |
| 4 | 4 | ||
| 5 | - | ||
| 5 | + | Если у вас есть ошибки при компиляции кода из последней версии SVN, пожалуйста, свяжитесь с соответствующим [списком рассылки FPC](http://freepascal.org/maillist.var) или [списком рассылки Lazarus](http://lists.lazarus-ide.org/listinfo), или лучше присоединитесь к IRC-каналу \#fpc или \#lazarus-ide на irc.freenode.net. Тогда проблема должна решаться более оперативно. | |
| 6 | 6 | ||
| 7 | 7 | ## Вход в систему / Создание новой учетной записи | |
| 8 | 8 | ||
| 9 | 9 | Вы должны войти в систему, чтобы иметь возможность редактировать или отправлять сообщения об ошибках. Если вы вошли в систему как гость, вам необходимо сначала выйти из системы (гости не могут создавать отчеты, только просматривать их). Если у вас уже есть учетная запись, перейдите на [страницу входа](https://gitlab.com/users/sign_in), в противном случае создайте новую учетную запись на [странице регистрации](https://gitlab.com/users/sign_up). | |
| 10 | 10 | ||
| 11 | 11 | ## Проверка на наличие существующей ошибки в трекере | |
| 12 | 12 | ||
| 13 | 13 | Используйте строку поиска в [Обзоре проблем](https://gitlab.com/groups/freepascal.org/-/issues). Подсказка: поиск не является интеллектуальным; например, если у вас возникли проблемы с использованием TEdit.SelStart, выполните поиск по запросу «SelStart». | |
| 14 | 14 | ||
| 15 | 15 | Если проблема уже была опубликована: | |
| 16 | 16 | ||
| 17 | 17 | - переоткройте ее, если отчет об ошибке был решен или закрыт - используйте кнопку Reopen Issue (переоткрыть вопрос) | |
| 18 | 18 | - добавьте примечание, если вы снова воспроизвели эту ошибку в ситуации, отличной от указанной | |
| 19 | 19 | - Вы можете настроить систему для отслеживания изменений в этом отчете об ошибках - используйте кнопку Monitor Issue (отслеживание проблемы) | |
| 20 | 20 | ||
| 21 | 21 | > **Note:** Вам необходимо войти в систему для выполнения этих операций, см. раздел [[How do I create a bug report/ru|Вход в систему / Создание новой учетной записи]] | |
| 22 | 22 | ||
| 23 | 23 | ## Что следует публиковать в багтрекере? | |
| 24 | 24 | ||
| 25 | 25 | - Баги: если вы обнаружили ошибки, глюки или другие дефекты в [[FPC]] или [[Lazarus]] | |
| 26 | 26 | - Предложения: если вы нашли лучший способ сделать что-либо | |
| 27 | 27 | - Улучшения: если вы можете заставить что-то работать лучше | |
| 28 | 28 | ||
| 29 | 29 | Пожалуйста, обратите внимание: багтрекер **не** предназначен для "бытовых" вопросов. Они должны задаваться на [форуме](http://forum.lazarus.freepascal.org/). | |
| 30 | 30 | ||
| 31 | 31 | - Для создания отчета перейдите в [багтрекер Lazarus](https://gitlab.com/groups/freepascal.org/lazarus/-/issues). Вы должны быть залогированы в системе, см. раздел [[How do I create a bug report/ru|Создание новой учетной записи]]. | |
| 32 | 32 | - Перейдите на страницу [Report Issue](https://gitlab.com/groups/freepascal.org/-/issues) (Сообщить о проблеме). Заполните столько, сколько вы можете и знаете. Чем конкретнее, тем лучше. | |
| 33 | 33 | ||
| 34 | 34 | ### Баг | |
| 35 | 35 | ||
| 36 | 36 | - Важными полями являются поля ОС и программного Продукта, а также действия по воспроизведению этой проблемы. Если разработчики не смогут воспроизвести проблему, они не смогут и начать ее исправлять! Не забудьте упомянуть вашу конкретную архитектуру/конфигурацию (32- или 64-бит, с прямым(BOM-BE) или младшим(BOM-LE) порядком байтов, если оба возможны на вашей платформе, версия вашей операционной системы). | |
| 37 | - | ||
| 37 | + | - Если возможно, загрузите небольшое тестовое приложение, которое воспроизводит баг. Это, скорее всего, ускорит исправление. | |
| 38 | 38 | - Если есть какая-то графическая ошибка, полезно загрузить (частично) скриншот (в формате png или jpeg, но не в формате bmp). | |
| 39 | 39 | - Если это падение среды, попробуйте создать обратную трассировку. См. [[Creating a Backtrace with GDB/ru|создание файла обратной трассировки с помощью GDB]] для получения дополнительной информации. | |
| 40 | 40 | - Вы можете попытаться воспроизвести ошибку на как можно большем количестве различных платформ - это поможет определить, является ли это специфической проблемой виджета. | |
| 41 | 41 | - Если у вас есть возможное решение, вы можете добавить патч - см. [[Creating A Patch/ru]], который ускорит процесс. | |
| 42 | 42 | - Вы можете ускорить исправление ошибки, назначив вознаграждение, см. [[Bounties|Поощрения]]. | |
| 43 | 43 | ||
| 44 | 44 | ### Регрессия, вызванная определенной ревизией | |
| 45 | 45 | ||
| 46 | 46 | Если вы можете найти ревизию в транке, которая вызвала ошибку, пожалуйста, включите также в сообщение ее номер ревизии SVN. Отчет обычно присваивается автору этой редакции. Вы можете найти нужную ревизию с помощью "bisect"-процесса, который представляет собой двоичный поиск по ревизиям. Есть инструменты, которые помогут с этим: | |
| 47 | 47 | ||
| 48 | 48 | - Команда Git [git bisect](https://git-scm.com/docs/git-bisect). Git быстр в этой операции, потому что вся история ревизий является локальной, и ничего не нужно извлекать с сервера. | |
| 49 | 49 | - Perl-скрипт [svn-bisect](http://search.cpan.org/dist/App-SVN-Bisect/bin/svn-bisect), доступный в CPAN. Он имитирует команду "git bisect", но работает непосредственно с данными SVN. | |
| 50 | 50 | ||
| 51 | 51 | ### Предложение | |
| 52 | 52 | ||
| 53 | 53 | Объясните свою идею. Может быть полезен макет графического интерфейса или пример другого инструмента, использующего эту функцию. | |
| 54 | 54 | ||
| 55 | 55 | ### Улучшение | |
| 56 | 56 | ||
| 57 | 57 | - Если вы реализовали новую функцию в исходном коде или улучшили документацию в файлах XML, создайте патч - см. [[Creating A Patch/ru|Создание исправления]]. | |
| 58 | 58 | - Если вы улучшили перевод в языковом .po-файле, приложите весь .po-файл (а не diff). | |
| 59 | 59 | - Если у вас есть другой файл ресурса, например значок, прикрепите его к сообщению. | |
| 60 | 60 | ||
| 61 | 61 | ### Перевод сообщений на английский язык | |
| 62 | 62 | ||
| 63 | 63 | Ошибки следует описывать на английском языке. Если английским Вы владеете недостаточно хорошо, то Вы можете использовать online переводчики (например: <http://translate.google.com/>). | |
| 64 | 64 | ||
| 65 | 65 | При описании ошибки, следует указать, что Вы пользовались переводчиком: "Sorry for my English, I'm using translator" | |
| 66 | 66 | ||
| 67 | 67 | Вы так же можете попросить помощи в переводе (и не только) на этом форуме: <http://freepascal.ru> | |
| 68 | 68 | ||
| 69 | 69 | ## Вложения | |
| 70 | 70 | ||
| 71 | 71 | Если вы добавляете вложения исходного кода или примера проекта для отчета об ошибке (**настоятельно рекомендуется**, см. [[Tips on writing bug reports|Советы по написанию отчетов об ошибках]]), пожалуйста, заархивируйте их, используя предпочтительно эти форматы: | |
| 72 | 72 | ||
| 73 | 73 | - zip (.zip) | |
| 74 | 74 | - gzip (.gz) | |
| 75 | 75 | - tar.gzip (.tgz/.tar.gz) | |
| 76 | 76 | ||
| 77 | 77 | Другие форматы, такие как 7zip, Bzip и RAR, тоже подходят. В настоящее время инструменты для них легко доступны. | |
| 78 | 78 | ||
| 79 | 79 | ## Понимание Report Status(статуса сообщения) | |
| 80 | 80 | ||
| 81 | 81 | Проблема может иметь следующие состояния: | |
| 82 | 82 | ||
| 83 | 83 | - Open, but no assignee(s) (открыта, но без правопреемника(ов)): никому не поручена. | |
| 84 | 84 | - Open and 1 or more assignees (открыта и 1 или более уполномоченных): проблема была поручена одному или нескольким разработчикам Lazarus, которые попытаются исправить/реализовать ее. | |
| 85 | 85 | - Проблема имеет метку "Status: Confirmed" (Статус: Подтверждено): член команды Lazarus продублировал ошибку или согласен с тем, что функция должна быть реализована | |
| 86 | 86 | - Проблема имеет пометку "Status: Feedback"(Статус: обратная связь): репортер должен оставить отзыв, чтобы ответить на любые вопросы, заданные командой Lazarus, или подтвердить, что проблема устранена удовлетворительно. | |
| 87 | 87 | - Closed(Закрыта): правопреемник закрыл (и предположительно исправил или отклонил) проблему. | |
| 88 | 88 | ||
| 89 | 89 | ## См.также | |
| 90 | 90 | ||
| 91 | 91 | - [[Tips on writing bug reports|Советы по написанию отчетов об ошибках]] | |
| 92 | 92 | - [[Creating A Patch]] Если вы изменили исходный код для реализации решения, эта статья поможет вам наиболее эффективно добавить его в отчет об ошибках, чтобы разработчики могли как можно быстрее добавить его в основной код. | |
| 93 | 93 | - [[Database bug reporting]] Специальная информация и примеры программ для ошибок базы данных | |
| 94 | 94 | - [[Moderating the bug tracker]] | |
| 95 | 95 | - Следующая страница содержит полезные советы о том, [как эффективно сообщать об ошибках](http://www.chiark.greenend.org.uk/~sgtatham/bugs.html). | |
| 96 | 96 | ||
| 97 | 97 | --- | |
| 98 | 98 | *From the Free Pascal wiki, page "How do I create a bug report/ru", as it stood on 2022-06-15 after a change by Zoltanleo, out of the wiki's dump of 2024-05-26. 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).* |