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 27599 invoked from network); 3 Aug 2021 08:04:25 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 3 Aug 2021 08:04:25 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20200801; t=1627977865; b=ur9CY5N3F2L6AWDG98sGKlSyVTvY+QFbvzAibPkM3MM/J7ky2EHK9B4t8AU3ITbToVdVloKcB2 SpaFATJNJ/4DhTtzfQqba971rl3nJvsyeNeB6ow+5KK9yHEf/uJuJfLY6Rs4y32wlbgj4FuFAp fpTo8rHzZ4gyUuWuUgaKmTgTYQWzQnf7dLTMlrJ8L9l4RUS/flCMU9GXNOOoxuAMVEfs0soHfD EVc61Y12Yo7t4vmqLjymqYa9vJ98wRcX+ka0tTgt6bhnKjOQFnVEc63lbQE5Itonuna2itqL5G F6a3D4fJGbjYarrtIS0DljoP6bYlEp+pEl+dyYBjQHp2Wg==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (mail-wr1-f45.google.com) smtp.remote-ip=209.85.221.45; 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=1627977865; bh=+4MG5+YgJUNa6+U75ChrFq4xU1i63mbRP6K5y/B7zDw=; 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=hGIMZuh7go5RfVEZDpZRoNq428Z9eI28TsrbkXI+qC1+uW2TVwVMfKaenUncAoDRqn/FsahCIx pa27Dgcp0cKjuuxYWCpo3ssw/t9DgTFmxIwd8HSzIPdlADIQNZy52TBPfPwh5NtklPqiDxqLqh ygkCoIcXaV0ETz652GNZ4NLxLhDb+CFQGYZ2CQeeF5W6AMk5A+1KP/T/G+pPCmXlEo/SHDGCe8 yW2BuvsmRCQOTZYgG9LtLog2VtHwBnKqAXw8xUB7StaKLNo7smwstr4jmXFaF6jI6NER13Yi9F ns/1Wmz8u95YJ6zrMYo3lIVZtY2s8jvISmQ7PGKfi8NMig==; 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=M9SS0jiRT9laXkLQi4Tnz7iEKdEJP3wRS+ZgRE05Z6M=; b=vnk1ENOMTRcK/dbOgiS5dMMOkt ksIgq6UOLLHH7D03TU9Q4wOCV8JWkomV4FmsaD6eHUP8YTzju6v+jmRq812moc2WoeN33BDytxlfv bhOvFhr5GUdxUr/imCdNg6iZ8riFywb3pGmgYmW+edjWOH74ZRUpgdyoiT9O7UcdmZU+Hri2BCXF5 4PdkReb1L64WW3YKVIDmeW15iNgR0vDTO+ZIDzBNq7CisWAwuE0yqQhduYmHy2LZSlaMshsxV1YFE JViesEdJ0mbFlgfSyF9ddego5MBG0hwmmRScK3bjiEQrwfQcF38FaumYcGRmXyGhfD522KZTxx727 n0xCFZXw==; Received: from authenticated user by zero.zsh.org with local id 1mApPU-0001Te-R2; Tue, 03 Aug 2021 08:04:24 +0000 Authentication-Results: zsh.org; iprev=pass (mail-wr1-f45.google.com) smtp.remote-ip=209.85.221.45; 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-f45.google.com ([209.85.221.45]:44841) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_128_GCM_SHA256:128) id 1mApOu-0000lC-72; Tue, 03 Aug 2021 08:03:48 +0000 Received: by mail-wr1-f45.google.com with SMTP id z4so24309357wrv.11 for ; Tue, 03 Aug 2021 01:03:48 -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=M9SS0jiRT9laXkLQi4Tnz7iEKdEJP3wRS+ZgRE05Z6M=; b=jq0MufbGhwkj3JEwS3h1nA7tygWUAXtAyOcIYUQ+JIwfagRBsidEwstuGZBzilLjSW E2qmAJa/wsVUgJ8G4qnqAIGgw+/N78N6nXZq2aqlc7wBCkz9IxLjnVj8qlakNeu8uAt0 2jIp6+tJMz/4YkR9L84tkHyv6DYpXZu6SMKAQVs0s7R+NJvIzEXl4cxYLHu+MInlzvZM rvseqdzHOZymrWG7b69y9vxVuHEZtiM/iWAxWA9CMY+OppDVR1BfOmH3AetsOs36FNy0 qbo9wHLeSOAYbVVkFM2q+iUmsluM0Ae1d4Myc84DpyMOTvHClmyjYk3RHKYl8MfkphVQ m8kA== 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=M9SS0jiRT9laXkLQi4Tnz7iEKdEJP3wRS+ZgRE05Z6M=; b=oiVy6hWCxG59MYmhT5KjvXJgf4oD5Q1RJb4Rtr415m0TX4Nxs79EN7iVBgR6dqKtni 7gdsZD+Ki+S4pJ3IBDiTgBUmngopApTmWIwdsWLE/yx1nVcJ9xrECw8G2Px+ypy26hT/ CCZtczjRhoSOfEpsO86AnFEouj3qL4az1XXiV7F0N6cAaf0h6wp7dMxU1Hpn1g6N98hw PGG8GIKHoaRP19K+ATRR25kzVmT/idzyOSXNk56JtmH1Xh++qU7AzGpiEu8tXVix/tIG WnPCQeOcpggyPnaSHBnxE7sBzY+yK1JyiQzD64f+KvnXcki9JYbpSQukeYpn+Dy1+5LB kTAA== X-Gm-Message-State: AOAM531ZX+9uIcwRqa80DsLP5vmHJpWxaegdmKJzUFCaWEeJoSwpjUuf 3SXwCBJpRKL66n+2ZQB0d0iAlJPlBcU6MeMJpo4= X-Google-Smtp-Source: ABdhPJxAh8HP+jwtQumLvylJXv6mkMEqOVnVl3gGeup1HrXSCxMHRmxL1rZs/aP6PrZBObUE+aqtaP10yK3UYBYRUyI= X-Received: by 2002:a05:6000:92:: with SMTP id m18mr21416592wrx.277.1627977827503; Tue, 03 Aug 2021 01:03:47 -0700 (PDT) MIME-Version: 1.0 References: <20210801163314.toawcsrtj6eqydxr@chazelas.org> In-Reply-To: From: Zach Riggle Date: Tue, 3 Aug 2021 03:03:35 -0500 Message-ID: Subject: Re: Better Help Docs Searching? To: Ray Andrews Cc: Zsh Users Content-Type: text/plain; charset="UTF-8" X-Seq: 26836 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: Okay, I'm a bit of an idiot. I've been so spoiled by "brew install" that I forgot to "autoconf && ./configure". This explains the "make" failures I was getting above. "make info" now works for me, and generates "Docs/zsh.texi". I don't want to "make install" and break things by putting stuff in /usr/local (and I expect that using --prefix=some/other/directory will prevent "info" from actually finding that content) -- so information on how to generate the indices for the "info" command would still be welcome. I spent a while on Google searching things like "gnu info generate (index|indices)" but can't really find much. "man info" isn't helpful, and "info info" is doubly unhelpful. Zach Riggle On Tue, Aug 3, 2021 at 12:45 AM Zach Riggle wrote: > > 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. > > > > > > > > >