Обновлено: Единая команда управления пакетами (epm)

docs/epm.md

@@ -26,6 +26,115 @@ apt-get install eepm
 | Вывести информацию о пакете |  epm -ql (package)   |  apt-cache show (package) |
 | Обновить дистрибутив |  epm upgrade   |  apt-get dist-upgrade |
 
+## Утилита EPM Play
+
+**EPM Play** — инструмент позволяющий  автоматически устанавливать и удалять пакеты используя заготовленные сценарии при этом не используя сторонний репозитории.
+
+``` 
+epm play [options] [argument]
+```
+
+### Установить приложение
+
+Для установки приложения, используйте `epm play <app>`
+
+```shell
+epm play telegram
+```
+
+Для установки [альтернативной версии](#работа-со-списком-приложений) приложения:
+
+```shell
+epm play telegram = beta
+```
+
+### Удаленить приложение
+
+Для удаления приложения используйте `epm play --remove <app>`
+
+```shell
+epm play telegram
+```
+
+Возможно удалить приложение используя пакетный менеджер: 
+
+::: code-group
+
+```shell[apt-get]
+su -
+apt-get remove Telegram
+```
+```shell[epm]
+epm -e Telegram
+```
+:::
+
+### Обновить приложение до последней версии
+
+Для удаления приложения в EPM Play **используйте** опцию `--update` и идентификатор приложения:
+
+```shell
+epm play --update telegram
+```
+
+Для обновления списка установленных приложений, используйте опцию `--update` и аргумент `all`:
+
+```shell
+epm play --update all
+```
+
+Альтернативном методом обновления приложения, является повторная устновка приложения:
+
+```shell
+epm play telegram
+```
+
+### Работа со списком приложений
+
+Получить список установленных приложений:
+
+```shell
+epm play --list
+```
+
+:::warning
+При совпадение индификаторов приложений, в списке будут присутсвовать приложения установленные с помощью пакетного менеджера `apt-get` 
+:::
+
+Получить список установленных утилит:
+
+```shell
+epm play --list-scripts
+```
+
+:::info
+Утилиты — группа установочных сценариев, которая автоматически устанавляет или удаляет: драйвера, инструменты для разработки и другие системные приложения различных типов.
+:::
+
+Получить полный список приложений и утилит:
+
+```shell
+epm play --list-all
+```
+
+Чтобы получить список без описаний приложений/утилит, используйте опцию `--short`, работает со следующими опциями `[--list|--list-scripts|--list-all]`:
+
+```shell
+epm play --short --list-all
+```
+
+Проверить, установлено ли приложение используйте опцию `--installed` и и идентификатор приложения:
+
+```shell
+epm play --installed telegram
+```
+
+Получить список альтернативных версий возможный для установки, используйте опцию `--product-alternatives` и индификатор приложения:
+
+```shell
+epm play --product-alternatives telegram
+```
+
 ## Установка приложений с помощью appinstall
 
 Для установки и удаления приложений из каталога `epm play` используя графический интерфейс, рекомендуем использовать appinstall