.\" Generated by scdoc 1.11.5
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "RIVER" "1" "2026\-08\-16"
.PP
.PP
.SH "نام (NAME)"
.PP
river \- کامپوزیتور غیریکپارچه برای Wayland
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBriver\fR [\fIگزینه‌ها\fR]
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
برنامهٔ River یک کامپوزیتور غیریکپارچه (non\-monolithic) برای Wayland است؛ این برنامه کامپوزیتور و مدیر پنجره را در یک برنامه ترکیب نمی‌کند.\& در عوض، کاربران می‌توانند هر مدیر پنجره‌ای را که پروتکل river\-window\-management\-v1 را پیاده‌سازی کرده باشد انتخاب کنند.\&
.PP
این بدان معناست که river بدون یک مدیر پنجرهٔ سازگار قابل استفاده نیست.\& فهرستی از مدیرهای پنجرهٔ سازگار را می‌توان در ویکی river یافت:
https://codeberg.\&org/river/wiki/src/branch/main/pages/wm\-list.\&md
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-h\fR
.RS 4
نمایش پیام راهنما و خروج.\&
.PP
.RE
\fB\-version\fR
.RS 4
نمایش شمارهٔ نسخه و خروج.\&
.PP
.RE
\fB\-c\fR \fIshell_command\fR
.RS 4
نادیده‌گرفتن مسیرهای پیش‌فرض جستجو برای یک فایل اجرایی init: در عوض، \fIshell_command\fR با دستور \fI/bin/sh \-c\fR اجرا خواهد شد.\& برای جزئیات بیشتر بخش \fBپیکربندی (CONFIGURATION)\fR را ببینید.\&
.PP
.RE
\fB\-log\-level\fR [\fBerror\fR|\fBwarning\fR|\fBinfo\fR|\fBdebug\fR]
.RS 4
تنظیم سطح گزارش‌گیری river.\& در سطح گزارش‌گیری \fBerror\fR، تنها خطاها ثبت می‌شوند.\& در سطح گزارش‌گیری \fBdebug\fR، همه‌چیز از جمله پیام‌های اشکال‌زدایی پرجزئیات ثبت می‌شوند.\&
.PP
.RE
\fB\-no\-xwayland\fR
.RS 4
غیرفعال کردن Xwayland در زمان اجرا، حتی اگر river با پشتیبانی از آن کامپایل شده باشد.\&
.PP
.RE
.SH "کلیدهای میانبر (KEYBINDINGS)"
.PP
کلیدهای میانبر زیر همیشه فعال هستند:
.PP
\fBCtrl+Alt+F1\fR \- \fBCtrl+Alt+F12\fR
.RS 4
جابه‌جایی به ترمینال مجازی (VT) شماره ۱ تا ۱۲
.PP
.RE
مدیرهای پنجره می‌توانند کلیدهای میانبر دیگری اضافه کنند، اما نمی‌توانند این کلیدهای میانبر توکار را لغو یا بازنویسی کنند.\&
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
هنگام راه‌اندازی، river در صورت وجود فایلی اجرایی در مسیر $XDG_CONFIG_HOME/river/init آن را اجرا خواهد کرد.\& اگر $XDG_CONFIG_HOME تنظیم نشده باشد، مسیر \(ti/.\&config/river/init به‌جای آن استفاده خواهد شد.\&
.PP
فایل اجرایی init پس از مقداردهی اولیهٔ سرور Wayland مربوط به river اما پیش از ورود به حلقهٔ اصلی (main loop)، به‌عنوان رهبر گروه فرآیند (process group leader) اجرا می‌شود.\& هنگام خروج، river سیگنال SIGTERM را به این گروه فرآیند ارسال خواهد کرد.\&
.PP
معمولاً این فایل اجرایی یک اسکریپت شل است که مدیر پنجرهٔ کاربر و سایر برنامه‌های طولانی‌مدت را اجرا می‌کند.\& برای مثال، می‌توان \fBkanshi\fR(1) را برای مدیریت پیکربندی خروجی نمایشگر اجرا کرد.\&
.PP
.SH "نویسندگان (AUTHORS)"
.PP
نگهداری‌شده توسط Isaac Freund <mail@isaacfreund.\&com> با همراهی مشارکت‌کنندگان متن‌باز.\& برای اطلاعات بیشتر دربارهٔ توسعهٔ river، <https://isaacfreund.\&com/software/river> را ببینید.\&