From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Alexis Newsgroups: gmane.emacs.devel Subject: Re: Some developement questions Date: Sat, 25 Aug 2018 17:35:33 +1000 Message-ID: <87k1oeaofu.fsf@ada> References: <444779489.8504194.1534538988289.ref@mail.yahoo.com> <444779489.8504194.1534538988289@mail.yahoo.com> <83sh3cfb3t.fsf@gnu.org> <87sh36inql.fsf@himinbjorg.adminart.net> <8336v6cvem.fsf@gnu.org> <8736v6icgt.fsf@himinbjorg.adminart.net> <83tvnmb958.fsf@gnu.org> <877ekigiiw.fsf@himinbjorg.adminart.net> <837ekhb2me.fsf@gnu.org> <87zhxcbmtr.fsf@himinbjorg.adminart.net> <83in409lub.fsf@gnu.org> <871sanb71j.fsf@himinbjorg.adminart.net> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; format=flowed X-Trace: blaine.gmane.org 1535182430 13446 195.159.176.226 (25 Aug 2018 07:33:50 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 25 Aug 2018 07:33:50 +0000 (UTC) User-Agent: mu4e 1.1.0; emacs 26.1 Cc: Eli Zaretskii , spacibba@aol.com, emacs-devel@gnu.org To: hw Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Aug 25 09:33:46 2018 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ftT4r-0003Nk-CM for ged-emacs-devel@m.gmane.org; Sat, 25 Aug 2018 09:33:45 +0200 Original-Received: from localhost ([::1]:44885 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ftT6x-00010c-I6 for ged-emacs-devel@m.gmane.org; Sat, 25 Aug 2018 03:35:55 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:53180) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ftT6o-00010W-K4 for emacs-devel@gnu.org; Sat, 25 Aug 2018 03:35:47 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ftT6n-0004G7-Nk for emacs-devel@gnu.org; Sat, 25 Aug 2018 03:35:46 -0400 Original-Received: from mail-pl1-x62d.google.com ([2607:f8b0:4864:20::62d]:41448) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1ftT6i-00047l-3W; Sat, 25 Aug 2018 03:35:40 -0400 Original-Received: by mail-pl1-x62d.google.com with SMTP id p4-v6so2008723pll.8; Sat, 25 Aug 2018 00:35:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=references:user-agent:from:to:cc:subject:in-reply-to:date :message-id:mime-version; bh=rD3WWxdWm8tIB/WElND8HyYusML9ZJNb/6BSTkyVlNQ=; b=h05gI33YOE8c3ONMvcBO+XYV5V2u3tL/0tNkAbofZ21ekahi+8TUjqLSwd0wreYBvd wMoPWGUnSe6+4R8vr0gdEk1F1klupoeA9VRb4rQTg1vSbMGeAxCRRwNM2QZROB2hs4fB XdEXYET0y2pcQLWwMg8b8YWb8CkMw5y4ReZcyno8lLV3iBkBRlt/3kW9oMioHW/n2zbq E4DwJ2028nXB90wk0cmhuiT+BTnLUR4mXm0cS42SMKpkmRIvl569iEyRc5Xw1I8g3VIP zZJAhEMXevTLF4+Il0qsYyqWCz24hiO3u4OOMlU4yGioRys4v5RiEdj4iHadQOv/52IR fEUA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:references:user-agent:from:to:cc:subject :in-reply-to:date:message-id:mime-version; bh=rD3WWxdWm8tIB/WElND8HyYusML9ZJNb/6BSTkyVlNQ=; b=dVxT3QH+4CFyBIsr9m9BD8hapz3G+VXtOcB7clo2oC4RyzmnCg+B/p7CqnsOeH/Bm9 nfR6/wqU7WhK31pE9N8E/H81AmO/haZ02js6YrGz8VI7DH/wNWyVtRrQP0LiUNgRcSOK yFxjS2/u1kL6wKzROFOpfZB1CFb+k3tTOleMcYdbsuqdj+YwKcIbH/GPs5QXRjXK0ZaI j6S8GqzSE5YyJ3rFjlCVXM/Kj6LcjVIfjPYwPSonxhOuUri2A5W6TOwoDkMiv9bJYr24 WTeuuC7/+mz8gCEltrS2U/+CqGv5L4QqlGA3Bnm2okE5TC5z7obmWolNs+V/OnwsDlZc a1/A== X-Gm-Message-State: APzg51DwVNcm4nrbMO62rnqE3Yk+Xs3QfFbhTx7b0iLm0EJco3kxb/AZ dpOTCFkCrxWTBHVSDNTEqN+a1hv9 X-Google-Smtp-Source: ANB0VdYDdlvlPWRhC+wW1qdfXxcaW+fTcfQmDW3WNNXny0P9K+auoSLsSl3o+r3S/+1MV1D/s+O5Tw== X-Received: by 2002:a17:902:d688:: with SMTP id v8-v6mr4689304ply.278.1535182538877; Sat, 25 Aug 2018 00:35:38 -0700 (PDT) Original-Received: from localhost ([60.224.133.205]) by smtp.gmail.com with ESMTPSA id d19-v6sm10407684pgv.61.2018.08.25.00.35.37 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Sat, 25 Aug 2018 00:35:38 -0700 (PDT) In-reply-to: <871sanb71j.fsf@himinbjorg.adminart.net> X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2607:f8b0:4864:20::62d X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 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" Xref: news.gmane.org gmane.emacs.devel:228888 Archived-At: hw writes: > Maybe Emacs should give us warnings when it discovers outdated, > deprecated or useless settings in ~/.emacs. i imagine many people might want this; but many people might /not/ want this if it has a noticeable impact on startup times. Startup times don't usually have an impact on me personally, since i run an Emacs server at machine startup and connect clients to that. From what i've read, however, a number of people find even an extra 0.5s-1.0s in startup to be significant when jumping in and out of a non-client Emacs instance. So if this feature did have an impact on startup times, people would want to be able to enable and disable it at will. > get into documentation hell because it's hard to tell which > documentation is up to date One of the pleasures i find in using Emacs is its extensive accompanying documentation, documentation which (in my experience) is typically far better maintained than that of many other projects[1]. As someone who has been using Emacs for around 20 years, i very much appreciate the comprehensive NEWS file with each release, which allows me to quite quickly ascertain what changes have been made that might affect my configuration and workflow (e.g. changed default values). i say this because i'm wondering which area(s) of documentation you're having these difficulties with? If you're talking about the Emacs Wiki at emacswiki.org, well, as far as i'm aware, that's not an official wiki, is it[2]? Nor is wikemacs.org. i personally much prefer the latter to the former. But i strongly feel that people's first destinations when searching for documentation should be the Emacs Manual and the Emacs Lisp Reference Manual - only after not being able to locate the information in those manuals, making sure to make use their excellent indexes, should one consider trying to find information on the two wikis. i regularly find myself responding to "How do I do X in Emacs?" questions with "Here's the relevant section of the relevant manual." At any rate, one should certainly consider submitting a bug report about inadequate or inaccurate documentation for functionality shipped with Emacs. Even if no volunteer can immediately address it, at least it's recorded as something for potential volunteers to work on. > I had auto-complete working (until I disabled it because it got > into my way by trying to automatically complete everything when > I used Emacs for something I didn't install auto-complete for), > installed from a git repo somewhere on github. Do you literally mean the `auto-complete.el' package and its associated `ac-*' packages? Is that still maintained? i'm using `company` as my autocompletion framework, myself. But neither is shipped with Emacs, and there's no index entry for `auto-complete' or `autocomplete' in the Emacs Manual, which probably comes as a surprise to the many people who have come to expect autocompletion as basic functionality in a programming environment .... i think this is indeed a problem, but unfortunately, i don't have any suggestions as to how it might be addressed. :-( Alexis. -- [1] OpenBSD is probably the other project i think of when thinking of excellence in documentation. Comparing `man 4 intro' for the Linux kernel vs. `man 4 intro' for the OpenBSD kernel is eye-opening. [2] i have the impression that many people assume it /is/ an official Emacs wiki, so if its not, this fact might need to be somehow emphasised or made more clear.