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: Fetching or installing package dev source from VCS: manual style Date: Wed, 19 Oct 2022 14:13:03 +0300 Message-ID: <83h700yslc.fsf@gnu.org> References: <164484721900.31751.1453162457552427931@vcs2.savannah.gnu.org> <20220214140020.04438C00891@vcs2.savannah.gnu.org> <87bkqmqpvb.fsf@posteo.net> <871qris3xb.fsf@gnus.org> <877d1aqoc1.fsf@posteo.net> <87edvhqdrb.fsf@gnus.org> <871qrh2hh6.fsf@posteo.net> <87mta5oyec.fsf@gnus.org> <87sfjx10x1.fsf@posteo.net> <875ygsp0ng.fsf@gnus.org> <87h70c9bu4.fsf@posteo.net> <874jw73cjy.fsf@posteo.net> <877d0z5216.fsf@posteo.net> <874jw05mh1.fsf@posteo.net> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="26348"; mail-complaints-to="usenet@ciao.gmane.io" Cc: rms@gnu.org, emacs-devel@gnu.org To: Philip Kaludercic Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Wed Oct 19 13:14:22 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 1ol71h-0006ez-Pd for ged-emacs-devel@m.gmane-mx.org; Wed, 19 Oct 2022 13:14:21 +0200 Original-Received: from localhost ([::1]:59814 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ol71g-00061F-Ac for ged-emacs-devel@m.gmane-mx.org; Wed, 19 Oct 2022 07:14:20 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:52510) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ol70f-0005EF-7O for emacs-devel@gnu.org; Wed, 19 Oct 2022 07:13:17 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:53434) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ol70f-000277-00; Wed, 19 Oct 2022 07:13:17 -0400 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=H6sNcbKScp6ILt3VmfyYuCsrhd8ZdDSActtILvfTH7Y=; b=i/pTHOYl0gb1 vp/QYdaAqjjchHc0LK+hJu100M19jidqnMED/jGljOlJpId4/LXDrqKtYKaH3E+TJRxRLhDc9Y7BL zdwSvMrEyVfpdzyLce3RFAu5LZGCnxpCLBmKm1Pj08Rr7ycw8stsE21Xmz+KD3UdS9xyrQo8Dgpm/ eKMvPJXTfILc8rXEwFIuj+AiQeT1aF9X1WiN0evLa3lRBLbSnFVr1fVHrQHVgZl6/JVGLr8pGLN7K lxKcX/CskPA/ktPk/fDmsjukH7r4H6m0tFTWs0k0XGsPhevsgMSQBobrOqzTf3VyPgJUb4UUytwHM hScG0WKddmrt4klFw3TCJQ==; Original-Received: from [87.69.77.57] (port=1852 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 1ol70Z-0007tO-38; Wed, 19 Oct 2022 07:13:11 -0400 In-Reply-To: <874jw05mh1.fsf@posteo.net> (message from Philip Kaludercic on Wed, 19 Oct 2022 06:58:02 +0000) 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" Xref: news.gmane.io gmane.emacs.devel:298111 Archived-At: > From: Philip Kaludercic > Cc: emacs-devel@gnu.org > Date: Wed, 19 Oct 2022 06:58:02 +0000 > > Richard Stallman writes: > > > > --8<---------------cut here---------------start------------->8--- > > > @node Package from Source > > > @section Package from Source > > > @cindex package development source > > > @cindex package upstream source > > > @cindex package git source @c "git" is not technically correct > > > > That improves the @cindex commands. But please look at the whole > > manual's index and see where these two show up. If two of them appear > > close together, there is no need for both. If they are separated by > > several other commands, then it is useful to have both. > > 3 matches for "Package from Source" in buffer: *info* > 1511:* package development source: Package from Source. > 1515:* package git source: Package from Source. > 1525:* package upstream source: Package from Source. > > They seem close-by, so I am not sure if it is worth it. What's worse, they all point to the same place in the text. What I recommend doing in these cases is to reshuffle the words: @cindex package development source @cindex upstream source, for packages @cindex git source of package @c "git" is not technically correct This way, typing "package TAB" will still show all of them, but if someone thinks about "upstream source", for example, they can type "upstream source TAB" and find this. > I have to admit that I have never used the concept index directly. It is not very useful, except for finding duplicate and redundant entries.