From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Dmitry Gutov Newsgroups: gmane.emacs.devel Subject: Re: master 1e3b0f2: Improve doc strings of project.el Date: Sun, 12 Jul 2020 03:48:52 +0300 Message-ID: <294212ed-5a6e-0a7f-e1c2-97e917f1e6e1@yandex.ru> References: <87bllfqj82.fsf@warpmail.net> <831rmayj55.fsf@gnu.org> <6dc2c2ac-8e17-f044-dc78-8c109f936ad2@yandex.ru> <83wo42w83e.fsf@gnu.org> <6762abf5-71c1-aa54-1bac-d4c90c20870b@yandex.ru> <831rmavsuq.fsf@gnu.org> <83a70wv4mj.fsf@gnu.org> <5542db0c-cc0d-2743-87ae-7728a0cc94bb@yandex.ru> <83ftaf2rj2.fsf@gnu.org> <43a8f8d4-83fb-f012-8e1d-c1a618b0ef59@yandex.ru> <83mu4m0vub.fsf@gnu.org> <44f2f1f4-ae34-f0bf-b153-f33b8ee6069f@yandex.ru> <83mu4fvjh3.fsf@gnu.org> <7c2e93d4-8d86-bbbb-77a0-bf5d73051907@yandex.ru> <83imf2t4w4.fsf@gnu.org> <95fd893e-0da5-4cdc-a3e8-3c22af750aae@yandex.ru> <837dvfs6wg.fsf@gnu.org> <8bc1f381-248f-5cee-c3c6-a29d411a2f74@yandex.ru> <837dvbphs0.fsf@gnu.org> <83365zp78d.fsf@gnu.org> <831rlipmgg.fsf@gnu.org> <83lfjqnsa6.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="26793"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.10.0 Cc: philip@warpmail.net, theo@thornhill.no, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Jul 12 02:49:30 2020 Return-path: Envelope-to: ged-emacs-devel@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 1juQBO-0006sK-5V for ged-emacs-devel@m.gmane-mx.org; Sun, 12 Jul 2020 02:49:30 +0200 Original-Received: from localhost ([::1]:40792 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1juQBN-0007rk-5d for ged-emacs-devel@m.gmane-mx.org; Sat, 11 Jul 2020 20:49:29 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:43614) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1juQAu-0007R8-4j for emacs-devel@gnu.org; Sat, 11 Jul 2020 20:49:00 -0400 Original-Received: from mail-wr1-x42b.google.com ([2a00:1450:4864:20::42b]:42633) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1juQAs-0006Fa-8E; Sat, 11 Jul 2020 20:48:59 -0400 Original-Received: by mail-wr1-x42b.google.com with SMTP id o11so9481077wrv.9; Sat, 11 Jul 2020 17:48:57 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:subject:to:cc:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=xo5Y0P/GYcNjrezZiBnYvm75Tsa7/IG4e2pNkAduD4k=; b=LCyp4692+eWsnJ1uJF6GoUDEXuJTEYXuNgJJv9kDFOCTgQwOFeryM9m40MVGzRlUWu 8P4TlK0ev9y1Lx/s/FcQgReMb3jKSqVyeMADrfjQZscPIPOqLlSiz+1Dv1Xe9MPZJ6Ud qKriNYIlQKG7Eu4pJMX8yvya9p9vFxMG+RNVd+yMJjeYYgMoHkcGUZxkg8d1VoUEmRvP swfpqYYL8S+tu/GnZdby1Sdtl7SwLyrLIQQEnRLe8l2qKDw24WYoKSikqnCpNnVuyYCS N2TMIOpccYmis1mrXtkjQYZgPLNHUEoixQG0gfR1yKUKltJ7XmwoqvWeSfL8U5wHLsgd vXiw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:subject:to:cc:references:from:message-id :date:user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=xo5Y0P/GYcNjrezZiBnYvm75Tsa7/IG4e2pNkAduD4k=; b=b1vhgD6+TSrEd2A0VDmro6TkRDF7xa8sk5nHqZFXha/ylMiGS+ouKLkE8h7Wfd6aMl vqsg1OWfUsTSbuOiFirDxDjvHizmJjgm904N/KgB1/6bWxhKLUHXX6ERekCH7w754MoP CaMU39w1+LI3pHvs/ZmHvPf7dG4BE/hBQLRc/SxdvDmKcahdD6VwzRk1lOWdh1ABdCpD j5+bokoL8EJhbovAoE2wYDq3KMJfUsjc9PCvP5N0ytOt1RuROI8EAbzMUdc6Jh6mj1dF 33nKCnqsE43x5oJfR7YtEsXiU++XAkqGvYJ12mdB298BpokvM6y88Bwr1lk54Y6hqwY/ GRyw== X-Gm-Message-State: AOAM531CiR2wVn0ZP1w1+9skRu7jzYFPXxUFtBpZkCcoXQmSIuzMIGj4 GL9XTRUEPOt5422ajnstfTRnAfGI X-Google-Smtp-Source: ABdhPJxAN07vlstpqQdKWiOQgjstDcZuNuiBDXQfpfV/UVvIsKMg7hb+R672BNNRxFkYbm6/dP56Ag== X-Received: by 2002:adf:dd8d:: with SMTP id x13mr72426367wrl.362.1594514935618; Sat, 11 Jul 2020 17:48:55 -0700 (PDT) Original-Received: from [192.168.0.3] ([66.205.73.129]) by smtp.googlemail.com with ESMTPSA id j24sm17026900wrd.43.2020.07.11.17.48.54 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sat, 11 Jul 2020 17:48:54 -0700 (PDT) In-Reply-To: <83lfjqnsa6.fsf@gnu.org> Content-Language: en-US Received-SPF: pass client-ip=2a00:1450:4864:20::42b; envelope-from=raaahh@gmail.com; helo=mail-wr1-x42b.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: 0 X-Spam_score: 0.0 X-Spam_bar: / X-Spam_report: (0.0 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FORGED_FROMDOMAIN=1, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 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-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:252873 Archived-At: On 11.07.2020 15:35, Eli Zaretskii wrote: >> Take a random modern editor, open an existing project in it (it will >> show up in the side panel, usually). Then create a new file in its root >> directory using some external means. If it's not ignored by existing >> configuration, it will automatically show in the project drawer as well. >> >> We should support that. > > As long as it makes sense, yes. But when it starts requiring us to > jump through hoops, we don't need to be afraid of doing things > differently. It's a quality of life feature. Of course, we could forgo it, or ask the users to jump through hoops themselves on occasion. Anyway, sounds like there are no better "universal" options at hand than filenotify. I'll try to whip up a prototype with it one of these days. >> Like I said, you're welcome to suggest a better phrasing, for this and >> the other command (as long as the descriptions remain accurate). Go >> ahead and commit the new versions, if you like. > > Done. Thank you. I've scaled back the explicitness a little: we don't need people to rely on (or try to replicate) the exact format of what project-try-vc returns. We have enough trouble with user-defined functions returning (cons 'transient some-root-dir) already.