.\" See section COPYING for conditions for redistribution.
.TH EMACSCLIENT 1 "2024-08-20" "GNU Emacs" "GNU"
.\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection
.\" other params are allowed: see man(7), man(1)
.SH "نام (NAME)"
emacsclient \- به یک Emacs در حال اجرا دستور می‌دهد فایلی را باز کند
.SH "خلاصه دستور (SYNOPSIS)"
.B emacsclient
.I "[options] files ..."
.SH "توضیحات (DESCRIPTION)"
این صفحهٔ راهنما دستور
.BR emacsclient
را به‌طور مختصر شرح می‌دهد. مستندات کامل در قالب GNU Info در دسترس است؛ بخش زیر را ببینید.
.PP
.B emacsclient
در ارتباط و هماهنگی با سرور داخلی Emacs کار می‌کند.
.PP
شما می‌توانید
.B emacsclient
را مستقیماً فراخوانی کنید یا اجازه دهید در صورت لزوم، برنامه‌های دیگر آن را برایتان اجرا کنند. در سیستم‌های گنو و یونیکس، بسیاری از برنامه‌ها متغیر محیطی EDITOR (و گاهی VISUAL) را برای به‌دست آوردن دستور مورد استفاده برای ویرایش بررسی می‌کنند. بنابراین، تنظیم این متغیر محیطی روی \(aqemacsclient\(aq به این برنامه‌ها امکان می‌دهد از یک Emacs در حال اجرا برای ویرایش استفاده کنند. سایر سیستم‌عامل‌ها ممکن است روش‌های مخصوص به خود را برای تعریف ویرایشگر پیش‌فرض داشته باشند.

برای اینکه
.B emacsclient
کار کند، به یک Emacs در حال اجرا همراه با سرور نیاز دارید. درون Emacs، توابع \(lqserver-start\(rq یا \(lqserver-mode\(rq را فراخوانی کنید. (فایل \(lq.emacs\(rq شما در صورت افزودن \(lq(server-start)\(rq یا \(lq(server-mode 1)\(rq به آن، می‌تواند این کار را به‌طور خودکار انجام دهد.)

هنگامی که ویرایش بافر را به پایان رساندید، \(lqC-x #\(rq (\(lqserver-edit\(rq) را وارد کنید. این کار فایل را ذخیره کرده و پیامی به برنامهٔ
.B emacsclient
می‌فرستد تا به آن بگوید خارج شود. برنامه‌هایی که از EDITOR استفاده می‌کنند، منتظر خروج «ویرایشگر» (در واقع
.BR emacsclient )
می‌مانند. کلید \(lqC-x #\(rq همچنین سایر درخواست‌های خارجی معلق برای ویرایش فایل‌های گوناگون را بررسی کرده و فایل بعدی را انتخاب می‌کند.

اگر متغیر \(lqserver-window\(rq را روی یک پنجره یا یک فریم تنظیم کنید، \(lqC-x #\(rq بافر سرور را در آن پنجره یا در آن فریم نمایش می‌دهد.

.SH "گزینه‌ها (OPTIONS)"
بیشتر گزینه‌ها از ساختار نحوی معمول خط فرمان گنو پیروی می‌کنند که در آن گزینه‌های طولانی با دو خط تیره (\(lq\-\(rq) آغاز می‌شوند.
.TP
.BI + line\fR[\fP\fB:\fPcolumn\fR]\fP
به
.I line
(سطر) و
.IR column
(ستون) مشخص‌شده بروید. اگر
.I column
ذکر نشود، به عنوان ستون ۱ در نظر گرفته می‌شود. این گزینه فقط برای فایل بعدی مشخص‌شده اعمال می‌شود.
.TP
.B \-a, \-\-alternate-editor=COMMAND
اگر سرور Emacs در حال اجرا نباشد، به جای آن دستور شل مشخص‌شده را اجرا می‌کند. اگر یک رشتهٔ خالی مشخص شود، دستور \(lqemacs \-\-daemon\(rq را برای شروع Emacs در حالت دیمن (daemon) اجرا کرده و سعی می‌کند به آن متصل شود.

همچنین متغیر محیطی ALTERNATE_EDITOR را ببینید که این گزینه بر آن اولویت دارد.
.TP
.B \-c, \-\-create-frame
به جای تلاش برای استفاده از فریم فعلی Emacs، یک فریم جدید ایجاد می‌کند.
.TP
.B \-r, \-\-reuse-frame
در صورت وجود فریم، از فریم موجود استفادهٔ مجدد می‌کند، در غیر این صورت فریم جدیدی می‌سازد.
.TP
.B \-F, \-\-frame-parameters=ALIST
پارامترهای فریم تازه‌ساخته‌شده را تعیین می‌کند.
.TP
.B \-d, \-\-display=DISPLAY
به سرور اعلام می‌کند که فایل‌ها را روی DISPLAY داده‌شده نمایش دهد.
.TP
.B \-e, \-\-eval
فایل‌ها را باز نمی‌کند، بلکه آرگومان‌ها را به عنوان عبارت‌های Emacs Lisp ارزیابی می‌کند.
.TP
.B \-f, \-\-server-file=FILENAME
از فایل پیکربندی TCP با نام FILENAME برای ارتباط استفاده می‌کند. نام فایل‌های نسبی نسبت به \(lq~/.emacs.d/server/\(rq یا \(lq$XDG_CONFIG_HOME/emacs/server/\(rq در نظر گرفته می‌شوند و پیش‌فرض \(lqserver\(rq است.

همچنین متغیر محیطی EMACS_SERVER_FILE را ببینید که این گزینه بر آن اولویت دارد.
.TP
.B \-n, \-\-no-wait
بدون انتظار برای «پایان» کار شما با بافر در Emacs، فوراً بازمی‌گردد. در صورت ترکیب با \-\-eval، این گزینه نادیده گرفته می‌شود.
.TP
.B \-w, \-\-timeout=N
مدت زمان انتظار (به ثانیه) برای پاسخ دادن Emacs پیش از صرف‌نظر کردن. مقدار پیش‌فرض 0 است که به معنای انتظار تا ابد می‌باشد.
.TP
.B \-\-parent-id=ID
یک فریم
.B emacsclient
را به عنوان یک فریم کلاینت درون پنجرهٔ والد X با شناسهٔ ID باز می‌کند.
.TP
.B \-q, \-\-quiet
از نمایش پیام‌های مربوط به انتظار برای Emacs یا اتصال به سوکت‌های سرور راه دور توسط
.B emacsclient
جلوگیری می‌کند.
.TP
.B \-u, \-\-suppress-output
از نمایش نتایج بازگردانده شده از سرور توسط
.B emacsclient
جلوگیری می‌کند. این گزینه بیشتر در ترکیب با \-\-eval مفید است، زمانی که ارزیابی انجام‌شده برای اثر جانبی باشد تا خود نتیجه.
.TP
.B \-s, \-\-socket-name=FILENAME
از سوکتی به نام FILENAME برای برقراری ارتباط استفاده می‌کند. نام فایل‌های نسبی نسبت به \(lq$XDG_RUNTIME_DIR/emacs/\(rq یا \(lq$TMPDIR/\(rq در نظر گرفته می‌شوند.

همچنین متغیر محیطی EMACS_SOCKET_NAME را ببینید که این گزینه بر آن اولویت دارد.
.TP
.B \-nw, \-t, \-\-tty, \-\-no-window-system
یک فریم جدید Emacs در ترمینال جاری باز می‌کند.
.TP
.B \-T, \-\-tramp=PREFIX
مقدار PREFIX را برای افزودن به نام فایل‌ها تنظیم می‌کند تا Emacs بتواند فایل‌ها را روی ماشین‌های راه دور با استفاده از TRAMP پیدا کند. این ویژگی بیشتر هنگام استفاده از سرور Emacs روی یک میزبان راه دور کارایی دارد (چه با استفاده از TCP با \-\-server-file و چه با یک سوکت فورواردشده از طریق SSH).

همچنین متغیر محیطی EMACSCLIENT_TRAMP را ببینید که این گزینه بر آن اولویت دارد.
.TP
.B \-V, \-\-version
اطلاعات نسخه را چاپ کرده و خارج می‌شود.
.TP
.B \-H, \-\-help
پیام راهنمای نحوهٔ استفاده را چاپ کرده و خارج می‌شود.
.SH "وضعیت خروج (EXIT STATUS)"
در حالت عادی، وضعیت خروج 0 است. اگر emacsclient به دلیل اعلام خطا از سوی Emacs متوقف شود، وضعیت خروج 1 خواهد بود.
.SH "محیط (ENVIRONMENT)"
.TP
.B ALTERNATE_EDITOR
اگر سرور Emacs در حال اجرا نباشد، دستور شل موجود در این متغیر محیطی را به جای آن اجرا می‌کند. اگر روی یک رشتهٔ خالی تنظیم شده باشد، دستور \(lqemacs \-\-daemon\(rq را برای شروع Emacs در حالت دیمن اجرا کرده و سعی می‌کند به آن متصل شود. این متغیر توسط گزینهٔ
.B \-\-alternate-editor
(در صورت وجود) بازنویسی خواهد شد.
.TP
.B EMACSCLIENT_TRAMP
پیشوندی برای اضافه شدن به نام فایل‌ها، به منظور امکان‌پذیر ساختن یافتن فایل‌ها توسط Emacs روی ماشین‌های راه دور با استفاده از TRAMP. این متغیر توسط گزینهٔ
.B \-\-tramp
(در صورت وجود) بازنویسی خواهد شد.
.TP
.B EMACS_SERVER_FILE
برای یافتن محل یک سرور Emacs مبتنی بر TCP، این فایل بررسی می‌شود. نام فایل‌های نسبی نسبت به \(lq~/.emacs.d/server/\(rq یا \(lq$XDG_CONFIG_HOME/emacs/server/\(rq هستند و مقدار پیش‌فرض \(lqserver\(rq است. این متغیر توسط گزینهٔ
.B \-\-server-file
(در صورت وجود) بازنویسی خواهد شد.
.TP
.B EMACS_SOCKET_NAME
نام فایل سوکت مورد استفاده برای برقراری ارتباط با سرور Emacs. نام فایل‌های نسبی نسبت به \(lq$XDG_RUNTIME_DIR/emacs/\(rq یا \(lq$TMPDIR/\(rq هستند. این متغیر توسط گزینهٔ
.B \-\-socket-name
(در صورت وجود) بازنویسی خواهد شد.
.SH "همچنین ببینید (SEE ALSO)"
این برنامه به‌طور کامل در
.IR "Using Emacs as a Server"
که از طریق سامانهٔ Info در دسترس است، مستند شده است.

متغیرهای محیطی _XDG با جزئیات کامل در
.UR https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html
مشخصات دایرکتوری پایه XDG
.UE
شرح داده شده‌اند.

.SH "نویسندگان (AUTHORS)"
این صفحهٔ راهنما در ابتدا توسط Stephane Bortzmeyer
<bortzmeyer@debian.org>
برای سیستم گنو/لینوکس دبیان نوشته شده بود، اما منحصر به آن سیستم نیست.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
این صفحهٔ راهنما در مالکیت عمومی (Public Domain) قرار دارد.

.\" Local Variables:
.\" eval: (add-hook 'before-save-hook 'time-stamp nil t)
.\" time-stamp-pattern: "^\\.TH [^ ]+ [^ ]+ \"?%Y-%m-%d\\_>"
.\" time-stamp-time-zone: "UTC0"
.\" End: