Пара замечаний и предложений по WIKI

Текущая информация от разработчиков о тех или иных компонентах системы, общение с разработчиками и участниками команды
Ответить
sokoloff
Сообщения: 156
Зарегистрирован: 05 ноя 2013, 20:28
Operating system: ROSA Desktop Fresh R1 64bit

Пара замечаний и предложений по WIKI

Сообщение sokoloff » 05 дек 2013, 15:23

Погрузился я тут в создание spec-а для своей программы. Прочитал документацию на wiki, и заметил несколько замечаний.

1. Страницы Основы RPM и Сборка_RPM_-_быстрый_старт противоречат друг другу. В первом написано
дерево можно создать с помощью следующей команды: mkdir -p ~/rpm/{BUILD,RPMS/$ARCH,RPMS/noarch,SOURCES,SRPMS,SPECS,tmp} .
Замените $ARCH на название архитектуры, для который планируется выполнять сборку. Обычно это i586 или x86_64, но может быть также sparc, alpha или ppc.
т.е. предлагают создать директорию ~/rpm с поддиректорией RPMS/$ARCH, а во втором написано
Первым делом нужно создать в своём домашнем каталоге файл директорию rpmbuild со следующей структурой:

Код: Выделить всё

~/rpmbuild
|-- BUILD
|-- BUILDROOT
|-- RPMS
|   |-- i586
|   |-- x86_64
|   `-- noarch
|-- SOURCES
|-- SPECS
`-- SRPMS
Каталоги BUILD, RPMS, SOURCES, SPECS, SRPMS вам необходимо создать вручную, подкаталоги каталога RPMS должны создаться автоматически во время сборки в зависимости от архитектуры.

Похоже второй вариант правильный.

2. На вики лежат Сборка_RPM_-_быстрый_старт и RPM:_синтаксис_spec_файла они, по сути, дублируют друг друга. Нельзя сказать что быстрый_старт это введение, а синтаксис_spec_файла это полное и официальное описание формата (он еще и не переведен до конца), объемы и глубина информации примерно сопоставимы.
Мне кажется лучше будет объединить эти документы в один, будет меньше путаницы.

3. Опять же противоречие. В Основы RPM написано
Внимание! Здесь представлена общая информация о секции changelog. Вы не должны добавлять эту секцию в spec-файл самостоятельно, поскольку она генерируется автоматически из истории изменений в системе контроля версий.
А в Сборка_RPM_-_быстрый_старт и RPM:_синтаксис_spec_файла описывается как создавать и заполнять этот changelog.

И еще пожелания.
4. В "сборке RPM - быстрый старт" в разделе про Requires и BuildRequires не описан, наверное, самый распространенный случай - библиотеки. Как правильно указать зависимость от библиотеки, в чем отличие "BuildRequires: %{_lib}foo" от "BuildRequires: pkgconfig(foo)", что и когда лучше использовать.

5. Хотелось бы чтоб в конце документа был раздел "Сниппеты", т.е. короткие конкретные примеры как правильно устанавливать desktop файлы, как правильно устанавливать иконки, файлы переводов, и.т.д. Чтоб люди не шарились по чужим спек-файлам, не копипасили из них код непонятного качества, а могли посмотреть официально одобренный вариант.

Аватара пользователя
ДроноваЮ
Сообщения: 2636
Зарегистрирован: 01 июн 2011, 13:11
Operating system: Ubuntu/ROSA
Откуда: Москва

Re: Пара замечаний и предложений по WIKI

Сообщение ДроноваЮ » 05 дек 2013, 16:54

sokoloff
Спасибо за дельный отзыв. То, в чём вы точно уверены из практики, можете поправить сами на самом деле, по остальным вопросам передам разработчикам.

sokoloff
Сообщения: 156
Зарегистрирован: 05 ноя 2013, 20:28
Operating system: ROSA Desktop Fresh R1 64bit

Re: Пара замечаний и предложений по WIKI

Сообщение sokoloff » 05 дек 2013, 17:43

В RPM-е я не волшебник, а только учусь. Поэтому пока сам править опасаюсь.

Ответить

Вернуться в «Информация от разработчиков»