From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Ergus Newsgroups: gmane.emacs.devel Subject: Re: Some developement questions Date: Sat, 25 Aug 2018 12:34:13 +0200 Message-ID: <20180825103413.gbm5stsl67j6weow@Ergus> References: <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> <87k1oeaofu.fsf@ada> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii; format=flowed X-Trace: blaine.gmane.org 1535193190 4989 195.159.176.226 (25 Aug 2018 10:33:10 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 25 Aug 2018 10:33:10 +0000 (UTC) User-Agent: NeoMutt/20180716 Cc: hw , Eli Zaretskii , emacs-devel@gnu.org To: Alexis Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Aug 25 12:33:06 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 1ftVsO-0001AK-Tn for ged-emacs-devel@m.gmane.org; Sat, 25 Aug 2018 12:33:05 +0200 Original-Received: from localhost ([::1]:45276 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ftVuS-0004Ib-CK for ged-emacs-devel@m.gmane.org; Sat, 25 Aug 2018 06:35:12 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:37068) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ftVtk-0004IU-5P for emacs-devel@gnu.org; Sat, 25 Aug 2018 06:34:29 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ftVtf-00063B-0i for emacs-devel@gnu.org; Sat, 25 Aug 2018 06:34:28 -0400 Original-Received: from sonic301-21.consmr.mail.ir2.yahoo.com ([77.238.176.98]:44625) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1ftVte-00062N-NM for emacs-devel@gnu.org; Sat, 25 Aug 2018 06:34:22 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=aol.com; s=a2048; t=1535193261; bh=8hxi/GxxjxgJZLWTDb2LXVZGEwtQ1dE3vvGfcC9oPAQ=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From:Subject; b=RzCo5VwKbALT1ZY0xc+BtlJ8PxFJh3VABp2xkkTs2Xf/adRdfR27UOYSPJ9BGBZLWAnGaPzTDoq/70oUgT7l8D0gHZbN9LG61wkcrWnBa5sl04Fs9aAq2/4B+6m1MeWooLjn+nUAAFcah3TATEBdBFq976lEJSmXkDf0BluQzjcArWpQxhezRIXTJvIzCDVkOBPsfJpiVsz0e4HnbD75DOUU/jjP9I51DVGZ+c2z9abNfRcwvw2XsTgcUg5rQ1i+M04il2mk/nn+GpzLAhbHPQUfBgbZlNt6l0SUtaEPYNvelrpnsaibtWC6VCoMKhJs6lG2o+zGLvw/VhobmuNFqQ== X-YMail-OSG: ZKYGWU0VM1mG05oemC7jO9lD_Or7Vv.IChNozS3rFBP2AhgKO2br0p2mZQrY2BU 2o2LMJLiyzVRl7Gob1GtJr4BX4LKRJkUe5XvQOTeLcM46K4JvIDIRUdBOf47tDuyvvcBVVmu5w4s 8msPxCWRg7EWapIdRr0OXZDljqSv4fcHXAJdsHDBhbYh4BHSb.CO.ohslhGiVIFvmyCHLwHiAWPT 34IsUiazAyuoktYBsIk5oA4IGZ2B49SApCWGIiPjta2_MNI8FmEoB6ghGjdgHoQzAhJ9T2CiAnNi 0nqQd6vqrIgPK.UeVPBwonAHQxUzxEPCVkrtluAxPfp.Bbve8Ovyf4c8pi.BUrNmyIre15rum46D OuZmzrYEedVOjRzdoY_OskmTRlAL81mILRFDRpS1EnZDFQ60jM72BsZSoYp6lzlS6P1QqDaAA_M. lusiQj_zdmy41TyYJDQcsx3rqGWw49d2IrrT3z02dvEMFihpIiVq8fDZktO_FjLrs9Aml3CWrD9Q ASq44aA1jX9ErcGXF0rZXk.tNM1mHekwGIrK8.PtQNc4.DneX3qD4tfyu2E6I2GU1np7RNAvrmqF zswUWIGDEem24FRIraMLNgpnBbAWYrZ.Vnn6TVOq9UDNII8v3k2npcIdiSUDMsy3BilDzMtUXlJH VYyXhHADGG.V2boxCpg1eFtYkWcm1sd1ZVnz88fVN1wzI9lh8vPic_DUXGGFQxZOSmxuXee8tcwo b7wCaU0KZTDqzHk3rPazWRBFp149yOHZPi2mXH0skb9ssIr.cekFhHo3B5.a7f01Wk82sYitFcKq otb7g_sU9j6c0zgS9hf9g4.wsI35VW9B_XtRDwggmf Original-Received: from sonic.gate.mail.ne1.yahoo.com by sonic301.consmr.mail.ir2.yahoo.com with HTTP; Sat, 25 Aug 2018 10:34:21 +0000 Original-Received: from 2.152.205.184.dyn.user.ono.com (EHLO Ergus) ([2.152.205.184]) by smtp408.mail.ir2.yahoo.com (Oath Hermes SMTP Server) with ESMTPA ID 1c0c3a32a78b6aa446c73ae7b94f2bd1; Sat, 25 Aug 2018 10:34:18 +0000 (UTC) Content-Disposition: inline In-Reply-To: <87k1oeaofu.fsf@ada> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 77.238.176.98 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:228895 Archived-At: On Sat, Aug 25, 2018 at 05:35:33PM +1000, Alexis wrote: > >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. > If the messages are just printed in the message buffer it shouldn't impact too much the startup time I think. >>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. > You are right, emacs documentation is awesome... once you understand how to get there and how it is organized, the name of the package or the functionality you want to configure and how to use the indices. Newer users will go straight to google/duckduckgo to make the questions. Not only because they don't know exactly the name of what they are looking for, but also because that's the stackoverflow's culture. In the beginning they just want some code to copy and paste in the config. There are not emacs foros either, the closes we had were some reddit posts from more than 2 years ago. And the mailing list really feels so 1995. So when a user configures or find a solution, there is not a central place to share his tweaks/work/corrections/worksaround, and where the developers could get opinions about what to improve, or what "defaults" are changing most of the users. So basically the information is not flowing as it should in all the directions (developer/mainteiner - experiences user - new user - potential user). Another consequence of this is that newer users will report miss configured features or solved problems as bugs that are never solved, or they feel intimidated/disapointed to do it. Maybe it is already corrected, fixed or a work around exists, or another user knows how to fix quickly but the issues list grows infinitely and all the work goes to the developers. >>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. :-( > This is one of the reasons I made my first questions. Because I don't know what package to use in the list of options when multiple packages offer the same functionality. I just mention some of them in a previous message. But from the project point of view, sadly there are not as many developers as they used to be, so maintaining two or three similar packages for exactly the same is a waste of man power and a source of incompatibilities and conflicts with other packages (and so on recursively because fixing it requires then more man power). Example: When I started using emacs most of the recommendation were to use flycheck instead of flymake because it was supposed to be a replacement for the last one. 5 years later, in the latest release they have touched flymake and now I don't know if I should migrate back or not, or why there are people putting effort in flymake instead of flycheck. But the worst is that some plugins are available only in one of them (same in auto-complete vs company) since ever. This is the kind of problems that stagnates big projects and disappoint developers and users. > >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.