From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Pedro Andres Aranda Gutierrez Newsgroups: gmane.emacs.devel Subject: Re: Tree-sitter doc question Date: Sat, 10 Dec 2022 08:29:08 +0100 Message-ID: References: <83y1rgzsk4.fsf@gnu.org> Mime-Version: 1.0 Content-Type: multipart/alternative; boundary="0000000000005d217005ef743bd7" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="1095"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Dec 10 08:30:19 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 1p3uJP-00005L-74 for ged-emacs-devel@m.gmane-mx.org; Sat, 10 Dec 2022 08:30:19 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1p3uIn-0008Ew-4M; Sat, 10 Dec 2022 02:29:41 -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 1p3uIk-0008ES-Uf for emacs-devel@gnu.org; Sat, 10 Dec 2022 02:29:39 -0500 Original-Received: from mail-oa1-x30.google.com ([2001:4860:4864:20::30]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1p3uIj-0000Qf-2X; Sat, 10 Dec 2022 02:29:38 -0500 Original-Received: by mail-oa1-x30.google.com with SMTP id 586e51a60fabf-144b21f5e5fso2392694fac.12; Fri, 09 Dec 2022 23:29:35 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=GzmBpYm1azo7YgpKz/GqU8lADLOVItvHcib+R4+mDMY=; b=DMk8Bvq9vOaoJ3C43JOj9juI9NKnA18TSQTzHnAWRhkwuXmLF4DixPvKUJ5cF4RsCT 5hOqLuqk4Eow3FhgaV7PexiQ6siLEmUuR9STrSV8R2vYgxuQ9l+6Ujp0HrCyI+/JacJW c/Yebh7sB/R8+0M0oMV46q8XWqMpXax8B1JsSb2wqKJJqEIhbiMxT/yrNpCvaC2038fd wsGv4HekPIrIGs+xA851u5tF8p8RK8W50FEiw+ldRt1shN5VHmmlOGEVt2mk24dZY8I0 gdgWIL+5ZqhKDT/s4s5saL1pL4AcWa3qBpZv/6wDTKwYc69sCxPsBoLvhBiWKTEEuyFt 6zOw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=GzmBpYm1azo7YgpKz/GqU8lADLOVItvHcib+R4+mDMY=; b=PLTDo7Ac4tgWMOZqJO8kpjizz3jzZcs4rk0lj5iIVGvimXjTUW/QtwWZI+66cfW1Un V8mRfyeTtm3khEgTcF7KFk8lQse9ZA+8X8wMEgRS6G9DghWzLNfo7egzNJZYc8uKqQKe Dox0nXjOvo+fAr3nUI6NRNgx/+uDWAPuspxsDrrMck1bPfo2vU2li+QOBduOPvSpWmdw p/qH2dLrsTCXJTqCTYw2T7tiUl7nk6T+iMrTl+qWF8UbyoiyiV0CCQwp8GCl2RWRtct/ j8R7CFbXXyQydkv7jN1A0yJ1RFn107DgIpS0Ekf9rN4NzZxgMg0br+KRaYv0fn1iSRZt aa+Q== X-Gm-Message-State: ANoB5pmg0IcK0fpEkTmRx0oOvX//Uj+6FMh+jsZsTAprGaicUHZMHrrZ Zb/j8fZCccS8GHaVwPME3LptmHVeZIJEuUcJVNvBddfi1lg= X-Google-Smtp-Source: AA0mqf7ZRgyPpRMXXsL+zIiB/+lrAZs8BsVoLygpXjWTN4aJfP0L5gfqHCP0Pa9n80RSYkv6DkcjNifrnuG3or/j6+c= X-Received: by 2002:a05:6870:b28a:b0:143:ffca:30c8 with SMTP id c10-20020a056870b28a00b00143ffca30c8mr20020645oao.280.1670657374755; Fri, 09 Dec 2022 23:29:34 -0800 (PST) In-Reply-To: <83y1rgzsk4.fsf@gnu.org> Received-SPF: pass client-ip=2001:4860:4864:20::30; envelope-from=paaguti@gmail.com; helo=mail-oa1-x30.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, HTML_MESSAGE=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:301098 Archived-At: --0000000000005d217005ef743bd7 Content-Type: text/plain; charset="UTF-8" Hi Eli, let me rephrase my question: To start testing tree-sitter, do I "just" need to include --enable-tree-sitter in my configure step or do I need something (more|else) on a clean-slate (Linux|macOS) system? Does the emacs build process provide all the necessary steps or is some external configuration/installation needed? This is the kind of "extra documentation" some of us are yearning for ;-) Thanks a ton in advance, /PA On Fri, 9 Dec 2022 at 13:10, Eli Zaretskii wrote: > > From: Pedro Andres Aranda Gutierrez > > Date: Fri, 9 Dec 2022 09:33:11 +0100 > > > > >User-level documentation was not yet written, we will do that a bit > > >later. > > > > To add to Ergus' quick question. How long would it take to write a couple > > of lines for the not-yet-informed with *all* steps to get a tree-sitter > mode > > up and running? I don't know, python-ts-mode, c-ts-mode... > > Maybe that would encourage more users/testers and thus (hopefully) make > > tree-sitter more tested, usable, popular, (you name it) > > ?? These modes have doc strings, so it isn't like they aren't > documented at all. > > And setting them up boils down to just turning them ON, something the > users who follow the development branches should know already. Why > did you assume you'd need something beyond "M-x python-ts-mode RET"? > -- Fragen sind nicht da um beantwortet zu werden, Fragen sind da um gestellt zu werden Georg Kreisler Headaches with a Juju log: unit-basic-16: 09:17:36 WARNING juju.worker.uniter.operation we should run a leader-deposed hook here, but we can't yet --0000000000005d217005ef743bd7 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Hi Eli,

let me rephrase my question:

To start testing tree-sitter, do I "just" = need to include --enable-tree-sitter in my configure step or do I need some= thing (more|else) on a=C2=A0
clean-slate (Linux|macOS) system? Do= es the emacs build process provide all the necessary steps or is some exter= nal configuration/installation
needed?

T= his is the kind of "extra documentation" some of us are yearning = for ;-)

Thanks a ton in advance, /PA

On Fri, 9 Dec 2022 at 13:10, Eli Zaretskii <eliz@gnu.org> wrote:
> From: Pedro Andres Aranda Gutierrez <paaguti@gmail.com> > Date: Fri, 9 Dec 2022 09:33:11 +0100
>
> >User-level documentation was not yet written, we will do that a bi= t
> >later.
>
> To add to Ergus' quick question. How long would it take to write a= couple
> of lines for the not-yet-informed with *all* steps to get a tree-sitte= r mode
> up and running? I don't know, python-ts-mode, c-ts-mode...
> Maybe that would encourage more users/testers and thus (hopefully) mak= e
> tree-sitter more tested, usable, popular, (you name it)

?? These modes have doc strings, so it isn't like they aren't
documented at all.

And setting them up boils down to just turning them ON, something the
users who follow the development branches should know already.=C2=A0 Why did you assume you'd need something beyond "M-x python-ts-mode RET= "?


--
Fragen sind nicht da um beantwortet zu werden,
Fragen sind da um = gestellt zu werden
Georg Kreisler

Headach= es with a Juju log:
unit-basic-16: 09:17:36 WARNING juju.worker.u= niter.operation we should run a leader-deposed hook here, but we can't = yet

--0000000000005d217005ef743bd7--