From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Tree-sitter introduction documentation Date: Fri, 16 Dec 2022 17:06:26 +0200 Message-ID: <83edszjslp.fsf@gnu.org> References: Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="17863"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Perry Smith Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Dec 16 16:07:26 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 1p6CJ4-0004W3-HF for ged-emacs-devel@m.gmane-mx.org; Fri, 16 Dec 2022 16:07:26 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1p6CIA-0005Xl-8O; Fri, 16 Dec 2022 10:06:30 -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 1p6CI4-0005Vj-7o for emacs-devel@gnu.org; Fri, 16 Dec 2022 10:06:24 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p6CI3-00046d-PJ; Fri, 16 Dec 2022 10:06:23 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=2R9n0CbfQJMmTM5P+1pWPRpu2UTm4tjPe6JGv2MHsIY=; b=oQTdPkOYvTH/ LkuxOPiYoZQV2WldqpOjM5bfaDdO8G81RsS2Hzr9JnlD0sj2XoK4TWOrftS6U61MlOy+9E87Sf1up WcfNxkkQBLw1YoQpzwV67AlhwZpZXvjgr+gYxnljIOepBLtWJS9pfh4B7SHk3sphzuGns2EHnJNVM GsKX6YbSs6+P8aoUnmgy1slYZLB1vpGiffSXCO1GjHFFDDg3nk4SaoGYGddH6tVVNxmjWLR2G4gHk H3tOfcniFbbOVS4xvXoxTc/ppx0zlkpXEWYBzOYhF0X322Ch1W6Foypes13/reHjRyGSSoiIii8UY AgSCy89iXw6VEg9Dxn8tMg==; Original-Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p6CI3-0005X0-4Z; Fri, 16 Dec 2022 10:06:23 -0500 In-Reply-To: (message from Perry Smith on Fri, 16 Dec 2022 08:47:18 -0600) 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:301490 Archived-At: > From: Perry Smith > Date: Fri, 16 Dec 2022 08:47:18 -0600 > > There are (I believe) four pieces to get Tree Sitter major modes to work. > > Emacs needs to be compiled with tree-sitter enabled > The tree sitter binary needs to be installed > The tree sitter language specific parser needs to be installed > The appropriate major mode needs to be loaded and enabled That's correct. > Is there a page either in Info or on the web that contains all these steps? Not that I know of, no. And I'm not sure we have in our manuals places to describe these setups. > If not, and others agree, how can I help create one? I am thinking the entire page should be small and brief with references to more elaborate details on each of the four steps if needed. My main problem is where to put this stuff.