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=-3.3 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED,UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 20017 invoked from network); 1 Aug 2021 16:34:02 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 1 Aug 2021 16:34:02 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20200801; t=1627835642; b=eHTJQHAVP/tsMUgWUDSip+ehNPSwfKm/Q8kzKhaDwElYnJVQCOppfpElYB0OoV+dEqBtUs9mMU 2nBEK9i+27/ykTiyaQbqPp8uMYUPV/FyBLFpSBnizVgPEQxsZozgERSRpIuQHGQZ3/xUuekijb dg5Z0Fywz+eT6Ck70V2sMkJPFLc1QEJkX334jJz/R81OnPE+Po5FfQ4rSUAe0OgWhlMv/gGd3d MFWG+ZB11jA5nRi4GLIVLAkFUNy5PGaTkDwZyFElUE8yZn5NrGeidYxz9dg2Fz6yVG6qiaV9Ks DPOUBvvmt/2+qyQctU/pUR7gbZabGsptsUx2jxWP74UzUw==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (relay11.mail.gandi.net) smtp.remote-ip=217.70.178.231; dmarc=none header.from=chazelas.org; arc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20200801; t=1627835642; bh=ry1uIo0HSURLTyX0MmSb5mCjA4VRLMvukweGQVsbbi0=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:In-Reply-To:Content-Type:MIME-Version:References:Message-ID: Subject:Cc:To:From:Date:DKIM-Signature; b=B8b4Z6yKXV+q/O28tR4zIgD8m9xIF6PCg/2v0gyYdCZwgULg8UzYZHrI1tU1yBsIEO4UnfVd3L HrHTYl0baupxuQausoITWWqymVnU8tWeuo5LLOKyNePMzY5ZvA+t+b6iwlSMFc28Vj/tXL4ksI NhPXakK/WcLhEEwq2ne46/Hu+vc43gzWMekWcLXQ//wGXLDlwZ1ZLJyIxFfnfObjcIe7Mrei2J krwCJKwv9FY4JmC8bnohtmZIAJt5PD5mf27eZEcQiSnqBRrUvir28kpaEzKcPLuGHM/OvI+JfF RDowjaYVGbHJRmf+5jNPPbBZiJiX+L/+PM4g2eCKI/IJsA==; 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:In-Reply-To:Content-Type:MIME-Version :References:Message-ID:Subject:Cc:To:From:Date:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=GQlNTGi85k+w/O6JB82TIVEJ11O+jS3pc8dtnAMAGIg=; b=th0Le+iXA35dwdB3KgBam4sEwo eNXWAZIvF/Ve5lUUrKPK9kYjShvSws0UT+mydv7xBI7hsxs3+5LTywCPfEwuE+NX1971e/sN6/J9j jNSD8NrUq0mDLi13WjYppsdmsGMMxTd9oCOiIruMkqhRXYjn2jBMhwF4TYziEPvIVKEofU7rWCtvD ItIYIfkoFMVPAiKMSbo46mgnflE3yGTBSwOWMJvKUS6PSGwdlMJdZiF2UEoXIs7ydRXVonUt8s/rO SA61h24YstLBmUTr+C8TCwj/YNP6OnjJk4V4QHGdEW8VATUBrkoD4NYpwJoJP054GpEwwxTvpSu4x FYnQwvyw==; Received: from authenticated user by zero.zsh.org with local id 1mAEPZ-000Ka6-TW; Sun, 01 Aug 2021 16:34:01 +0000 Authentication-Results: zsh.org; iprev=pass (relay11.mail.gandi.net) smtp.remote-ip=217.70.178.231; dmarc=none header.from=chazelas.org; arc=none Received: from relay11.mail.gandi.net ([217.70.178.231]:49465) by zero.zsh.org with esmtps (TLS1.2:ECDHE-RSA-AES256-GCM-SHA384:256) id 1mAEOp-000Jqj-UX; Sun, 01 Aug 2021 16:33:16 +0000 Received: (Authenticated sender: stephane@chazelas.org) by relay11.mail.gandi.net (Postfix) with ESMTPSA id A90AA100006; Sun, 1 Aug 2021 16:33:14 +0000 (UTC) Date: Sun, 1 Aug 2021 17:33:14 +0100 From: Stephane Chazelas To: Mikael Magnusson Cc: Zach Riggle , Zsh Users Subject: Re: Better Help Docs Searching? Message-ID: <20210801163314.toawcsrtj6eqydxr@chazelas.org> Mail-Followup-To: Mikael Magnusson , Zach Riggle , Zsh Users References: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: X-Seq: 26829 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: 2021-08-01 18:21:14 +0200, Mikael Magnusson: [...] > You can also find these in the pdf version of the documentation (not > sure if we provide this anywhere but you can build it yourself). The > info version also probably has them, but I'm not sure if anyone knows > how to navigate an info document. [...] I only use "info" for reading the zsh manual (or any manual larger than a few pages and that has an info manual, there's a good reason we talk of man pages, and not man books, man is really not adequate for a manual the size of zsh's). In info, the "i" and "I" commands are your friends. They search the index and have completion. There's also "g" to search the nodes (the table of contents). In zsh, the index is very good. info zsh read Will bring you to the section about the read builtin. Within "info zsh", press "I" (Shift+i) and enter "read", and you'll see all the index entries that contain "read". IIRC, zsh completion also used to work properly with "info", but as seen in the other thread I started in zsh-workers, it's a bit broken currently. No big deal as info's own completion is adequate. Press "h" within "info" to get started with it. It's really astonishing that so few people know about it after so many decades it's been around. -- Stephane