From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id aHHDNeX78WO94AAAbAwnHQ (envelope-from ) for ; Sun, 19 Feb 2023 11:37:25 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id AL3VNeX78WOXhwAA9RJhRA (envelope-from ) for ; Sun, 19 Feb 2023 11:37:25 +0100 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 9CE4C4708 for ; Sun, 19 Feb 2023 11:37:25 +0100 (CET) Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=promisedlandt.de header.s=MBO0001 header.b=uydm9Qad; spf=pass (aspmx1.migadu.com: domain of "help-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="help-guix-bounces+larch=yhetil.org@gnu.org"; dmarc=pass (policy=none) header.from=promisedlandt.de ARC-Seal: i=1; s=key1; d=yhetil.org; t=1676803045; a=rsa-sha256; cv=none; b=hzjvRD8uC2yJ2EAQPOAwjKfuzF4HrD7IUYBUEfEo+MxiPJTj0VLLXu1ValBwmvX6DxDV4S WFVobhv8FUiwl8iFgJh+tymIUAVg6I3pAHTRDaz7g5sNw6BJl7oh6sVLWC6DKKkTzmS+Hx YrysLcBvyEfzv+oi/HLHQTyEzB3ex7a8ESFMMdbolgJ6yIBSlrCbWXDqbWK9vzSls8bW41 CyYZTlUbO8npHy/CqPiz+FBmQDdSgAP3uYJ4Lp8TByD+QubfBY3Sl1oLQFpgXSp0ZQYd1P OD56y/gfrDZuy/2EDfT+UzY1VpvAdEtbqWyE6M5LIRTy+auMKGeU77dngY6CAg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=promisedlandt.de header.s=MBO0001 header.b=uydm9Qad; spf=pass (aspmx1.migadu.com: domain of "help-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="help-guix-bounces+larch=yhetil.org@gnu.org"; dmarc=pass (policy=none) header.from=promisedlandt.de ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1676803045; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=x1YO8soydfDMbX147Fm+KNuJ4cg9z0d5Z4TTWNREpM4=; b=DkSJseUuAXB4EYDA96Hgyz6/aZN8r/dO707itQs5a9mAxTyAp2ksf3mP5W2db/25Oiju94 yEVjjFUcv8YoTlsTQIWCKPC5d+J/ETQQxHoS4AObotax13uO/1m1EUIj3TrgTvhJ2HmKqN h3EiR/7YBRMxn4QonlbweeFe0Gs40FAhu4+dU5Hl2hmFqjL4XSojHuAUYM1B5jOO5UYPO7 TmkNqhAq1fODftYE+4i12xCBRvzAX1XnxV2fi20UsWDwRBB9OgHlI01pMKJ1wMIVgkMK5i W0Qd0nN8jtURsv+TonXMNs9CZAY4nn54BRgFj8Pe8YW/X0e+JWN6aCTrUa2Vog== Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pTh3z-0001Z3-4O; Sun, 19 Feb 2023 05:36:59 -0500 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 1pTge1-0005Kw-Ee for help-guix@gnu.org; Sun, 19 Feb 2023 05:10:09 -0500 Received: from mout-p-101.mailbox.org ([80.241.56.151]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_CHACHA20_POLY1305:256) (Exim 4.90_1) (envelope-from ) id 1pTgdy-00008M-Al for help-guix@gnu.org; Sun, 19 Feb 2023 05:10:09 -0500 Received: from smtp202.mailbox.org (smtp202.mailbox.org [10.196.197.202]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-384) server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by mout-p-101.mailbox.org (Postfix) with ESMTPS id 4PKLrj49dcz9sST for ; Sun, 19 Feb 2023 11:09:57 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=promisedlandt.de; s=MBO0001; t=1676801397; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=x1YO8soydfDMbX147Fm+KNuJ4cg9z0d5Z4TTWNREpM4=; b=uydm9QadP8zwlW+tcjiN0wZMs3q3tfZJKUFgRLlp1XO1nbcElCZ34VfSgKxVX+r+knoNlm XcsfzWnm52GYOA/JYI8m+qVxC2VIfd61Bt3UXZlbfU7tZ6vnjpY+HSWaPQHm8e8HjZZiCD 0smuJRCzuP8O/kxFTogti2IcrO4wRpceWmdHyb9AL29jL5HRPc7/7Ri3EyicS7roC/KZVH PR5hVLzwGUd2L3MF68rTl9usbfx5DlynNN4y4LD9ynQ/8Jfss5IaGvw9Kpkn5PoVvYPhxO SXe3LcT/dVlOtxnRi5jWEv12OjHq2Qa7RNx6BReYKkVQMX80maKD8JOJ/ZOY8Q== Date: Sun, 19 Feb 2023 11:09:57 +0100 (CET) From: nils@promisedlandt.de To: "help-guix@gnu.org" Message-ID: <1973776289.362054.1676801397268@office.mailbox.org> Subject: Generating helptags for vim plugins MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Priority: 3 Importance: Normal Received-SPF: pass client-ip=80.241.56.151; envelope-from=nils@promisedlandt.de; helo=mout-p-101.mailbox.org X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 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, RCVD_IN_DNSWL_LOW=-0.7, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Mailman-Approved-At: Sun, 19 Feb 2023 05:36:56 -0500 X-BeenThere: help-guix@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: X-Migadu-Queue-Id: 9CE4C4708 X-Spam-Score: -5.64 X-Migadu-Spam-Score: -5.64 X-Migadu-Scanner: scn0.migadu.com List-Help: List-Subscribe: , Errors-To: help-guix-bounces+larch=yhetil.org@gnu.org Sender: help-guix-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-TUID: iLMuJCVBfvee Hello everyone, I'm trying to switch my home environment to guix home (from Chef). As a first step, I'm writing package definitions for the various vim plugins I use. I followed the simple plugins in gnu/packages/vim, using git-fetch + copy-build-system. This worked fine, but I noticed that there is no code to generate the helptags, meaning the plugin documentations don't show up in vim when using :help. Having the documentations available is important to me! My solution was to write a vimplugin-build-system. It uses copy-build-system for most things, but generates the helptags for the plugin as an additional step after installation. Technically that works, in that the helptags for the plugin are generated and available in vim. Sadly the concept was wrong, because the helptags file is always named "tags" and needs to be in the same directory as the help file. This means installing multiple plugins has the doc files for all plugins symlinked in ~/.guix-home/profile/share/vim/vimfiles/doc , and then the "tags" file of (I'm guessing) the last plugin, meaning only that last plugin documentation is available in vim. Solutions I could think of: 1) Run the helptags generation after *all* plugins are installed 2) Do not install all plugins to ~/.guix-home/profile/share/vim/vimfiles but rather keep them in one subfolder per plugin (which is how the built-in vim package management works, and most or all vim plugin managers). How could 1) be implemented? I could do 2) rather easily I think, but it would contributing the plugin packages difficult, since it needs changes in the gnu/packages/aux-files/guix.vim to add those directories to the vim runtime path. Has anyone already spent some time on this? It looks to me like an issue that everyone would run into if they use the already packaged plugins in gnu/packages/vim.