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 28253 invoked from network); 3 Aug 2021 08:10:19 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 3 Aug 2021 08:10:19 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20200801; t=1627978219; b=de5bu6s1hAIkB3tmPQZu6345lbCwm6NbAqXQ40kPrrvVrtIHMEK4WnOcwav1e57UMYDhf7VvQK Fp8XeQHBRW+W5gjwpsH2RvnjfSU+ZYBwIQwcvKrF8rKHU3b1Km8IlAYIy6B5lCrMqKlU9SWfCs jmThxwKz4RhLOf76ZYJVk+I/wQeKk2E/O4lqFHkt7KGtL7Yw+GZn9GnSXEtzuB7+AMcI4iTkEW YYUtDswH801P4YZmS5c9zw2yv4NDM6OT87whCaoLb5IsaCE154prfHO+qV2Haf0Zp5ctgKZTI4 EmJK0b1YN+BMHyVwar6EazMIe7iMA98A4VY+ymacTHj4xQ==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (mail-wr1-f42.google.com) smtp.remote-ip=209.85.221.42; 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=1627978219; bh=eFWIltGbjZj4e/2lUOvG/EM+uyIlQB8VkCnvAkP5Cjo=; 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=EnCyvKpzPX1ezJNc59TQNUbxu3rLHsLZOv7BBARKUSh6o2KBJMnvpjFDebiNiBb029x55L1MWV arBOPYhnNUKvl+9+u12LyD8jl6laWPYM2oYgJqNHGnK/F5gE8lJmEnP55n3oPFyUqQBCHX4iv8 2mYlrWvhVEhfuhmpX3aQcIT/QGSHoHIrhpwdTEz4/Q6BPgo7dBMAKoby8ZrDG1vimEsKXEV/ya GCGBg4YlYn9zKG5nb/Rx1PFr/VYKQnAHQEuEQzic0oDFGBkfTh7PqpyzBqkdHwGGXke5MK3ywk QCSOATKfWRZ/JX7E0+Ww0UcP1qqtDlE/Mk5YbhNu+iBjHA==; 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=HJD4u7Ti9+aEWoODgAPky9kGGahSP5BsVrgbgb7xmio=; b=HBEQNZ36YnrtOGRrpEdzQ+uP9p W3yeWMp94p0WHINyvW6FhN1Wv9AHRpBrPoeiKyLOkFw3bNODtQPrnLjVxHq3bv1I/SIW0BQS4GMQF YVTl+CVR2wpT2PZXkyigN/wYJGy9xcUTeBI6Qv1PHCUqAws3nD3T4YhdlGonZJ6g43DxNQeMfgcIV PtFnnu+nKHFXaxX0r1kS0t8AraysWq7cD8ktXhtUbr++dSKc4n22OAcSQBn1dRDspQsVu30uK6y7t vnWPC6JWWLEoe5hcTR6q4IqwfIkuCaOc+5Nd0FHlFSJgku0OVa6sIDYkF6BfUiQwU02doJ7iRzA6/ OoaAshaQ==; Received: from authenticated user by zero.zsh.org with local id 1mApVC-0002sA-Cd; Tue, 03 Aug 2021 08:10:18 +0000 Authentication-Results: zsh.org; iprev=pass (mail-wr1-f42.google.com) smtp.remote-ip=209.85.221.42; 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-f42.google.com ([209.85.221.42]:41572) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_128_GCM_SHA256:128) id 1mApUW-00028x-J4; Tue, 03 Aug 2021 08:09:37 +0000 Received: by mail-wr1-f42.google.com with SMTP id c9so4031415wri.8 for ; Tue, 03 Aug 2021 01:09:36 -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=HJD4u7Ti9+aEWoODgAPky9kGGahSP5BsVrgbgb7xmio=; b=CkHo/F79my/yU0zyu/kr7TNDMceSC7UBav/dkNpsjvscyaX+pZmLDzDInOyrIBRfK1 uux8XQp2sNjuDOpDHWACzGlpAgIi6P9mBhFAWgQK+uefls62DtZ968W5elGLgrTASWZS n/F8w+LIZH/KrK55U5o0Vc34oQaTe1G9WwNJZO3paDnxq0+M82K2jxh46ZGSSvgeJfPe uT1vgsMbB78+Wx1IqLe3az0oJgbZ5XFS/MvzQFkSv3K6PMUmstAJFNiBFgeeNyX5fKo6 FcE31ITmojgHgcF1U++gksOY7u8YOsnG6/csuMCs1tzHXb3BIdEMaQzgkDIk/Bt9tF0y aWgQ== 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=HJD4u7Ti9+aEWoODgAPky9kGGahSP5BsVrgbgb7xmio=; b=XJIo7I4EqU3DAxq7cSxkvtt5uVfrPAcEFAIByxS6b0guF4RHUG5vSbB6em92lZhuvD HfildKQjVDca5uDAHWC1mom3WJDzqWyLzzSAwGLc+HX/x2WgG3Fg0+s1PJQV5GeF/raJ 1kw6JhPV2YIgECGYNNcBcYZk0TImpXsCigDtX+eTKTPKLeluVq7DjLV6eTYXtEQM8lsQ dMrDrDfm1KTTAHOrQR1OfzWKh2K328FomSRqfKmQZV81HKyb6OtxesHzKyHgTqijQxxS x6HzQWm/+hHs1PFwu/9TenqbZP3mztNugwiytfcrDBTRPPlPyVSA54XiXeZG6Fp6uHLL dqAA== X-Gm-Message-State: AOAM530AtYr7WnjCp2UDETiOrprTC8Xw5gbcoVpsld25xaCpPIWMixhj 8bKMjlka+hZBveJO2aA1cHV99KKkXjYc8XwX1cw= X-Google-Smtp-Source: ABdhPJyJOSm6qTR+oHpGbjk2TMSD+ynnA4l3Rfpr6tYSUsxS0tJRVU2Pm+Ko4IWRCZAcAODC4Bognl2OkOGGkQCkRhc= X-Received: by 2002:a5d:61c8:: with SMTP id q8mr21544980wrv.151.1627978176191; Tue, 03 Aug 2021 01:09:36 -0700 (PDT) MIME-Version: 1.0 References: <20210801163314.toawcsrtj6eqydxr@chazelas.org> In-Reply-To: From: Zach Riggle Date: Tue, 3 Aug 2021 03:09:24 -0500 Message-ID: Subject: Re: Better Help Docs Searching? To: Ray Andrews Cc: Zsh Users Content-Type: text/plain; charset="UTF-8" X-Seq: 26837 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: Follow-up-to-follow-up, and apologies for the spam. It appears that, while "make info" worked, it did not actually generate anything useful in "Doc/zsh.texi". $ make info makeinfo ./zsh.texi $ git status --ignored -sb | grep '!!' | awk '{print $2}' | xargs wc -l 114 Config/defs.mk 655 Doc/Makefile 36 Doc/Zsh/manmodmenu.yo 221 Doc/Zsh/modlist.yo 38 Doc/Zsh/modmenu.yo 9 Doc/version.yo 2 Doc/zsh.info <------- two bytes 0 Doc/zsh.texi <------- zero 292 Etc/Makefile 403 Makefile 452 Src/Makefile 306 Test/Makefile 22195 config.log 194 config.modules.sh 1368 config.status 16791 configure 43076 total Zach Riggle On Tue, Aug 3, 2021 at 3:03 AM Zach Riggle wrote: > > 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. > > > > > > > > > > > > >