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 6160 invoked from network); 3 Aug 2021 09:41:05 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 3 Aug 2021 09:41:05 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20200801; t=1627983665; b=hyheSLOcaQ/wRSMgoL2Bv0BlNh/Sq/DEvbGZ3j8mQvwvdpkLmFHHec97lQTKfP4S+L5zKVVcv6 RSCos66pYZ+UT+l32oHMdwtlTIvrl+47WEEbt32Zd+K6uBxasKmUKjOr8QahpmihZ/AsgHsYmL IsQyf0XLkVZwRMggxFHRAvvzB8MjwS/n8io7/WOMj6X+hJKvr8jf+j5Y+15Ee15R17hoHm1wLz UC4t7gVm7ywZdi+/UEoL+xg/2tc6CCyR26gV5+iV23o56u2qnKFQyrBlD4cHgAg7oBpUE/lcg9 nbuf2Z7FRvs3Qfml9I4SJUGrfYOMiE3yFh+HcltvljuCFg==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (mail-wr1-f46.google.com) smtp.remote-ip=209.85.221.46; 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=1627983665; bh=fiaWg43czEtzsfUA2Gka/Q7cAQTPfK8bAS2ZqXNAV0Y=; 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=dqDKJWJqmcssmwY9koQ2lSwElYGDnrCwv9NQZ3RL0eOBujD/vgFAGAc9aQqTrAxNQoSjSvoTkR ATHt2Dp0SnirzAGZsnRBFmJimbCWd9OGK4zoar/5Xkf4CFxbJ04YwSDXoTR91P5/ZzWUolXunL yx8kWsEQaq60d0fHB0jvcy28UJGjC50hcsHcWMACnjqz1v/zL2NLYv+b9WN2ZBzs1jqaXkmmPu /ZrmRD9z2x6Wco3s0zwV2oV7TCuF0n6e/lD2geIVe7B9ICqP/mVZ8uSw3oxM2moLY3BfUG11iV Q/ihpDtICxW0nPFcOPB5u/2rFPf7q6hYMPIRm3Wh4vJzDQ==; 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=GQIRRXWfv7j4W4ESPVeOdCGJX7fHn+CnTSqX8DAvKG8=; b=t9gEXEXJPqhRg34grgNaMDvnEU CyH0UjggCr6zs83iCeF1/yOhKRnWG9Kw6Xx7/aB/nOAYKuu0tJmjJqNDdnIB/nvOpujgc/BqnhwfT F0jRNdoQoO6PuP1NKel+ZpKxDgWkBNY7IxBhsSTflWW1R+H45l8sBZWsGP+rHjicolkOP3yZ9JQzE Lf8As+3L6gv6wSaQFkEP9T8vEJ7OaEZISENeIshLooATpGj5rC1lX23cV9WjyE9k9NDr67P2i6Yzg YAdDQrofWpww29rcw0eOKBHgYIvWIS++ZNiQXEDdq7U1KEZdEioBrEEZOm+4dJzB692msPKRYPZ90 yneKOnsw==; Received: from authenticated user by zero.zsh.org with local id 1mAqv2-0009xb-Sx; Tue, 03 Aug 2021 09:41:04 +0000 Authentication-Results: zsh.org; iprev=pass (mail-wr1-f46.google.com) smtp.remote-ip=209.85.221.46; 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-f46.google.com ([209.85.221.46]:36494) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_128_GCM_SHA256:128) id 1mAquJ-0009G2-DQ; Tue, 03 Aug 2021 09:40:20 +0000 Received: by mail-wr1-f46.google.com with SMTP id b13so13733663wrs.3 for ; Tue, 03 Aug 2021 02:40:19 -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=GQIRRXWfv7j4W4ESPVeOdCGJX7fHn+CnTSqX8DAvKG8=; b=f4Xyw+5Xpb7/uIqur3uPfN7yuKpiCNSVcreU9zdg/n+n4V7wn73tVQ5HudSdrJRvNQ KvLW0Z8h1X38uqJouc4uY7z4bXArnfsuUwV42X+0eNvQ1+AN4/behq/FL4UQUmsNfSJJ 4GrO3Uv466Di5GiVfVWRO2ZebpHwOTT1V9Hk5otZIqFPh7bWbHa5qcPh2AfPOIItolrS M63OsILOh+rwKrCi5AV9yiMVJgUPtrLxMLBRTXpLBPIuIJLCYOT+ldODFTUW8pg9AbxH ++cerPqYsrw0v8o1qYzOjMEoh0ErWCwY/S6Sk/HMc5rSqgB1dNjptN/ZbpYl5P/WkKlo vyvg== 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=GQIRRXWfv7j4W4ESPVeOdCGJX7fHn+CnTSqX8DAvKG8=; b=KZduTYrtO5o/R7g4IE1hJXOp+FDg90shmuHiAyAyjLv8Amm8ln4Sk7w5Ll0SC58cIr Y4qr/Vhw8xtpzVZlwzGwqnPTZIawzpOmMUg3/UoF5IQJ2yRqz0jwroELUkeJt/xOsFjL a5iJeqTit0cfsuERj9CYEdSKXajfZfotL8fjyh0QxWYQAnWO9Nc0Od4c5feJw2Q68OQ9 kWpgQ2co3qGambh1SBuCS+ZCPIimBr6xbOg1qIVh6e2lXMtvC3+zc/vsdonqB2Vhx2ts BNI8x0dE7NTpUkk63ZogN++jddldLloslmLtqht3BJNKL0p7UX4uoi7i2DwR3QcETdfE XQ5Q== X-Gm-Message-State: AOAM5309xfvg2H6b+9+Kenqn4vRbmxZJY9zr1ApPIqmKGaPSjdVZiveI f6VTzFtSMBkqmZ4pGbh8zkOlPWwIOTt16HAEoCg= X-Google-Smtp-Source: ABdhPJwS6Jg4yEuwn5SefFWNCQPu5OlMPI67V9rYvZM09d3zko9WE3lCQDnGnnqOiV81ND9MVzM7JGV2jyTIhBihR8g= X-Received: by 2002:a05:6000:92:: with SMTP id m18mr21844817wrx.277.1627983618925; Tue, 03 Aug 2021 02:40:18 -0700 (PDT) MIME-Version: 1.0 References: <20210801163314.toawcsrtj6eqydxr@chazelas.org> <740562670.624981.1627980275012@mail2.virginmedia.com> In-Reply-To: <740562670.624981.1627980275012@mail2.virginmedia.com> From: Zach Riggle Date: Tue, 3 Aug 2021 04:40:07 -0500 Message-ID: Subject: Re: Better Help Docs Searching? To: Peter Stephenson Cc: Zsh Users Content-Type: text/plain; charset="UTF-8" X-Seq: 26839 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: Peter ## Building Docs from Source Thanks for the information. I might be misinterpreting your information ("earlier stage...uses what's there") so I tried a "make all" and the Docs/ directory seems to be in an even worse situation. I also took "If you don't have Yodl" to mean "not having Yodl installed / a yodl binary in $PATH". I don't see anything that I can "brew install" that handles this, and having checked out the source code for yodl (https://gitlab.com/fbb-git/yodl.git). Building YODL itself requires "icmake" which is unavailable, and not installable via "brew" (Homebrew). ## Using the Docs from SourceForge > If you don't have Yodl you can grab the doc package from the same place as the > source package and it has all this pre-built I do see SourceForge has [1] a zsh-5.8-doc.tar.xz, which may be what you referred to. It has the pre-built source, a pre-built PDF, and does appear to have some ".info" files pre-built. After extraction, running the command "info -f Doc/zsh.info" works. Selecting the "17 Shell Builtin Commands" section, I can hit shift-i to go to an "Index Entry". This is good! Before there were no indices. Typing in "read" the index prompt, takes me to the first incidence of the word "read" (which is under the ". FILE" section), which isn't much better than the man-pages or web-browser search. Hitting the comma key (",") to move to the next match cycles between matches, but never actually arrives at the documentation for the "read" builtin [2]. [1]: https://zsh.sourceforge.io/Arc/source.html [2]: https://i.imgur.com/2dPlevy.png Zach Riggle On Tue, Aug 3, 2021 at 3:45 AM Peter Stephenson wrote: > > > On 03 August 2021 at 09:09 Zach Riggle wrote: > > 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 > > zsh.texi is generated by an earlier stage from the Yodl source; makeinfo simply uses what's > there. If you don't have Yodl you can grab the doc package from the same place as the > source package and it has all this pre-built. > > pws >