feat docs: update gentoo build docs

Tests: на прод не влияет

---

Pull Request resolved: #1142

Co-authored-by: antoshkka <antoshkka@userver.tech>
Co-authored-by: antoshkka <antoshkka@userver.tech>
commit_hash:6ad19ebb704378c4e4614cd9611b0ce2cee730cb

Author: 2 people

.mapping.json

@@ -4513,7 +4513,6 @@
   "scripts/docs/en/deps/debian-12.md":"taxi/uservices/userver/scripts/docs/en/deps/debian-12.md",
   "scripts/docs/en/deps/debian-13.md":"taxi/uservices/userver/scripts/docs/en/deps/debian-13.md",
   "scripts/docs/en/deps/fedora-42.md":"taxi/uservices/userver/scripts/docs/en/deps/fedora-42.md",
-  "scripts/docs/en/deps/gentoo.md":"taxi/uservices/userver/scripts/docs/en/deps/gentoo.md",
   "scripts/docs/en/deps/macos.md":"taxi/uservices/userver/scripts/docs/en/deps/macos.md",
   "scripts/docs/en/deps/ubuntu-22.04.md":"taxi/uservices/userver/scripts/docs/en/deps/ubuntu-22.04.md",
   "scripts/docs/en/deps/ubuntu-22.04/chaotic":"taxi/uservices/userver/scripts/docs/en/deps/ubuntu-22.04/chaotic",

README.md

@@ -12,6 +12,7 @@
 
 [![Build and publish ubuntu-24.04-userver images](https://github.com/userver-framework/userver/actions/workflows/publish-ubuntu-24.04-images.yaml/badge.svg)](https://github.com/userver-framework/userver/actions/workflows/publish-ubuntu-24.04-images.yaml)
 [![Build and publish ubuntu-22.04-userver images](https://github.com/userver-framework/userver/actions/workflows/publish-ubuntu-22.04-images.yaml/badge.svg)](https://github.com/userver-framework/userver/actions/workflows/publish-ubuntu-22.04-images.yaml)
+[![Gentoo Systemd with Overlay CI](https://github.com/userver-framework/userver-overlay/actions/workflows/gentoo.yml/badge.svg)](https://github.com/userver-framework/userver-overlay/actions/workflows/gentoo.yml)
 
 [![uservice-dynconf CI](https://github.com/userver-framework/uservice-dynconf/actions/workflows/ci.yml/badge.svg)](https://github.com/userver-framework/uservice-dynconf/actions/workflows/ci.yml)
 [![uservice-dynconf Docker build](https://github.com/userver-framework/uservice-dynconf/actions/workflows/docker.yaml/badge.svg?branch=develop)](https://github.com/userver-framework/uservice-dynconf/actions/workflows/docker.yaml)

scripts/docs/en/deps/gentoo.md

@@ -453,6 +453,46 @@ target_link_libraries(${PROJECT_NAME} PUBLIC userver::grpc)
 
 @see @ref userver_libraries
 
+@anchor gentoo_ebuild
+## Gentoo ebuild
+
+You can install userver via Emerge in Gentoo Linux:
+
+1. Set needed use-flags in file `/etc/portage/package.use/userver`:
+
+   ```bash
+   dev-cpp/userver-framework flag1 flag2 ...
+   ```
+
+   Supported use-flags:
+
+   ```
+   postgres - Provide asynchronous driver for PostgreSQL
+   redis - Provide asynchronous driver for Redis
+   mongodb - Provide asynchronous driver for MongoDB
+   mysql - Provide asynchronous driver for MySQL/MariaDB
+   rabbitmq - Provide asynchronous driver for RabbitMQ (AMQP 0-9-1)
+   kafka - Provide asynchronous driver for Apache Kafka
+   utest - Provide utest and ubench for unit testing and benchmarking coroutines
+   testsuite - Enable functional tests via testsuite
+   easy - Build easy HTTP server library
+   odbc - Provide asynchronous driver for ODBC
+   sqlite - Provide asynchronous driver for SQLite
+   uboost-coro - Build with vendored version of Boost.context and Boost.coroutine2
+   ```
+
+2. Install userver:
+
+   ```bash
+   sudo emerge app-portage/eselect-repository
+   sudo eselect repository add userver-framework git https://github.com/userver-framework/userver-overlay.git
+   sudo emerge --sync
+   sudo emerge --ask dev-cpp/userver
+   ```
+
+
+
+
 
 ## Yandex Cloud with Ubuntu 22.04
 

scripts/docs/en/userver/build/build.md

@@ -88,21 +88,46 @@ USERVER_FEATURE_PATCH_LIBPQ=0
 
 ### Gentoo
 
-\b Dependencies: @ref scripts/docs/en/deps/gentoo.md "third_party/userver/scripts/docs/en/deps/gentoo.md"
+\b Dependencies: https://github.com/userver-framework/userver-overlay/blob/master/dev-cpp/userver-meta/userver-meta-2.13.ebuild
 
 Dependencies can be installed via:
 
 ```bash
-DEPS_FILE="https://raw.githubusercontent.com/userver-framework/userver/refs/heads/develop/scripts/docs/en/deps/gentoo.md" && \
-sudo emerge --ask --update --oneshot $(wget -q -O - ${DEPS_FILE})
+sudo emerge app-portage/eselect-repository
+sudo eselect repository add userver-framework git https://github.com/userver-framework/userver-overlay.git
+sudo emerge --sync
+sudo emerge --ask dev-cpp/userver-meta
 ```
 
 Recommended CMake options:
 
 ```
-USERVER_CHECK_PACKAGE_VERSIONS=0
+USERVER_CHECK_PACKAGE_VERSIONS=OFF
+USERVER_FEATURE_STACKTRACE=OFF
+USERVER_FEATURE_GRPC=OFF
+USERVER_FEATURE_GRPC_REFLECTION=OFF
+USERVER_FEATURE_REDIS_TLS=OFF
+USERVER_FEATURE_CLICKHOUSE=OFF
+USERVER_FEATURE_ROCKS=OFF
+USERVER_FEATURE_OTLP=OFF
+USERVER_FEATURE_S3API=OFF
 ```
 
+Use-flags:
+
+```
+grpc - install dependencies to build with Grpc (unrecomented) (use with Cmake option USERVER_FEATURE_GRPC=ON)
+postgres - install dependencies to build with PostgreSQL (use with Cmake option USERVER_FEATURE_POSTGRESQL=ON)
+redis - install dependencies to build with Redis db (use with Cmake option USERVER_FEATURE_REDIS=ON)
+mongodb  - install dependencies to build with Mongo db (use with Cmake option USERVER_FEATURE_MONGODB=ON)
+mysql - install dependencies to build with MySQL (MariaDB) (use with Cmake option USERVER_FEATURE_MYSQL=ON)
+rabbitmq - install dependencies to build with RabbitMQ messages broker (use with Cmake option USERVER_FEATURE_RABBITMQ=ON)
+kafka - install dependencies to build with Apache Kafka (use with Cmake option USERVER_FEATURE_KAFKA=ON)
+rocksdb - install dependencies to build with RocksDB (unrecomented) (use with Cmake option USERVER_FEATURE_ROCKS=ON)
+utest - install dependencies to build with Utest (use with Cmake option USERVER_FEATURE_UTEST=ON)
+odbc - install dependencies to build with Complete ODBC driver manager (use with Cmake option USERVER_FEATURE_ODBC=ON)  
+sqlite - install dependencies to build with sqlite (use with Cmake option USERVER_FEATURE_SQLITE=ON)
+```
 
 ### Alpine
 

scripts/docs/en/userver/build/dependencies.md

@@ -28,7 +28,6 @@ Currently we're looking for maintainers for the following OSes/distros:
 * Fedora
 * Debian
 * ArchLinux
-* Gentoo
 * FreeBSD
 * Conan package
 
@@ -39,6 +38,7 @@ The list is not complete, you may suggest your own distro to maintain.
 
 Active maintainers so far:
 - Ubuntu - userver team
+- Gentoo - [halfdarkangel](https://t.me/halfdarkangel)
 
 
 ## Contacts