From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id 8BytBIpjzWNezAAAbAwnHQ (envelope-from ) for ; Sun, 22 Jan 2023 17:25:46 +0100 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id 4Dl4BIpjzWPd6AAAauVa8A (envelope-from ) for ; Sun, 22 Jan 2023 17:25:46 +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 C4C0B3E067 for ; Sun, 22 Jan 2023 17:25:45 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pJd9Z-0000zK-60; Sun, 22 Jan 2023 11:25:09 -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 1pJd9T-0000yN-6Z for guix-patches@gnu.org; Sun, 22 Jan 2023 11:25:04 -0500 Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pJd9S-0001Kx-ST for guix-patches@gnu.org; Sun, 22 Jan 2023 11:25:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pJd9S-0004C2-Eb for guix-patches@gnu.org; Sun, 22 Jan 2023 11:25:02 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#52109] Mention bsdcat, bsdcpio and bsdtar in description of libarchive Resent-From: zimoun Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Sun, 22 Jan 2023 16:25:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 52109 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Liliana Marie Prikler , Giovanni Biscuolo , Maxim Cournoyer Cc: kiasoc5 , 52109@debbugs.gnu.org, Foo Chuan Wei Received: via spool by 52109-submit@debbugs.gnu.org id=B52109.167440466016050 (code B ref 52109); Sun, 22 Jan 2023 16:25:02 +0000 Received: (at 52109) by debbugs.gnu.org; 22 Jan 2023 16:24:20 +0000 Received: from localhost ([127.0.0.1]:52494 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pJd8l-0004Am-SF for submit@debbugs.gnu.org; Sun, 22 Jan 2023 11:24:20 -0500 Received: from mail-wm1-f50.google.com ([209.85.128.50]:40844) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pJd8X-00049c-Ud for 52109@debbugs.gnu.org; Sun, 22 Jan 2023 11:24:07 -0500 Received: by mail-wm1-f50.google.com with SMTP id e19-20020a05600c439300b003db1cac0c1fso7520999wmn.5 for <52109@debbugs.gnu.org>; Sun, 22 Jan 2023 08:24:05 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:references :in-reply-to:subject:cc:to:from:from:to:cc:subject:date:message-id :reply-to; bh=LZt/Pt044i0TWHew1QGM1DElgLphaJDXdyi/k57UDYo=; b=cAs8iMcf8TfJFXWKKApMGhlTogW0VObHPTkVrEt7WKLf7Fo8UB3EGadoVOBL0bWT7N GaijwAcLp904x+3Oob2bNPseqrXfxKiLsyDRKzQqTPkkq+hCf5JfzSjJhCuo4aOPKt46 i/SN94EDPjOKRj29mL52JT0oNpYbvVQJf6XyjpX1qnVPprajDzOihxAU8opivG2I//8E LYFjVtxsG2nw62ACN6GAfMn80zY7uFBEf5uF3eqLUYU7DyS7/Vr9Av0q8DUjNy6K9g0C +046vu8xx5BYF2PudXCB+TIf6i8b8lscB1tQhdhsncXBFrEtj1PZFhOCate1DmEWH4E3 9A1A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:references :in-reply-to:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=LZt/Pt044i0TWHew1QGM1DElgLphaJDXdyi/k57UDYo=; b=TnQQ7B1oKY6GPyLDyF4okq2uHgpYUHwi8tiNbju3cOVX/5dsZHWvsRhjnKmUUCkr+S py7AlIzWfsNCgNW66pLaNZXsNGHgN6InoXgmxRphLOFX8LehUlEEd1gRkJjkWqixmhZI mGsocNiGhlo1iH6fQFvchmVVju586h+9R+OUXujK+ng78kpHXDcKdN2QZTyw7tQ1cEBW duV/5fDjCeDeJ79CXD7VD9MCcS5Blpu2e8GVXsp3f5igmKq6W5OejHk6X/XXEVc8sZlD Xac4ojFYKo2vCET5hZLKGUPiBMBNIwsusHTMnvziWLlnOw4rVdpUeDioCcjPfuEnpndg xM2w== X-Gm-Message-State: AFqh2kp8xZdVyOqlHMnBj8oXE44HFdJbi7Rxa8ldEsLBQvhTo/qpMsUy QwrPVxm7iGWsOkjoXCM/Q2o= X-Google-Smtp-Source: AMrXdXtF/zLQpWZgYQ3Slx5UqE1jBxOFmA+Z+4idYtcrNsxZd5U9wFwMYqZpvWcD92E0uPlRi5zlOA== X-Received: by 2002:a05:600c:1c83:b0:3da:ff24:4b93 with SMTP id k3-20020a05600c1c8300b003daff244b93mr5503126wms.3.1674404640280; Sun, 22 Jan 2023 08:24:00 -0800 (PST) Received: from lili ([2a01:e0a:59b:9120:65d2:2476:f637:db1e]) by smtp.gmail.com with ESMTPSA id l7-20020a05600c1d0700b003d990372dd5sm9227629wms.20.2023.01.22.08.23.59 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 22 Jan 2023 08:23:59 -0800 (PST) From: zimoun In-Reply-To: References: <877cxqwjen.fsf@gmail.com> <87o7qyvmkp.fsf@gmail.com> <69bf571edfe9834851ddcd9f93e8158983b42612.camel@gmail.com> <87bkmytoy6.fsf@gmail.com> <86bkmr3m4t.fsf@gmail.com> Date: Sun, 22 Jan 2023 16:09:31 +0100 Message-ID: <86k01e1u8k.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: guix-patches-bounces+larch=yhetil.org@gnu.org X-Migadu-Country: US X-Migadu-Flow: FLOW_IN ARC-Seal: i=1; s=key1; d=yhetil.org; t=1674404745; a=rsa-sha256; cv=none; b=RMT5jAtbPicmYEL9q9/AaZkPpGN3fRMb9Lg3tqtPgQpCFifLL27+8Q8pGEbAcTplKHEQck Na/OpsYipTKZXtcOpNI3zDDFyzHp895bTqXse+OLNaAZjiC7gGH8dwgt4m1E0Pvc+VNQuE Ke8MkuO+ippGOIx8VvscKEfxwpshYeEEooVw8gVUjK4sIxU5FZFFnFOi72sTbP0//rM+ur oRIPDVV0TAP8MYu+1T55tJCH/wr2p/gVOqaCy3rImkH4+NSzy+FhVWW7DsXF6H6M0NX79s gCoRN9jkFGVvXgVhdHoSRZ2qskvdWlfhPBPZz3+2yi7pkoZlNp0t/EqRQ/T9bw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20210112 header.b=cAs8iMcf; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1674404745; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding:resent-cc: resent-from:resent-sender:resent-message-id:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=LZt/Pt044i0TWHew1QGM1DElgLphaJDXdyi/k57UDYo=; b=E3UY7WLAV6EDAA9nPr0sLcXbn5qaZyHurOfd777XOaNAopfyS4R3zzKTnEuEGB4IuswI2L +GAHDRR3CY3BmLD+i6Ohk+TbJZtCaARfO9v5NpU7JMlL+/PJg46WlmXKnKFGlXyBo/wB7P Fc7hiASXhGpi9cf/QW9wvGqpEM36yMe7VYIu2Nbg65F/uwbNJk0cm/RJM4APbc/BdlamD2 VDM9XIFl5RvYjhhW2al3/WaWxL4FVCtRLLKr26neir7xN8r3+4CnhDks4wKWsIgq7IOoSy zfwAiL3BDpHMnxjwLEDFNcsDt5RKldoQg1vf9zzhQLFieMPY9xKduj02GtBXbg== X-Spam-Score: 8.61 X-Spam: Yes X-Migadu-Spam: Yes Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20210112 header.b=cAs8iMcf; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: 8.61 X-Migadu-Queue-Id: C4C0B3E067 X-Migadu-Scanner: scn0.migadu.com X-TUID: KzSAoUYvqOVB Hi, On Sat, 21 Jan 2023 at 18:59, Liliana Marie Prikler wrote: >> Please find attach the patch. :-)=C2=A0 If it appears to you fine, could >> you merge it? > > Hmm, I fear that this line doesn't do much except helping folk to grep > for "bsdtar" et al. Should we perhaps explain in a sentence or two > what those commands do? It is not =E2=80=99grep=E2=80=99 but =E2=80=9Cguix search=E2=80=9D so it is= only an internal SEO. ;-) >From my point of view, some explanations about what these commands do are done by the man pages. Well, this trivial patch is just a quick workaround at 2 levels. One, because Guix File Search [1] is almost done but not very popular yet. Two, because this libarchive should be split into 2 different packages or outputs: one for the library itself and another for the commands. 1: However, if a table containing what these utilities do seems appropriated, here the description from the Debian package =E2=80=99libarchive-tools=E2=80=99: --8<---------------cut here---------------start------------->8--- The bsdtar program is the default system 'tar' program used on FreeBSD. bsdtar uses the libarchive library as a backend which does all of the work for reading and writing archives in various formats. The bsdcpio program is the default system 'cpio' program used on FreeBSD. bsdcpio uses the libarchive library as a backend which does all of the work for reading and writing archives in various formats The bsdcat program reads archived data from files or from its standard input and uses the libarchive library to decompresses it to its standard output. It may be used for viewing the contents of archives or for passing it to other tools for further processing. --8<---------------cut here---------------end--------------->8--- Cheers, simon