From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Paul Eggert Newsgroups: gmane.emacs.devel Subject: Re: emacs-25 ef33bc7: Spelling and grammar fixes Date: Sun, 24 Jan 2016 16:19:25 -0800 Organization: UCLA Computer Science Department Message-ID: <56A56A0D.8080404@cs.ucla.edu> References: <20160101095923.28527.94916@vcs.savannah.gnu.org> <87r3h6a893.fsf@gmx.de> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="------------090106060802060801090503" X-Trace: ger.gmane.org 1453681189 30283 80.91.229.3 (25 Jan 2016 00:19:49 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 25 Jan 2016 00:19:49 +0000 (UTC) To: Michael Albinus , emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Jan 25 01:19:40 2016 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1aNUsb-0002Dr-W8 for ged-emacs-devel@m.gmane.org; Mon, 25 Jan 2016 01:19:38 +0100 Original-Received: from localhost ([::1]:33895 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aNUsa-0008Gm-Qs for ged-emacs-devel@m.gmane.org; Sun, 24 Jan 2016 19:19:36 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:39963) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aNUsX-0008GY-8i for emacs-devel@gnu.org; Sun, 24 Jan 2016 19:19:34 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aNUsS-00080m-8G for emacs-devel@gnu.org; Sun, 24 Jan 2016 19:19:33 -0500 Original-Received: from zimbra.cs.ucla.edu ([131.179.128.68]:49447) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aNUsR-00080e-Uo for emacs-devel@gnu.org; Sun, 24 Jan 2016 19:19:28 -0500 Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 1BDA41601AA; Sun, 24 Jan 2016 16:19:27 -0800 (PST) Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10032) with ESMTP id uQAa3udvzf8R; Sun, 24 Jan 2016 16:19:25 -0800 (PST) Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id C66201607DA; Sun, 24 Jan 2016 16:19:25 -0800 (PST) X-Virus-Scanned: amavisd-new at zimbra.cs.ucla.edu Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id wQtvQBKKi51K; Sun, 24 Jan 2016 16:19:25 -0800 (PST) Original-Received: from [192.168.1.9] (pool-100-32-155-148.lsanca.fios.verizon.net [100.32.155.148]) by zimbra.cs.ucla.edu (Postfix) with ESMTPSA id A3A401601AA; Sun, 24 Jan 2016 16:19:25 -0800 (PST) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:38.0) Gecko/20100101 Thunderbird/38.5.1 In-Reply-To: <87r3h6a893.fsf@gmx.de> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 131.179.128.68 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:198735 Archived-At: This is a multi-part message in MIME format. --------------090106060802060801090503 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit Michael Albinus wrote: > I disagree. Samba does not necessary run on server machines only, it > runs also on desktop machines. And there's also MS Windows; most > machines equipped with this are not servers :-) "... to any host ..." > seems to be proper wording to me. In networking a "host" can be a client or a server or something else. For smbclient to work, it must connect to an SMB server; not any SMB host will do. Admittedly this technical interpretation may not be familiar to non-experts so I installed the attached patch to try to clarify things. While I was at it, this patch streamlines away some old cruft about MS Windows NT servers, CIFS, and the like, as it's 2016 now and not 2006. > Furtheron, Samba does not run only on GNU/Linux. I use it myself on > HP-UX machines, and I connect Tramp to Samba running there. That's why > I've used neutral "Unixes". The word "Unixes" feels funny, at least to this native English speaker. (It's not in my English spelling dictionary, which is how I found the word in the first place.) And nowadays "Unix" is not neutral: it is a specific implementation of the POSIX API and is in competition with GNU. The attached patch tries to dodge the issue entirely, as the main point here is Samba and not the operating system it's running on. > I would like to thank you for all other corrections to the > Tramp manual! You're welcome. I wish I had more time to help further. Perhaps some day I will. --------------090106060802060801090503 Content-Type: text/x-diff; name="0001-Improve-wording-for-SMB-support.patch" Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename="0001-Improve-wording-for-SMB-support.patch" >From 2bb79a750dfc71d1c10ffc55654755be280fc2b8 Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Sun, 24 Jan 2016 16:09:15 -0800 Subject: [PATCH] Improve wording for SMB support * doc/misc/tramp.texi (External methods): Improve and modernize wording for discussion of smbclient. There is no longer any need to mention the laundry list of old MS Windows implementations of SMB and CIFS, nor to mention CIFS. Also, give a URL for Samba. --- doc/misc/tramp.texi | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi index 14cd7fc..7bf2e53 100644 --- a/doc/misc/tramp.texi +++ b/doc/misc/tramp.texi @@ -851,11 +851,9 @@ External methods @cindex method smb @cindex smb method -This is another non-native @value{tramp} method. @command{smbclient} -connects to any server supporting the SMB/CIFS protocol, such as MS Windows and -Samba running on GNU/Linux. Tests show this @value{tramp} method -works with MS Windows NT, MS Windows 2000, MS Windows XP, MS Windows -Vista, and MS Windows 7. +This non-native @value{tramp} method connects via the Server Message +Block (SMB) networking protocol to hosts running file servers that are +typically based on @url{https://www.samba.org/,,Samba} or MS Windows. Using @command{smbclient} requires a few tweaks when working with @value{tramp}: @@ -863,7 +861,7 @@ External methods The first directory in the localname must be a share name on the remote host. -Since smb shares end in the @code{$} character, @value{tramp} must use +Since SMB shares end in the @code{$} character, @value{tramp} must use @code{$$} when specifying those shares to avoid environment variable substitutions. @@ -907,7 +905,7 @@ External methods behavior is unlike other @value{tramp} methods, where local user name is substituted. -@option{smb} method is unavailable if @value{emacsname} is run under a +The @option{smb} method is unavailable if @value{emacsname} is run under a local user authentication context in MS Windows. However such users can still access remote files using UNC file names instead of @value{tramp}: -- 2.5.0 --------------090106060802060801090503--