From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Michael Albinus Newsgroups: gmane.emacs.bugs Subject: bug#66598: Missing options from emacsclient man page Date: Sat, 21 Oct 2023 16:35:05 +0200 Message-ID: <878r7wt55y.fsf@gmx.de> References: <85msy98sni.fsf@elpa.gnu.org> <87r0nidkmt.fsf@bernoul.li> <83bkelc1p1.fsf@gnu.org> <87fs3xwzxm.fsf@bernoul.li> <837cp9bur7.fsf@gnu.org> <87a5u5wskw.fsf@bernoul.li> <87r0ltzgwe.fsf@gmx.de> <1efecd26-43ea-96d3-de27-8b75bd9a3a0f@mavit.org.uk> <87il74tsr8.fsf@gmx.de> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="13511"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: 66598@debbugs.gnu.org To: Peter Oliver Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Oct 21 16:36:01 2023 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1quD57-0003Ei-15 for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 21 Oct 2023 16:36:01 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1quD4l-0002Lh-Nk; Sat, 21 Oct 2023 10:35:39 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1quD4h-0002Kq-FS for bug-gnu-emacs@gnu.org; Sat, 21 Oct 2023 10:35:36 -0400 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1quD4h-0005D6-72 for bug-gnu-emacs@gnu.org; Sat, 21 Oct 2023 10:35:35 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1quD59-0005nQ-12 for bug-gnu-emacs@gnu.org; Sat, 21 Oct 2023 10:36:03 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Michael Albinus Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 21 Oct 2023 14:36:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 66598 X-GNU-PR-Package: emacs Original-Received: via spool by 66598-submit@debbugs.gnu.org id=B66598.169789895122251 (code B ref 66598); Sat, 21 Oct 2023 14:36:02 +0000 Original-Received: (at 66598) by debbugs.gnu.org; 21 Oct 2023 14:35:51 +0000 Original-Received: from localhost ([127.0.0.1]:44825 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1quD4t-0005mk-DF for submit@debbugs.gnu.org; Sat, 21 Oct 2023 10:35:51 -0400 Original-Received: from mout.gmx.net ([212.227.17.20]:55629) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1quD4n-0005mO-6H for 66598@debbugs.gnu.org; Sat, 21 Oct 2023 10:35:45 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.de; s=s31663417; t=1697898906; x=1698503706; i=michael.albinus@gmx.de; bh=wSxNmVHRKyS+M7Ual6yTWKCvZPWyBEL/0Y1M29sSF68=; h=X-UI-Sender-Class:From:To:Cc:Subject:In-Reply-To:References: Date; b=jTPm/+fE6AWqPXdNohl/IpU79QYpI2piK2E5zz3hthrV1mc9gnwGd/8wzmg276Nr Id9ruC+tq9P+4QFoOQp0LOiHhfGFnVZMdqWUCsK7vZyVc2+GkS7UfS6l+isoZFNSJ tPckGvJKvyldya4QhGsN6d/wfbSs2g1nW0FqjtXNcb7kvDtwN3qs3RfbR2ZrQv7L6 SD+GWZhGnPy4WTPcN7tK4gvD9h832ZUuyUNxaJaAx7Bok4O3JIb+uKCc5patvLvGb 7aEh0A3pnYv65KaKEMS48Xu2V+246sY28+GEpy99ot3JG6a/J5ovVTbbDqKLP44yh sZk53jrOZU57281Kmg== X-UI-Sender-Class: 724b4f7f-cbec-4199-ad4e-598c01a50d3a Original-Received: from gandalf.gmx.de ([185.89.39.30]) by mail.gmx.net (mrgmx105 [212.227.17.168]) with ESMTPSA (Nemesis) id 1MnakX-1rLGQh1IpB-00jZxE; Sat, 21 Oct 2023 16:35:06 +0200 In-Reply-To: (Peter Oliver's message of "Sat, 21 Oct 2023 14:05:40 +0100 (BST)") X-Provags-ID: V03:K1:LAb92dkxtbJzhGXo5J+tZzJT/Ws0qH4IWwDVOQ5dSQVPNWpWWF4 y+IY2aad3FcrEWkS56eSh0akzLhhq+USfOmLucNwKgRvOcmhHQNDvaB2yxZPu58S8PcIPVU 7s4BvJna/XAsBQMS1LsXftBqRvYriBLaTJGeo2fyfhRc1K9/GlHJXxwKRfMoiUw+7EpExlR i8UFmJLM3kLzyCb7gOxKA== UI-OutboundReport: notjunk:1;M01:P0:tMXNiZfLu8o=;qIScJYsywwyZY9b1/U3M9J29Hcj lPW4/T5s7gH3n/Yv3haJQbihp6q8yFwzddR/L8KY2Zp29XwZ1HxEq3UH8Eii7A9l7/kbS6GAZ 7NhjnCKAoi9eIGVvCfZsdLDQD8HVw7kGUgX3qbb9Zxwjts1GTOMZ6bt/ZzqMRchOVo0yQkPoQ IrW168JzOoorgXkULc9TnLa5v4nB7Npbt+eGZzLalTndy1Jeqbgj4BF9O5aq95R7ODRJzsIYX fZ6AbXV/eLuraQrF0bEJj+K0HF3aaqLex15evKeYJBbTHd8nzsQ8Zbu2W/u7LLXAVWkDfZdze XD6VEUk0Ec2KUruUM7SUsm8GRTFdhcsvSt3wDIFwsrl5x7yuwq07z0YUGXpsUB80wIIn3mrMZ 60kzSmEYPmA0rxCaBpgWehZI+ee4cWstHSg5pUqlluHvFQhCoKpz/aQet2MUhu9fzrgERRsKp CMUYKsgquCyifKM8eMYZB/bFal4QrkOrz8KGUmU8chvFOZMioT08T1o9w94Us8L9h85H0e5EA bzFlcK+H1ZQqlkjRdH9PzWI3+UIOO9lEo4Q0GQtfERxvbmZ92G9UHOeAlTg9jfG6iZiRkBpBD 8ZaxQjSwZMNlP/SEJrhnR0KILIbTwRQWgtAGB8TtGQsbUN3+qxtXa8vc7VEEPqBbrETX9TFaO j9caUq/34WPQbIkySxH1ENNCVoes/4nB7kpZW4MMaqviPU+vCdRLAKrNZvJTDOKRKUcZOLyhH a8Rj+vTyuvmP4NJkw6ANtgwh8FUGGVi9JLKqFSGSIc8SbbMlhMYuXr268n3Vf2fMm0akgR1N X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:272910 Archived-At: Peter Oliver writes: Hi Peter, >> And perhaps we could also add an ENVIRONMENT section. > > Attached is a patch to do that. Thanks for this. Eli gave you already comments, so here are just my additional ones. > .B \-T, \-\-tramp-prefix=PREFIX > Set PREFIX to add to filenames for Emacs to locate files on remote > machines using TRAMP. This is mostly useful in combination with using > -the Emacs server over TCP with --server-file. This can also be > -specified via the EMACSCLIENT_TRAMP environment variable. > +the Emacs server on a remote host (either using TCP with > +--server-file, or a socket forwarded over SSH). This takes precedence > +over the EMACSCLIENT_TRAMP environment variable. I'm not sure whether we shall mention here the alternative "socket forwarded over SSH". This is indeed the only existing alternative for the --server-file option in Emacs 29, but I have rough plans to offer also network processes in Tramp, which would add more flexibility, and less configuration need for users. But this is in an early phase of thinking only ATM. So perhaps it is OK to mention "socket forwarded over SSH" here in Emacs 29. > +.SH ENVIRONMENT > +.TP > +.B ALTERNATE_EDITOR > +.TP > +.B EMACSCLIENT_TRAMP > +.TP > +.B EMACS_SERVER_FILE > +.TP > +.B EMACS_SOCKET_NAME Reading emacsclient.c, there are also further environment variables: XDG_CONFIG_HOME XDG_RUNTIME_DIR I'm undecided whether we shall mention them. Eli? > Peter Oliver Best regards, Michael.