README: convert to markdown and add Russian translation

README

-This package is a set of helper utils for rpm building process.
-
-See info in Russian at
-http://www.altlinux.org/Etersoft-build-utils_howto
-
-See QuickHelp.txt also.
-
-Set target distro in MENV in ~/.config/eterbuild, f.i. for Sisyphus
-MENV=SS
-or
-MENV=M80P
-for ALT Linux p8
-
-Examples:
-
-rpmbb [-c] [-i] [-p] [name.spec] - build package
-	-r - update build req
-
-rpmbsh [-r] [-m] [-s] [-u/-U] [-i] [name.spec] - build package in hasher [and (-s) sign its src.rpm]
-
-rpmbs [-s] [-r] [-u/-U] [name.spec] - make src.rpm [and (-s) sign package]
-
-rpmbph [-b p7] [-r] [-u/-U] [name.spec] - backport spec and build package for previous/foreign distro
-
-rpmgs [name.spec] - download main source file for spec (works with any tarball types)
-	-f force
-
-rpmgp -g name  - clone git with latest package version
-	-c name | name.spec | package*rpm - check if the package is published in Sisyphus
-	-b name.spec - install need packages for build (via apt-get)
-	-a - check in all known rpm based system
-
-rpmurl [-c -f] name.spec - open Url from spec in browser
-
-rpmbugs [-qf ] name.spec | name - open buglist for package in browser
-	-t - console output
-
-rpmcs name.spec - cleanup spec (foreign specs adoption helper)
-
-loginhsh [-b p7] [-t -i] - log in to shell in hasher
-
-rpmrb [spec] new_version - get source for new version, rebuild it and upload
-	rpmrb [spec] .2 change only minor version
-	rpmrb [spec] 2.6 change only major version
-
-Common options:
--s - sign package and prepare to publish
--u/-U - upload signed package to Incoming/Backports(Updates)
--i - install after build
-
-
-Replacement rules (for rpmbph):
-alt-package-name|foreign-package-name
-
-pkgrepl.rpm - base rules, use always
-pkgrepl.rpm.x86_64 - base rules, use firstly for x86_64
-pkgrepl.pclinux - rules only for PC Linux
-pkgrepl.pclinux.2007 - rules only for PC Linux 2007
-pkgrepl.pclinux.2007.x86_64 - rules only for PC Linux 2007, use firstly for x86_64
-
-NOTE:
-you have to prepare correct ~/.rpmmacros file, GPG signature in ~/.gnupg,
-SSH private key in ~/.ssh/id_dsa,
-alias 'git.alt' in ~/.ssh/config for altlinux account (typical for joined at ALT Linux)
-
-Please send any questions at lav@etersoft.ru
-
-Vitaly Lipatov, 11 March, 2015

README.md

+# etersoft-build-utils
+
+A set of helper utilities for RPM package building on ALT Linux and other RPM-based distributions.
+
+[Документация на русском / Russian documentation](README.ru.md)
+
+## Installation
+
+```bash
+apt-get install etersoft-build-utils
+```
+
+## Configuration
+
+Set target distribution in `~/.config/eterbuild`:
+
+```bash
+MENV=p11     # for ALT Linux p11
+MENV=p10     # for ALT Linux p10
+MENV=SS      # for Sisyphus
+```
+
+## Main Commands
+
+### Building packages
+
+| Command | Description |
+|---------|-------------|
+| `rpmbb [spec]` | Build binary package |
+| `rpmbs [spec]` | Create source RPM |
+| `rpmbsh [spec]` | Build package in hasher (isolated environment) |
+| `rpmbph -b <branch> [spec]` | Backport package to another branch |
+
+### Source management
+
+| Command | Description |
+|---------|-------------|
+| `rpmgs [spec]` | Download sources from spec file |
+| `rpmgp -g <name>` | Clone git repository with package |
+| `rpmgp -c <name>` | Check if package is published |
+
+### Git/GIRAR operations
+
+| Command | Description |
+|---------|-------------|
+| `gita` / `gitask` | GIRAR task management wrapper |
+| `gita ls` | List your tasks |
+| `gita new [branch]` | Create new task |
+| `gita add <cmd> <pkg>` | Add subtask |
+| `gita run [task]` | Run task |
+| `gita log [task]` | Show build log |
+
+### Spec file utilities
+
+| Command | Description |
+|---------|-------------|
+| `rpmcs [spec]` | Cleanup spec (foreign spec adoption) |
+| `rpmlog [spec]` | Update changelog from git log |
+| `rpmurl [spec]` | Open URL from spec in browser |
+| `rpmbugs [spec]` | Open bug list for package |
+
+### Hasher utilities
+
+| Command | Description |
+|---------|-------------|
+| `loginhsh` | Log in to hasher shell |
+| `myhsh` | Manage hasher environment |
+| `runinhsh` | Run command inside hasher |
+
+### Build helpers
+
+| Command | Description |
+|---------|-------------|
+| `jmake` | Make with parallel build and ccache |
+| `dmake` | Distributed make |
+
+## Common Options
+
+- `-s` — sign package
+- `-u` / `-U` — upload to Incoming/Backports
+- `-i` — install after build
+- `-r` — update build requirements
+- `-h` — show help
+
+## Package Replacement Rules
+
+Rules for cross-distribution package name mapping (used by `rpmbph`):
+
+```
+alt-package-name|foreign-package-name
+```
+
+Rule files in `share/eterbuild/pkgrepl/`:
+- `pkgrepl.rpm` — base rules
+- `pkgrepl.<distro>` — distribution-specific rules
+- `pkgrepl.<distro>.<version>` — version-specific rules
+
+## Requirements
+
+- `~/.rpmmacros` — RPM macros configuration
+- `~/.gnupg/` — GPG keys for signing
+- `~/.ssh/` — SSH keys for git.alt access
+- `git.alt` alias in `~/.ssh/config`
+
+## Documentation
+
+- [ALT Linux Wiki (Russian)](http://www.altlinux.org/Etersoft-build-utils_howto)
+
+## Author
+
+Vitaly Lipatov <lav@etersoft.ru>
+
+## License
+
+Apache 2.0

README.ru.md

+# etersoft-build-utils
+
+Набор утилит для сборки RPM-пакетов в ALT Linux и других RPM-дистрибутивах.
+
+[English documentation](README.md)
+
+## Установка
+
+```bash
+apt-get install etersoft-build-utils
+```
+
+## Настройка
+
+Укажите целевой дистрибутив в `~/.config/eterbuild`:
+
+```bash
+MENV=p11     # для ALT Linux p11
+MENV=p10     # для ALT Linux p10
+MENV=SS      # для Sisyphus
+```
+
+## Основные команды
+
+### Сборка пакетов
+
+| Команда | Описание |
+|---------|----------|
+| `rpmbb [spec]` | Собрать бинарный пакет |
+| `rpmbs [spec]` | Создать source RPM |
+| `rpmbsh [spec]` | Собрать пакет в hasher (изолированная среда) |
+| `rpmbph -b <ветка> [spec]` | Бэкпорт пакета в другую ветку |
+
+### Работа с исходниками
+
+| Команда | Описание |
+|---------|----------|
+| `rpmgs [spec]` | Скачать исходники по spec-файлу |
+| `rpmgp -g <имя>` | Клонировать git-репозиторий с пакетом |
+| `rpmgp -c <имя>` | Проверить, опубликован ли пакет |
+
+### Работа с Git/GIRAR
+
+| Команда | Описание |
+|---------|----------|
+| `gita` / `gitask` | Обёртка для управления задачами GIRAR |
+| `gita ls` | Список ваших задач |
+| `gita new [ветка]` | Создать новую задачу |
+| `gita add <команда> <пакет>` | Добавить подзадачу |
+| `gita run [задача]` | Запустить задачу |
+| `gita log [задача]` | Показать лог сборки |
+
+### Утилиты для spec-файлов
+
+| Команда | Описание |
+|---------|----------|
+| `rpmcs [spec]` | Очистка spec (адаптация чужих spec-файлов) |
+| `rpmlog [spec]` | Обновить changelog из git log |
+| `rpmurl [spec]` | Открыть URL из spec в браузере |
+| `rpmbugs [spec]` | Открыть список багов пакета |
+
+### Утилиты hasher
+
+| Команда | Описание |
+|---------|----------|
+| `loginhsh` | Войти в shell hasher |
+| `myhsh` | Управление средой hasher |
+| `runinhsh` | Запустить команду в hasher |
+
+### Помощники сборки
+
+| Команда | Описание |
+|---------|----------|
+| `jmake` | Make с параллельной сборкой и ccache |
+| `dmake` | Распределённая сборка |
+
+## Общие опции
+
+- `-s` — подписать пакет
+- `-u` / `-U` — загрузить в Incoming/Backports
+- `-i` — установить после сборки
+- `-r` — обновить сборочные зависимости
+- `-h` — показать справку
+
+## Правила замены пакетов
+
+Правила для сопоставления имён пакетов между дистрибутивами (используется в `rpmbph`):
+
+```
+alt-package-name|foreign-package-name
+```
+
+Файлы правил в `share/eterbuild/pkgrepl/`:
+- `pkgrepl.rpm` — базовые правила
+- `pkgrepl.<дистрибутив>` — правила для дистрибутива
+- `pkgrepl.<дистрибутив>.<версия>` — правила для версии
+
+## Требования
+
+- `~/.rpmmacros` — конфигурация макросов RPM
+- `~/.gnupg/` — GPG-ключи для подписи
+- `~/.ssh/` — SSH-ключи для доступа к git.alt
+- алиас `git.alt` в `~/.ssh/config`
+
+## Документация
+
+- [ALT Linux Wiki](http://www.altlinux.org/Etersoft-build-utils_howto)
+
+## Автор
+
+Vitaly Lipatov <lav@etersoft.ru>
+
+## Лицензия
+
+Apache 2.0