From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Dmitry Gutov Newsgroups: gmane.emacs.devel Subject: Re: master 1e3b0f2: Improve doc strings of project.el Date: Fri, 19 Jun 2020 17:23:36 +0300 Message-ID: <14ebab54-324d-8c59-f8de-1bb7e0ef7c6b@yandex.ru> References: <20200619075401.21856.16524@vcs0.savannah.gnu.org> <20200619075402.CE1D220A27@vcs0.savannah.gnu.org> <243920e8-f660-fac9-00d6-1bcecde91e39@yandex.ru> <831rmbz4ak.fsf@gnu.org> <41c3e63e-7006-c89d-0812-643731a88d39@yandex.ru> <83r1ubxm1x.fsf@gnu.org> <46c34dab-c95f-45ea-50ee-f0e023a70e74@yandex.ru> <83pn9vxi73.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="ciao.gmane.io:159.69.161.202"; logging-data="4685"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.8.0 Cc: philip@warpmail.net, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Jun 19 16:26:12 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 1jmHy8-000173-Kd for ged-emacs-devel@m.gmane-mx.org; Fri, 19 Jun 2020 16:26:12 +0200 Original-Received: from localhost ([::1]:52046 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jmHy7-0004Mt-FO for ged-emacs-devel@m.gmane-mx.org; Fri, 19 Jun 2020 10:26:11 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:36762) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jmHvi-0001CP-8u for emacs-devel@gnu.org; Fri, 19 Jun 2020 10:23:42 -0400 Original-Received: from mail-wr1-x431.google.com ([2a00:1450:4864:20::431]:43219) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jmHvg-0006kC-6D; Fri, 19 Jun 2020 10:23:41 -0400 Original-Received: by mail-wr1-x431.google.com with SMTP id l10so9864982wrr.10; Fri, 19 Jun 2020 07:23:39 -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=MBXU7L6QpUbjv1hQUd8gPFyx8YAS8gRAKGTAA1Z4tr8=; b=nbRtogdTg5ZCnqifPv/7UvU6decfXbK0bHXmyqEzLQmr/7zzfiJOZvaGX8JO2qSudy Gf+slKO5IO8HxfBDaDDP1lNjbMDzbzOSF4XxgDyH0+LYq6vz6q+pp3IGZ2e+WFmSCe9I /xdZkRsWCDbM9gRK5dXTi7YFz7SiCbZk7Td7i21uFAx8FLqc9uYurRVAVJPylQWWOUAv 7gln1K3i3m6lUwbxysl9OJ9XXgpSUY9bPDmX2VwUmZ8q/4qFJUAVNm5eDYgAFjDqE6Us uXT3ebfgRKm+ArRgh+vNNBC8dbenoLoFBwf6QoBVN1FPeYxzDK/kT41akJiqbksAPyMh 1TCw== 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=MBXU7L6QpUbjv1hQUd8gPFyx8YAS8gRAKGTAA1Z4tr8=; b=KeJks0eWueeNNwdGJu7cAG46m9fH32ziWdym9fjz4R2DAveAcKaWCsohbu6aU7tpiY FxAD1LGYUrFDFZwkZDaw3xUeMtAp03VWfjEDdEiJVxrjWBtOFv80TkJcF4IWty/U+FRj M3KgotNY5q6P9SIyqjvM2VcWh3OBcEuyiKJZBqYa1fY9DycQItUjcKUxMruZVMGLsdis iliGGHxmrfPSiEweIPEtRWE6YHzCXbvTiNnulo7ZqkrbGtNe8vPfPv27tbqISodQF3UU SZAXFhmR0YC5MxNXkex6eY+5d3mDs31E2ehoahTbfWxPmSpRjSXTHQcpFM92YsYb5NAQ NRYQ== X-Gm-Message-State: AOAM530Q2S9b20l3dwAQzlW2c4gAO04bOpb/NdLfpZUjgTW4EoBAPG+S +vxDPg/BRPGOsThmy8BdRYM= X-Google-Smtp-Source: ABdhPJzrCyIP5fECUPzVbOeeG5kIc0Dn+F9z665i1rksHFLBeCTugeAev7mc6Y8NhGuZFIQF+XuS7A== X-Received: by 2002:a5d:5341:: with SMTP id t1mr4640818wrv.207.1592576618002; Fri, 19 Jun 2020 07:23:38 -0700 (PDT) Original-Received: from [192.168.0.60] ([109.110.245.170]) by smtp.googlemail.com with ESMTPSA id o1sm7687982wrw.20.2020.06.19.07.23.36 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Fri, 19 Jun 2020 07:23:37 -0700 (PDT) In-Reply-To: <83pn9vxi73.fsf@gnu.org> Content-Language: en-US Received-SPF: pass client-ip=2a00:1450:4864:20::431; envelope-from=raaahh@gmail.com; helo=mail-wr1-x431.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=_AUTOLEARN 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:252357 Archived-At: On 19.06.2020 17:07, Eli Zaretskii wrote: >> If you look at bug#41868, it mentions VC-Dir and Dired buffers. Perhaps >> Philip also has other examples. > So will something like the below do the job? > > Switch to another buffer related to the current project. > A buffer is related to a project if its `default-directory' > is inside the directory hierarchy of the project's root. Sounds good. Except some projects can be inside one another, too. > Btw, AFAIU this command can prompt for a project's root, but the doc > string doesn't mention that important fact. That is the case for all of the commands in there. >> It also cleans up some "invisible" buffers created to service the files >> in the project, such as ones created by Flymake, etc. > By "it" what do you mean here? you don't mean > project-switch-to-buffer, do you? And if so, how is that related to > the issue at hand, which is the doc string of that function? Sorry, got my wires crossed: this was about project-kill-buffers. But the rest of the discussion should apply to project-switch-buffer just as well. BTW, I imagine that the current project-kill-buffers docstring should seem ambiguous to you as well.