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.4 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,FREEMAIL_FROM,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED, UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 16404 invoked from network); 1 Aug 2021 11:02:02 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 1 Aug 2021 11:02:02 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20200801; t=1627815722; b=H3mQjjUorA2fpR/QTOyqjHcm6jDgm/UQH++9SgJvyqjRKvXmZgZLC/wGtXzN1WF4GAbqG3s1Xy GA/pGNO4q6/Pnp0tcHT7oKL+70B+YcI3MHBvS6M7qkvS+GVSBVuBytyFuFJ95H5U7mD+9c2cYV 0ZNfbcuLtr+FuB1PPQ6WkTDNcfkffeg+XBbcY3zphpuzcXgjON2Z8LK7CtvU/Yi2nD61bvJ8Sa 3f1CMH4TNNc7Zjgr7rYuHmValSAnib/7IbYeFOAjEPZoEaqaG/N6qE66ICrn70yTXHQ/X34Irw EsI9W7usDI5GYpcpkGsjdV5T9Yhn5vKaU6n3zN+tWOG/Wg==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (mail-io1-f45.google.com) smtp.remote-ip=209.85.166.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=1627815722; bh=9o3GC55aEKZBeCvxDDaPi172pv3UNxLkmr0zvxvhwyc=; 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=WGt8De/Oi+2PxXWtvdT6yjGlZz/+OVn6UC8mShYlOUFTbO3MFLIYDZ3iCrYU9k24lUZ3AIf2LC XjEmEs09Za1lq0fKJ1+IJhsBV2TMZqqkyhPTCLPS+EqAa8/boCuji0zFVBs99Zw1SVSc/Zjr4U MySy7yWpHCpTLjZzkplIhBUKooXOja066V9NMETDhAeCAmoilmu0yaY59XN34kic8ARW4CQ7k/ j14tHXSdqKv4cOGyWeg/wd9FIE+0LokrTt+QKshExBeSG4st3zcJhc1aCXAU6q5Al1RRroIBY6 g0PnIJ/k4YtRJ7WEw2n+TzYZJOGFhTdjluI3AYrO9aF+zw==; 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=bFV4eIqraifm/vdoVUUrnaF+K2jewDrV+cHZ+ehO5gM=; b=EFQ7/qQEwCCHMSHlMyT4e8N+Fg NDW6EFtGrkkGnNxXhDZbkG/lpBXmsmmFs79XYy8Q+WR7xuZ2tP+R1/O1nb9c83ab8YPiH2Bi25Bbo 4F3k+yWlczl91yDaQBgTQxOXogAIqXrOKkJsJyRbRWGx1/YXXsONZBEXrf9tPTrFvHUCaqOVD68uj wLQ69hSz8kj5CpyI9q6a/S79cE4VPzF/fxsX3D0vsxBJsTc+B0BPTyfvz7aqg7mVZjXrAS0uJEReC 57B/Xa6j7Vgx9dyfOwN34omTPCj5lNHv+DqG6buNbXE6v29YZr7vtp3iNPuV4WdZ9BLlMY/hrDbJg nKKCf+yg==; Received: from authenticated user by zero.zsh.org with local id 1mA9EI-0002Uc-6i; Sun, 01 Aug 2021 11:02:02 +0000 Authentication-Results: zsh.org; iprev=pass (mail-io1-f45.google.com) smtp.remote-ip=209.85.166.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-io1-f45.google.com ([209.85.166.45]:43741) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_128_GCM_SHA256:128) id 1mA9Di-0001oG-1K; Sun, 01 Aug 2021 11:01:26 +0000 Received: by mail-io1-f45.google.com with SMTP id 185so16963011iou.10 for ; Sun, 01 Aug 2021 04:01:25 -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=bFV4eIqraifm/vdoVUUrnaF+K2jewDrV+cHZ+ehO5gM=; b=XV9QxpCRqsx47iZiElGHEs5gaEqFe+N95HLVAHWdPi583Hlx9qcgoK7FEaattKolre rfw8TZJxevdTuJPCMc8aFgkJKEOFsAY+qZc9O7nOueBoAaYvjV9YwuhLEJKn0cfRTAEF qDV2sRVVg3G0mTZ60HDxWZBJtfPRJ8jA0+WDZu2uAty6p6pqt9Yd+115PnVCpfh39ZG2 IJ9QXQ7D1SsQKNcQT6dZKSTI0S/vcPuYkUp9Ll5E88TSleMAYsiRl5XOX6poAdZxG5Oc pBApEl4L+OMwCuujpvRD1Rxwou8ETeSsgYmz1WrIwXTOZl2ZAXdM/qOjqI9B7zXAMwyh oizw== 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=bFV4eIqraifm/vdoVUUrnaF+K2jewDrV+cHZ+ehO5gM=; b=nkcUoelhfKPeWQ7M46nPH6YMI2XKXSMlJbTwDbTYXK8NpEZ9ezhAC+CbwfIjwFxWu+ l2/m+1Lp9GHsZL/QFJhmfDXJbFyZGoclR2YHSNZXesfJp17k4TUEWn0VjLsHcUgpBBj4 4UPoOwiWs3FR4hlvBsMbp/TmMpCxxU7eO9nPP67MTV/52R7QTHshPeXSG+MFl0lFlNgu IBe+vzjlDJnAtKAzyIqNwb/FqzXGWXYLC5zXgy1WjMbN6gyFcFjeOWm3bYaDlUiPGDda BHOu5T9ctBPp/h1/SzbMdE0+9a5AtRAcyBPFH0qjxpkdEd8WhaiQ8aDIpjEEJpxNTOV/ Bidg== X-Gm-Message-State: AOAM531iJD+EZwHnbT33Pb8U5s0b1p8zPm+IFWHTjRBT5p5atD59QMSp tm+SQPoUcHmrMXyXcAfdMaozehvdqbeHGcesTqs= X-Google-Smtp-Source: ABdhPJxVoQ7FSsTZMhPIEg//sl0FQiJnkLlnHDBNDcaJBpHkWsK8ose1Epod6C71B+io6kZJMrHbJ3niIPCGIN6sgjY= X-Received: by 2002:a02:8805:: with SMTP id r5mr9032996jai.83.1627815684823; Sun, 01 Aug 2021 04:01:24 -0700 (PDT) MIME-Version: 1.0 References: In-Reply-To: From: Roman Perepelitsa Date: Sun, 1 Aug 2021 13:01:13 +0200 Message-ID: Subject: Re: Better Help Docs Searching? To: Zach Riggle Cc: Zsh Users Content-Type: text/plain; charset="UTF-8" X-Seq: 26826 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: On Sun, Aug 1, 2021 at 12:46 PM Zach Riggle wrote: > > All of that said, is there any way to easily find keywords / flags in > either the online docs OR the man pages -- rather than having way too > many matches for other things that mention the same word (e.g. "read" > as mentioned above). There might be better ways but here's how I do it. I have this in my ~/.zshrc: autoload -Uz run-help unalias run-help This allows me to type "read" in an interactive shell and press Alt+h (aka ESC h) to open the help file for the read builtin. Sometimes this doesn't work (for example, try it with "bindkey"). In this case I would run `man zshall` (one page to rule them all) and search for " read" -- note a bunch of spaces in front. If this query has too many hits, I would use "^ {4,}read\b". I use the same trick when searching for the description of flags in man pages. For example, to find the description of "-z" in `man rsync`, I would first search for " -z" because it's easy to type and then for the more specific "^ {4,}-z\b" in case I get too many hits. Roman.