From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.bugs Subject: bug#37964: [PATCH] Remove references to obsolete libraries Date: Fri, 08 Nov 2019 14:10:53 +0100 Message-ID: <87eeyitswy.fsf@marxist.se> References: <83lft4r75y.fsf@gnu.org> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="34330"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: 37964@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Nov 08 14:13:21 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iT44m-0008lU-DY for geb-bug-gnu-emacs@m.gmane.org; Fri, 08 Nov 2019 14:13:20 +0100 Original-Received: from localhost ([::1]:54130 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iT44k-0002N1-Qv for geb-bug-gnu-emacs@m.gmane.org; Fri, 08 Nov 2019 08:13:18 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:51612) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iT43X-0001E1-Mg for bug-gnu-emacs@gnu.org; Fri, 08 Nov 2019 08:12:05 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iT43V-0000ph-UJ for bug-gnu-emacs@gnu.org; Fri, 08 Nov 2019 08:12:03 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:36120) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iT43V-0000pa-QK for bug-gnu-emacs@gnu.org; Fri, 08 Nov 2019 08:12:01 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1iT43V-0005O7-Ix for bug-gnu-emacs@gnu.org; Fri, 08 Nov 2019 08:12:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 08 Nov 2019 13:12:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 37964 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 37964-submit@debbugs.gnu.org id=B37964.157321866520630 (code B ref 37964); Fri, 08 Nov 2019 13:12:01 +0000 Original-Received: (at 37964) by debbugs.gnu.org; 8 Nov 2019 13:11:05 +0000 Original-Received: from localhost ([127.0.0.1]:44941 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iT42a-0005Mg-Mb for submit@debbugs.gnu.org; Fri, 08 Nov 2019 08:11:05 -0500 Original-Received: from host.gofardesign.uk ([208.79.239.190]:58973) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iT42X-0005M2-EH for 37964@debbugs.gnu.org; Fri, 08 Nov 2019 08:11:02 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=marxist.se; s=default; h=Content-Type:MIME-Version:Message-ID:Date:References: In-Reply-To:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=bRbOPoYJIS2kPQ8CHN5jWB2NgB9WBJB/wJCqmFMsHfk=; b=RkYsvTaTc6HcoYFWH1xZKGvAmU Mv8T89DOf57BHUe9bCY64Z8lkNx4BsYILHNO5h2AAPgXT+R7AY+clhXXXI3McfK1QLZ+1KcpNw15s EmHDfOzGIobQLqDHd/27nFBeYvgi8mqq0FwAGmVe0P28vADtWJZue7V8VJWc5f93SAPQ=; Original-Received: from h-70-69.a785.priv.bahnhof.se ([155.4.70.69]:33482 helo=localhost) by host.gofardesign.uk with esmtpsa (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256) (Exim 4.92) (envelope-from ) id 1iT42R-0005tz-AH; Fri, 08 Nov 2019 07:10:56 -0600 In-Reply-To: <83lft4r75y.fsf@gnu.org> (Eli Zaretskii's message of "Mon, 28 Oct 2019 21:39:37 +0200") X-OutGoing-Spam-Status: No, score=-1.0 X-AntiAbuse: This header was added to track abuse, please include it with any abuse report X-AntiAbuse: Primary Hostname - host.gofardesign.uk X-AntiAbuse: Original Domain - debbugs.gnu.org X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12] X-AntiAbuse: Sender Address Domain - marxist.se X-Get-Message-Sender-Via: host.gofardesign.uk: authenticated_id: stefan@marxist.se X-Authenticated-Sender: host.gofardesign.uk: stefan@marxist.se X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 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.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:171202 Archived-At: --=-=-= Content-Type: text/plain Eli Zaretskii writes: > Not sure if we should remove references to starttls etc. Does anyone > else have an opinion? My understanding was that we avoid recommending use of obsolete libraries. Both tls.el and starttls.el are obsolete in 27.1. The alternative to removing them would be to update it to say they are now obsolete, I guess? Please let me know if that is preferred. > The last part should be deleted if we are removing the starttls stuff, > because the "Lisp library" refers to it. Also, you have only one > space between sentences there. Thanks, I've fixed that in the attached patch. Best regards, Stefan Kangas --=-=-= Content-Type: text/x-diff Content-Disposition: inline; filename=0001-Remove-references-to-obsolete-libraries.patch >From eafc61090841ed1a825a45ffb1f058cd31380945 Mon Sep 17 00:00:00 2001 From: Stefan Kangas Date: Mon, 28 Oct 2019 17:33:22 +0100 Subject: [PATCH] Remove references to obsolete libraries * doc/emacs/cmdargs.texi (General Variables): * doc/lispintro/emacs-lisp-intro.texi (Lisp History): * doc/lispref/processes.texi (Network): * doc/misc/gnus-coding.texi (Gnus Coding Style): * doc/misc/gnus.texi (Oort Gnus): * doc/misc/smtpmail.texi (Encryption): Remove references to obsolete libraries. (Bug#37964) --- doc/emacs/cmdargs.texi | 6 ------ doc/lispintro/emacs-lisp-intro.texi | 2 +- doc/lispref/processes.texi | 13 +++++-------- doc/misc/gnus-coding.texi | 10 ---------- doc/misc/gnus.texi | 2 +- doc/misc/smtpmail.texi | 23 ++++------------------- 6 files changed, 11 insertions(+), 45 deletions(-) diff --git a/doc/emacs/cmdargs.texi b/doc/emacs/cmdargs.texi index b3d9af0baf..015ed3ae94 100644 --- a/doc/emacs/cmdargs.texi +++ b/doc/emacs/cmdargs.texi @@ -565,12 +565,6 @@ General Variables @item HOSTNAME @vindex HOSTNAME@r{, environment variable} The name of the machine that Emacs is running on. -@c complete.el is obsolete since 24.1. -@ignore -@item INCPATH -A colon-separated list of directories. Used by the @code{complete} package -to search for files. -@end ignore @item INFOPATH @vindex INFOPATH@r{, environment variable} A colon-separated list of directories in which to search for Info files. diff --git a/doc/lispintro/emacs-lisp-intro.texi b/doc/lispintro/emacs-lisp-intro.texi index 489ba8d6ef..b25b7ffa84 100644 --- a/doc/lispintro/emacs-lisp-intro.texi +++ b/doc/lispintro/emacs-lisp-intro.texi @@ -923,7 +923,7 @@ Lisp History in the 1960s. It is somewhat inspired by Common Lisp, which became a standard in the 1980s. However, Emacs Lisp is much simpler than Common Lisp. (The standard Emacs distribution contains an optional extensions -file, @file{cl.el}, that adds many Common Lisp features to Emacs Lisp.) +file, @file{cl-lib.el}, that adds many Common Lisp features to Emacs Lisp.) @node Note for Novices @unnumberedsec A Note for Novices diff --git a/doc/lispref/processes.texi b/doc/lispref/processes.texi index 5caf0a2426..9c200a0278 100644 --- a/doc/lispref/processes.texi +++ b/doc/lispref/processes.texi @@ -2426,18 +2426,15 @@ Network @cindex encrypted network connections @cindex @acronym{TLS} network connections @cindex @acronym{STARTTLS} network connections -Emacs can create encrypted network connections, using either built-in -or external support. The built-in support uses the GnuTLS -Transport Layer Security Library; see +Emacs can create encrypted network connections, using the built-in +support for the GnuTLS Transport Layer Security Library; see @uref{https://www.gnu.org/software/gnutls/, the GnuTLS project page}. If your Emacs was compiled with GnuTLS support, the function @code{gnutls-available-p} is defined and returns non-@code{nil}. For more details, @pxref{Top,, Overview, emacs-gnutls, The Emacs-GnuTLS manual}. -The external support uses the @file{starttls.el} library, which -requires a helper utility such as @command{gnutls-cli} to be installed -on the system. The @code{open-network-stream} function can -transparently handle the details of creating encrypted connections for -you, using whatever support is available. +The @code{open-network-stream} function can transparently handle the +details of creating encrypted connections for you, using whatever +support is available. @defun open-network-stream name buffer host service &rest parameters This function opens a TCP connection, with optional encryption, and diff --git a/doc/misc/gnus-coding.texi b/doc/misc/gnus-coding.texi index 6affea4872..240c795ac5 100644 --- a/doc/misc/gnus-coding.texi +++ b/doc/misc/gnus-coding.texi @@ -96,16 +96,6 @@ Gnus Coding Style @c As of 2005-10-21... There are no Gnus dependencies in this file. -@item tls.el -TLS/SSL support via wrapper around GnuTLS -@c As of 2005-10-21... -There are no Gnus dependencies in this file. - -@item pgg*.el -Glue for the various PGP implementations. -@c As of 2005-10-21... -There are no Gnus dependencies in these files. - @item sha1.el SHA1 Secure Hash Algorithm. @c As of 2007-08-25... diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi index 8ab1cf9f68..b4cf1613db 100644 --- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi @@ -27940,7 +27940,7 @@ Oort Gnus @acronym{TLS} wrapper shipped with Gnus @acronym{TLS}/@acronym{SSL} is now supported in @acronym{IMAP} and -@acronym{NNTP} via @file{tls.el} and GnuTLS. +@acronym{NNTP} via GnuTLS. @item Improved anti-spam features. diff --git a/doc/misc/smtpmail.texi b/doc/misc/smtpmail.texi index 7fa7b24e16..558f67fa7d 100644 --- a/doc/misc/smtpmail.texi +++ b/doc/misc/smtpmail.texi @@ -295,26 +295,11 @@ Encryption are: @code{starttls} to insist on STARTTLS; @code{ssl} to use TLS/SSL; and @code{plain} for no encryption. -Use of any form of TLS/SSL requires support in Emacs. You can either -use the built-in support (in Emacs 24.1 and later), or the -@file{starttls.el} Lisp library. The built-in support uses the GnuTLS -@footnote{@url{https://www.gnu.org/software/gnutls/}} library. -If your Emacs has GnuTLS support built-in, the function +Use of any form of TLS/SSL requires support in Emacs. You can use the +built-in support for the GnuTLS +@footnote{@url{https://www.gnu.org/software/gnutls/}} library. If your +Emacs has GnuTLS support built-in, the function @code{gnutls-available-p} is defined and returns non-@code{nil}. -Otherwise, you must use the @file{starttls.el} library (see that file for -more information on customization options, etc.). The Lisp library -requires one of the following external tools to be installed: - -@enumerate -@item -The GnuTLS command line tool @samp{gnutls-cli}, which you can get from -@url{https://www.gnu.org/software/gnutls/}. This is the recommended -tool, mainly because it can verify server certificates. - -@item -The @samp{starttls} external program, which you can get from -@file{starttls-*.tar.gz} from @uref{ftp://ftp.opaopa.org/pub/elisp/}. -@end enumerate @cindex certificates @cindex keys -- 2.20.1 --=-=-=--