From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Yuan Fu Newsgroups: gmane.emacs.devel Subject: Re: Tree-sitter introduction documentation Date: Fri, 30 Dec 2022 16:06:31 -0800 Message-ID: <5E14F981-7F40-40A7-8762-EEB7A6C7E8F2@gmail.com> References: <83edszjslp.fsf@gnu.org> <87tu1vxs3a.fsf@ledu-giraud.fr> <831qozjob7.fsf@gnu.org> <87cz8jxoat.fsf@ledu-giraud.fr> <83wn6ri7pn.fsf@gnu.org> <5e0a3185-de82-b339-0fa2-956779e63d6f@cornell.edu> <868rj6vfep.fsf@gmail.com> <4895891b-e5ea-9c37-f51b-df2e479ee758@yandex.ru> <83y1qt11xq.fsf@gnu.org> <9eb013da-d0fc-8e17-c6e3-1e8f913aebfa@yandex.ru> <83pmc50xxc.fsf@gnu.org> <71cfe4e8-3bb8-b0a6-9be5-8c0a6d92cfab@yandex.ru> <83h6xg29z3.fsf@gnu.org> <87wn6cyey5.fsf@posteo.net> <787B1EB4-1925-4679-8747-449DCD685432@gmail.com> <83y1qo6h7a.fsf@gnu.org> <874jtc99b0.fsf@posteo.net> Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3696.120.41.1.1\)) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="9554"; mail-complaints-to="usenet@ciao.gmane.io" Cc: Eli Zaretskii , monnier@iro.umontreal.ca, dgutov@yandex.ru, theophilusx@gmail.com, emacs-devel@gnu.org To: Philip Kaludercic Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Dec 31 01:07:07 2022 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 1pBPP0-0002Db-El for ged-emacs-devel@m.gmane-mx.org; Sat, 31 Dec 2022 01:07:06 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pBPOe-0000n8-9I; Fri, 30 Dec 2022 19:06:44 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pBPOc-0000mo-A5 for emacs-devel@gnu.org; Fri, 30 Dec 2022 19:06:42 -0500 Original-Received: from mail-pl1-x633.google.com ([2607:f8b0:4864:20::633]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pBPOW-00081N-8P; Fri, 30 Dec 2022 19:06:41 -0500 Original-Received: by mail-pl1-x633.google.com with SMTP id d9so6598092pll.9; Fri, 30 Dec 2022 16:06:35 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=to:references:message-id:content-transfer-encoding:cc:date :in-reply-to:from:subject:mime-version:from:to:cc:subject:date :message-id:reply-to; bh=JnJ/mDuefpZiIAJ2Bfeq5yHuGh71/IhCl+X331SzCG4=; b=XGzTJXZOLKswIbcqBT5SOUkm9CvRgi9QtUdcn6odseGMj2MoTerWDGTxJG1AwJLclV U6BLVQPrkoDarcXAKXeYgb0JKlwc6hc6Sn2drFbkVFsiHeBSHlm6fHzhFiQIoPTTxiqh FGGTGLkHOd0aVBFRWMxt6fK45Stbsbovl1uZhViurORg9XZbEjp7HRX4t5fzKm3u8ZMm 1Q8ehz9IQRXwtb/iyPhikPm7E4s2iJf1rdfrHzgcHhjngBiy2nOzMNGdXOt/3/yrtTWY f5/MyCVPipC5hdA6cFm2W9C8G10InkpaFJRLpSMHQAkKVqWyQB5wDMD44QSScQa5fB6R HiKw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=to:references:message-id:content-transfer-encoding:cc:date :in-reply-to:from:subject:mime-version:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=JnJ/mDuefpZiIAJ2Bfeq5yHuGh71/IhCl+X331SzCG4=; b=oZSI3XwnrIaprbDYPSi9crfpeH6K3jQg898vJX1PUGsoFt80fQ3bvT0GAQUj+7e7Pq VSux+reEdyIIQclRm34bfPkQg0dvbWt3esm1TNOlhVvsMaAZPxzsX3MC4qcvnOCOD6Yt 5w/ui/+p9o4EtFeCXvW/ImEWWfEAcif1glrjqzya2GNTOLxnzWwm9qma6UvkWj28wjIQ e0+YhJFe75rDUgSYnaeTSIGkSCHiV8OqMW/FVEshme0jJsSNkuT5XshYaxQVGpVB3dZv X6jyPr5OPpKYlxLXvi9bp+9RxyFwmJB0+WuSIk15cVsfxl1WRaVMnhhpIu5OHMScEAyv hVcQ== X-Gm-Message-State: AFqh2kqYqpSLlXq5J7kYLs42zeZ6qdeUJnbdqViOaNp50eAlLHAYhwAl 1KemBwusx6IS2RVi4bGIYdo= X-Google-Smtp-Source: AMrXdXsZpOW1efR/0LZ4+HBdwqFjXBOrMakc0hykCrrHSnNjg3bqtdYACdyIktCdKh0f65HZRvS34g== X-Received: by 2002:a17:902:e054:b0:189:fba2:3756 with SMTP id x20-20020a170902e05400b00189fba23756mr31038374plx.66.1672445194356; Fri, 30 Dec 2022 16:06:34 -0800 (PST) Original-Received: from smtpclient.apple (cpe-172-117-161-177.socal.res.rr.com. [172.117.161.177]) by smtp.gmail.com with ESMTPSA id b18-20020a170902d51200b00188f6cbd950sm15501999plg.226.2022.12.30.16.06.33 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Fri, 30 Dec 2022 16:06:34 -0800 (PST) In-Reply-To: <874jtc99b0.fsf@posteo.net> X-Mailer: Apple Mail (2.3696.120.41.1.1) Received-SPF: pass client-ip=2607:f8b0:4864:20::633; envelope-from=casouri@gmail.com; helo=mail-pl1-x633.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 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-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:302141 Archived-At: > On Dec 30, 2022, at 7:54 AM, Philip Kaludercic = wrote: >=20 > Eli Zaretskii writes: >=20 >> (message "Cloning repository") >> ;; git clone xxx --depth 1 --quiet workdir >> (treesit--call-process-signal >> "git" nil t nil "clone" url "--depth" "1" "--quiet" >> workdir) >>=20 >> Why "--depth 1"? This should be a defcustom, and the default should >> be to clone the full repository, IMO. Also, what about updating the >> library when it is already installed, and the Git repository already >> exists for it? Or are we going to clone anew each time and them >> remove the repository? that could make its cloning be slow in some >> cases. >=20 > I have proposed just downloading a tarball. GitHub provides these for > each tag, and the tree-sitter developers appear to tag versions on a > regular basis. The file could then be downloaded via url.el instead = of > using Git. >=20 > = https://github.com/tree-sitter/tree-sitter-c/archive/refs/tags/v0.20.2.tar= .gz Not all language grammars would bother to make a release[1]. The = fallback method better support as many cases as possible. [1] https://github.com/elixir-lang/tree-sitter-elixir Yuan=