From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-0.4 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,FREEMAIL_FROM,HOSTED_IMG_MULTI_PUB_01,MAILING_LIST_MULTI, RCVD_IN_DNSWL_MED,UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 13015 invoked from network); 3 Aug 2021 05:46:32 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 3 Aug 2021 05:46:32 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20200801; t=1627969592; b=BN3OdGwcMnv1UR+CqWZ9y2j3qr5zQob/aWOsBEUZfSEz71xSIfDLcWyykC9NoXc5dSNgMpXCAO d1t6qLNcT43p6ARbfjuWZ0FiFoIXYA5GBrSlHY7vxh8ndMXiEVebpFqLTCxE56xS9cY8GsRZ2V GieAfQXCaZ/eALHIXmAAMoFWQAAyiGitqzhBoa03DKP0sxaeLdohlvMgtfSeMGSTzq6Bsk3U5l Htw4m/ZucSN4KO7GrDfswmYw4ahimH+wmhFm3gIcXTG6D2LNAlQupAdsGS6zoS9QVDLkTvkBaF UFeEs5A8Q5V04dr88BxA4Q+uKz+Wv3Mi5wAILVebABQGdA==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (mail-wr1-f47.google.com) smtp.remote-ip=209.85.221.47; dkim=pass header.d=gmail.com header.s=20161025 header.a=rsa-sha256; dmarc=pass header.from=gmail.com; arc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20200801; t=1627969592; bh=drwiQCmHmP4L2wW2YCl9rW/xwrIJJfMKn9KXR4kZfv0=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:Content-Type:Cc:To:Subject:Message-ID:Date:From:In-Reply-To: References:MIME-Version:DKIM-Signature:DKIM-Signature; b=xb89KxtgIdSFgiOcKmgj1ZktQa85XPbFRbog71y7zzWxEER1eJjdIn4Otp1AB6GRB/qSJK9yrx N3Fz7zqfIHW1smrr8dDOzeDyPQpW8wcXK4vMOLFiLjX3bAjNaizclT+oHpPKV4hfyJxr5h9QXo INjqUlFNB+Hglg4Aha43G48yaVzyTlBgbQ70qQiDnhb7N0TlpHdDYLfZSVMCKkQaU+rqDru8QX XS6it04e86vrd4OBvibvAxwhXkDMTxN6eSmIQvsySjQxR86UaX4h6MVrPieL2ieJnxbuwtniHc TpAxlFfv0hF6LJc+xuRBBtNXmWn/M4ybKmKRNOCuCibaeQ==; DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=zsh.org; s=rsa-20200801; h=List-Archive:List-Owner:List-Post:List-Unsubscribe: List-Subscribe:List-Help:List-Id:Sender:Content-Type:Cc:To:Subject:Message-ID :Date:From:In-Reply-To:References:MIME-Version:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=+x6PG/3nh2JrRQZ2oYfcGS2LKx28o3olbaxyDghSz/A=; b=Evo+9Hf0si3dPwUYrgNNHZMP7c jJ89ZENpgSn+4kOF8kFu3GQYzNESB8mzWB/b+4evJX1jMr6c0Bu06Odzo7kxXr4GWOVRyBXJXdxXj mKzpQ1H1b1K31PSvp36S4Vi/h4IOaBaEmMFSIq1HnqDUeBBfcdct0roSNCOQ5JvQ7Pg46hymQ7j8l IGOGZFD8DCYjxuA3W3dnB8s1ZLxeRTcXrHNBH74dBOSXkJgXCbC+/WAtaCXKI840xKoweMSNuVep9 HsacGbyo2jdNI4dTc7UbNiUCNREk4mbw7/nbMp6rzO1JWvzia0AuRTFPDEbJpnFQAvEptAzSB1U+j 5uhUU/Pg==; Received: from authenticated user by zero.zsh.org with local id 1mAnG2-000Kp1-I0; Tue, 03 Aug 2021 05:46:30 +0000 Authentication-Results: zsh.org; iprev=pass (mail-wr1-f47.google.com) smtp.remote-ip=209.85.221.47; dkim=pass header.d=gmail.com header.s=20161025 header.a=rsa-sha256; dmarc=pass header.from=gmail.com; arc=none Received: from mail-wr1-f47.google.com ([209.85.221.47]:37605) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_128_GCM_SHA256:128) id 1mAnF7-000K5s-Uq; Tue, 03 Aug 2021 05:45:34 +0000 Received: by mail-wr1-f47.google.com with SMTP id d8so23869230wrm.4 for ; Mon, 02 Aug 2021 22:45:33 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=+x6PG/3nh2JrRQZ2oYfcGS2LKx28o3olbaxyDghSz/A=; b=ua3brmeOyJKCPk78SHXsCJbgsLqLO8aKdx28TR4RMPlmgiwZcHYxzlyXpexXHsCwA8 0of8JPokAafaCfO/mNdSpWAp85aedw3n1lU2MmRrjsJ6RJqKFFKeWMB3XQ9AUKSE/nqe ajjwJlE1EKPV9Loie2KaIMbp3C2wychg0mjBPChTs3CRL2IFzpy7lqRvNfxrWKV1Mmza YdKLcegBe+J8mLVTJZv9acc2jziBP2sxs6/ljJNg7wxPOvWSakvHxIRmCtgYvTNWduPj 92CeCMCgNIAS6OnqLfJ5nOS8MzQYRefz3ARR9Gn34r7LQK/zgGevjfxIloGI8SXSDTbs dQVQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=+x6PG/3nh2JrRQZ2oYfcGS2LKx28o3olbaxyDghSz/A=; b=sDo10/U/Kzr07dOSbl27wY/Kwz5V5WhM8H9En4zNTTqablDvUS53iodnCOqd9jsEdd nMfUrf+md6GWglMxrgJpLZrR6VlyT52+9iSVzdXp0VR+/KqIri8YUva235A0xXx5OGtH sMssLh25Dy01Xzk81yFJYYAyiehW7SDEw+riHD+DsNIl8ya/qwMBGP9o0AE4IfL1KkdG 5x/6IiDO/ao/p4JLRcvLoIlWKa3byslJm1rDD0jXNif3uXrGnK4cf9wZhdTWOvaIk4mF 5mU/M68qvE1Z47AfM1Aw3ubjuwQ8WOtvX6g7EncRU3dkyiNcFWlygHTDlWDtUXsO96ua bG8A== X-Gm-Message-State: AOAM530kMHsSdcRAtbt9rOuqaxNAajqoLNEqiIdGvrNSkItsv1StizJ4 31KFFYUL74RDHh3MK+ZCXIZBEEjl8kbyDnXd9Zo= X-Google-Smtp-Source: ABdhPJzxl63PYzqf7Ns2Wh1DjYnm2V4HVLMiQt8vmj39qdwnKs1B/XIzKoWM9EpfWwKr0oqsMtYIu6sIxxVx6x6cspo= X-Received: by 2002:a5d:53cf:: with SMTP id a15mr20974096wrw.410.1627969533279; Mon, 02 Aug 2021 22:45:33 -0700 (PDT) MIME-Version: 1.0 References: <20210801163314.toawcsrtj6eqydxr@chazelas.org> In-Reply-To: From: Zach Riggle Date: Tue, 3 Aug 2021 00:45:22 -0500 Message-ID: Subject: Re: Better Help Docs Searching? To: Ray Andrews Cc: Zsh Users Content-Type: text/plain; charset="UTF-8" X-Seq: 26835 Archived-At: X-Loop: zsh-users@zsh.org Errors-To: zsh-users-owner@zsh.org Precedence: list Precedence: bulk Sender: zsh-users-request@zsh.org X-no-archive: yes List-Id: List-Help: List-Subscribe: List-Unsubscribe: List-Post: List-Owner: List-Archive: Thanks for all of the info (pun intended!), guys. I've never intentionally used the "info" command, only used it accidentally when I didn't import my zsh logging library (which defines debug/info/warn/err/die etc for use in my various scripts). ## Using Info When I invoke "info zsh" on my system (macOS 12) I do get some output. However when I hit shift-i, the status line at the bottom states "No indices found." Invoking manually doesn't work either, so I think there's something broken about the default install of Zsh on macOS (though I *also* have it installed via homebrew). $ info --index-search=read zsh no index entries found for `read' The "g" command works to jump between commands (e.g. "g read" takes me to the equivalent of read(2) man pages). I get "No indices found" for "info read" as well. :( ## Building Info from Source It seems that I'm doing this incorrectly. I inspected the Makefile and there is *definitely* an "info" target, but Make doesn't seem to like it. I tried both with the OS-provided GNU Make (3.81), and also with Homebrew installed GNU Make (4.3). $ make info make: *** No rule to make target `info'. Stop. There is definitely an "info" target. $ grep -E '\binfo\b' Makefile.in | head -1 dvi ps html info pdf: Even trying to make it manually doesn't work $ make -C Doc -f Makefile.in info Makefile.in:30: *** missing separator. Stop. ## Other Info Curiosities One thing that I really like / prefer about man pages is the $MANPAGER variable, which I have configured to use bat(3) [1] as my pager, which gives syntax highlighting, highlights command names, and flag names. Is there an equivalent for "info" pages? Here's a few examples: * sh: https://i.imgur.com/rGjQo9v.png * bash: https://i.imgur.com/ymnDh5V.png * git: https://i.imgur.com/ABqbZmE.png [1]: export MANPAGER="sh -c 'col -bx | bat -l man -p'" (See https://github.com/sharkdp/bat#man. The entire "bat" project is truly amazing.) Zach Riggle On Sun, Aug 1, 2021 at 3:11 PM Ray Andrews wrote: > > On 2021-08-01 11:52 a.m., Bart Schaefer wrote: > > On Sun, Aug 1, 2021 at 9:33 AM Stephane Chazelas wrote: > >> It's really astonishing that so few people know about it after > >> so many decades it's been around. > Little tidbits like you guys have just coughed up would have saved God > knows how much frustration here. There's always a solution, but finding > it might not be so easy. > > GNU made a push some years ago to try to move everything from "man" to > > "info", but it never really took hold. > Strange, isn't it? Something in the culture sticks to the trusted > tradition even when a clear improvement is available. Seems to be a > Linux/Unix wide thing. I still remember my first successful install of > Linux. Bash without even command recall and no DELETE key, and one was > expected to either already know emacs or to use the nano editor. DOS > seemed advanced by comparison. Even zsh, one might think there's be > some default to user friendly setup out of the box but that's not the > way. Anyway not to whine -- thanks for the 'info' tips. > > > > >