zsh-workers
 help / color / mirror / code / Atom feed
* install.info failure
@ 2021-05-22 13:11 Vin Shelton
  2021-05-22 13:23 ` Daniel Shahaf
  0 siblings, 1 reply; 19+ messages in thread
From: Vin Shelton @ 2021-05-22 13:11 UTC (permalink / raw)
  To: Zsh Hackers' List

[-- Attachment #1: Type: text/plain, Size: 1156 bytes --]

From the latest sources on Arch linux, I am getting the following error:

make install.info
make[1]: Entering directory '/SSD-2/opt/build/zsh-2021-05-22/Doc'
/bin/sh ../../../src/zsh-2021-05-22/mkinstalldirs
/opt/zsh-2021-05-22/share/info
rm -rf infodir
mkdir infodir
if ( \
    sed '/^@setfilename/s|zsh|zsh|' \
< ../../../src/zsh-2021-05-22/Doc/zsh.texi > infodir/tzsh.texi && \
    (cd infodir && makeinfo tzsh.texi) && \
    for file in infodir/zsh.info*; do \
/usr/bin/install -c -m 644 $file /opt/zsh-2021-05-22/share/info || exit 1; \
    done \
); then \
    if /bin/sh -c 'install-info --version' >/dev/null 2>&1; then \
      install-info --info-dir=/opt/zsh-2021-05-22/share/info \
        /opt/zsh-2021-05-22/share/info/zsh.info; \
    else true; fi; \
    rm -rf infodir; \
    exit 0; \
else \
    rm -rf infodir; \
    exit 1; \
fi
tzsh.texi:37730: @ref reference to nonexistent node `Manipulating Hook
Functions'
make[1]: *** [Makefile:497: install.info] Error 1
make[1]: Leaving directory '/SSD-2/opt/build/zsh-2021-05-22/Doc'
make: *** [Makefile:255: install.info] Error 2

Please let me know if you require more details.

Regards,
  Vin

[-- Attachment #2: Type: text/html, Size: 2215 bytes --]

^ permalink raw reply	[flat|nested] 19+ messages in thread

* Re: install.info failure
  2021-05-22 13:11 install.info failure Vin Shelton
@ 2021-05-22 13:23 ` Daniel Shahaf
  2021-05-24 20:22   ` Daniel Shahaf
  0 siblings, 1 reply; 19+ messages in thread
From: Daniel Shahaf @ 2021-05-22 13:23 UTC (permalink / raw)
  To: Vin Shelton, Zsh Hackers' List

Vin Shelton wrote on Sat, 22 May 2021 13:11 +00:00:
> tzsh.texi:37730: @ref reference to nonexistent node `Manipulating Hook Functions'

Regression from 48853, which added a noderef() to something that isn't
the argument of a texinode().

> make[1]: *** [Makefile:497: install.info] Error 1
> make[1]: Leaving directory '/SSD-2/opt/build/zsh-2021-05-22/Doc'
> make: *** [Makefile:255: install.info] Error 2
> 
> Please let me know if you require more details.

Nope, the cause is clear.  Thanks for the report.  To unbreak the build
you can simply s/noderef(Manipulating Hook Functions)/`Manipulating Hook
Functions'/ in Doc/Zsh/contrib.yo.  (To be clear, this is just a hotfix to unbreak
Vin's build, not a change to be committed.)

Cheers,

Daniel


^ permalink raw reply	[flat|nested] 19+ messages in thread

* Re: install.info failure
  2021-05-22 13:23 ` Daniel Shahaf
@ 2021-05-24 20:22   ` Daniel Shahaf
  2021-05-25  4:00     ` Jun T
  2021-05-25 20:58     ` Marlon Richert
  0 siblings, 2 replies; 19+ messages in thread
From: Daniel Shahaf @ 2021-05-24 20:22 UTC (permalink / raw)
  To: Marlon Richert; +Cc: Zsh Hackers' List

Daniel Shahaf wrote on Sat, May 22, 2021 at 13:23:35 +0000:
> Vin Shelton wrote on Sat, 22 May 2021 13:11 +00:00:
> > tzsh.texi:37730: @ref reference to nonexistent node `Manipulating Hook Functions'
> 
> Regression from 48853, which added a noderef() to something that isn't
> the argument of a texinode().

Marlon, that's your patch.  Would you care to send a revision?  It is
expected that whoever breaks the build fix it.

> > make[1]: *** [Makefile:497: install.info] Error 1
> > make[1]: Leaving directory '/SSD-2/opt/build/zsh-2021-05-22/Doc'
> > make: *** [Makefile:255: install.info] Error 2
> > 
> > Please let me know if you require more details.
> 
> Nope, the cause is clear.  Thanks for the report.  To unbreak the build
> you can simply s/noderef(Manipulating Hook Functions)/`Manipulating Hook
> Functions'/ in Doc/Zsh/contrib.yo.  (To be clear, this is just a hotfix to unbreak
> Vin's build, not a change to be committed.)
> 
> Cheers,
> 
> Daniel
> 


^ permalink raw reply	[flat|nested] 19+ messages in thread

* Re: install.info failure
  2021-05-24 20:22   ` Daniel Shahaf
@ 2021-05-25  4:00     ` Jun T
  2021-05-25  6:48       ` Bart Schaefer
  2021-05-25 20:58     ` Marlon Richert
  1 sibling, 1 reply; 19+ messages in thread
From: Jun T @ 2021-05-25  4:00 UTC (permalink / raw)
  To: zsh-workers


> 2021/05/25 5:22、Daniel Shahaf <d.s@daniel.shahaf.name>のメール:
> 
> Daniel Shahaf wrote on Sat, May 22, 2021 at 13:23:35 +0000:
>> Vin Shelton wrote on Sat, 22 May 2021 13:11 +00:00:
>>> tzsh.texi:37730: @ref reference to nonexistent node `Manipulating Hook Functions'
>> 
>> Regression from 48853, which added a noderef() to something that isn't
>> the argument of a texinode().

I was not following this thread, but 'make html' also fails after the commit.

@ref can refer only to a node or an anchor.
A simple fix is to add a new yodl macro 'anchor' and put an anchor at the
subsection 'Manipulating Hook Functions'.


diff --git a/Doc/Zsh/contrib.yo b/Doc/Zsh/contrib.yo
index a972f08d6..12ad3198a 100644
--- a/Doc/Zsh/contrib.yo
+++ b/Doc/Zsh/contrib.yo
@@ -287,6 +287,7 @@ any prefix, even a single letter; thus tt(a) is the same as tt(aliases),
 tt(z) is the same as tt(zstyles), etc.
 enditem()
 
+anchor(Manipulating Hook Functions)
 subsect(Manipulating Hook Functions)
 cindex(hook function utility)
 
diff --git a/Doc/ztexi.yo b/Doc/ztexi.yo
index 50bae6d48..c22f71b2d 100644
--- a/Doc/ztexi.yo
+++ b/Doc/ztexi.yo
@@ -155,6 +155,7 @@ def(zmanref)(1)(manref(ARG1)(1))
 def(noderef)(1)(\
   NOTRANS(@ref{)ARG1+NOTRANS(})\
 )
+def(anchor)(1)(NOTRANS(@anchor{)ARG1+NOTRANS(}))
 
 COMMENT(--- lists ---)
 



^ permalink raw reply	[flat|nested] 19+ messages in thread

* Re: install.info failure
  2021-05-25  4:00     ` Jun T
@ 2021-05-25  6:48       ` Bart Schaefer
  2021-05-25  8:25         ` Jun T
  0 siblings, 1 reply; 19+ messages in thread
From: Bart Schaefer @ 2021-05-25  6:48 UTC (permalink / raw)
  To: Jun T; +Cc: Zsh hackers list

[-- Attachment #1: Type: text/plain, Size: 287 bytes --]

On Mon, May 24, 2021 at 9:02 PM Jun T <takimoto-j@kba.biglobe.ne.jp> wrote:

>
> A simple fix is to add a new yodl macro 'anchor' and put an anchor at the
> subsection 'Manipulating Hook Functions'.
>

I've wondered for a while why we did not add anchor creation to the
subsect() macro.

[-- Attachment #2: Type: text/html, Size: 595 bytes --]

^ permalink raw reply	[flat|nested] 19+ messages in thread

* Re: install.info failure
  2021-05-25  6:48       ` Bart Schaefer
@ 2021-05-25  8:25         ` Jun T
  2021-05-25 16:00           ` Bart Schaefer
  2021-05-25 16:47           ` Daniel Shahaf
  0 siblings, 2 replies; 19+ messages in thread
From: Jun T @ 2021-05-25  8:25 UTC (permalink / raw)
  To: zsh-workers



> 2021/05/25 15:48, Bart Schaefer <schaefer@brasslantern.com> wrote:
> 
> On Mon, May 24, 2021 at 9:02 PM Jun T <takimoto-j@kba.biglobe.ne.jp> wrote:
> 
> A simple fix is to add a new yodl macro 'anchor' and put an anchor at the
> subsection 'Manipulating Hook Functions'.
> 
> I've wondered for a while why we did not add anchor creation to the subsect() macro.

This sounded a good idea, so I tried (in ztexi.yo):

def(subsect)(1)(\
  NL()\
  anchor(ARG1)NL()\
  NOTRANS(@subsection )ARG1+NL()\
  NOTRANS(@noindent)\
)

but I got many duplicated node/anchor names errors:

/zsh.texi:4346: @anchor `Overview' previously defined
./zsh.texi:4344: here is the previous definition as @node

I tried adding a prefix SS- to the subsection anchor name:

def(subsect)(1)(\
  NL()\
  anchor(SS-ARG1)NL()\
  NOTRANS(@subsection )ARG1+NL()\
  NOTRANS(@noindent)\
)

but still got may (16?) duplicated names like:

./zsh.texi:10007: @anchor `SS-Completion' previously defined
./zsh.texi:586: here is the previous definition as @anchor

subsect(Completion) is in 4 files:
options.yo
roadmap.yo
zftpsys.yo
zle.yo

I can't find a way to automatically assign unique (but easy to refer)
anchor name.

^ permalink raw reply	[flat|nested] 19+ messages in thread

* Re: install.info failure
  2021-05-25  8:25         ` Jun T
@ 2021-05-25 16:00           ` Bart Schaefer
  2021-05-25 16:47           ` Daniel Shahaf
  1 sibling, 0 replies; 19+ messages in thread
From: Bart Schaefer @ 2021-05-25 16:00 UTC (permalink / raw)
  To: Jun T; +Cc: Zsh hackers list

[-- Attachment #1: Type: text/plain, Size: 223 bytes --]

On Tue, May 25, 2021, 1:26 AM Jun T <takimoto-j@kba.biglobe.ne.jp> wrote:

>
>
> I can't find a way to automatically assign unique (but easy to refer)
> anchor name.
>


At least that explains why it wasn't done before.

>

[-- Attachment #2: Type: text/html, Size: 758 bytes --]

^ permalink raw reply	[flat|nested] 19+ messages in thread

* Re: install.info failure
  2021-05-25  8:25         ` Jun T
  2021-05-25 16:00           ` Bart Schaefer
@ 2021-05-25 16:47           ` Daniel Shahaf
  1 sibling, 0 replies; 19+ messages in thread
From: Daniel Shahaf @ 2021-05-25 16:47 UTC (permalink / raw)
  To: zsh-workers

Jun T wrote on Tue, 25 May 2021 08:25 +00:00:
> I tried adding a prefix SS- to the subsection anchor name:
> 
> def(subsect)(1)(\
>   NL()\
>   anchor(SS-ARG1)NL()\
>   NOTRANS(@subsection )ARG1+NL()\
>   NOTRANS(@noindent)\
> )
> 
> but still got may (16?) duplicated names like:
> 
> ./zsh.texi:10007: @anchor `SS-Completion' previously defined
> ./zsh.texi:586: here is the previous definition as @anchor
> 
> subsect(Completion) is in 4 files:
> options.yo
> roadmap.yo
> zftpsys.yo
> zle.yo
> 
> I can't find a way to automatically assign unique (but easy to refer)
> anchor name.

Change the definition of sect() to store the section title in a (yodl or
TeX) macro, and then use that when calling anchor() in subsect()?  Or
change subsect() to take two arguments, an anchor id and a title, and
update all uses of it (there are no compatibility concerns)?

Actually, something like this might already exist, since the PDF
manual's page headers _already_ include the chapter's number and name.


^ permalink raw reply	[flat|nested] 19+ messages in thread

* Re: install.info failure
  2021-05-24 20:22   ` Daniel Shahaf
  2021-05-25  4:00     ` Jun T
@ 2021-05-25 20:58     ` Marlon Richert
  2021-05-25 21:54       ` Bart Schaefer
  2021-05-25 22:16       ` dana
  1 sibling, 2 replies; 19+ messages in thread
From: Marlon Richert @ 2021-05-25 20:58 UTC (permalink / raw)
  To: Daniel Shahaf; +Cc: Zsh Hackers' List

On Mon, May 24, 2021 at 11:22 PM Daniel Shahaf <d.s@daniel.shahaf.name> wrote:
>
> Daniel Shahaf wrote on Sat, May 22, 2021 at 13:23:35 +0000:
> > Vin Shelton wrote on Sat, 22 May 2021 13:11 +00:00:
> > > tzsh.texi:37730: @ref reference to nonexistent node `Manipulating Hook Functions'
> >
> > Regression from 48853, which added a noderef() to something that isn't
> > the argument of a texinode().
>
> Marlon, that's your patch.  Would you care to send a revision?  It is
> expected that whoever breaks the build fix it.

I would be grateful if someone else could post a fix for that. The
build script doesn't know how to build man pages and help files on
macOS. The problem is that there is no yodl for macOS and porting it
is a daunting task. This makes it rather impossible for me to know
whether I'm making the right change.


^ permalink raw reply	[flat|nested] 19+ messages in thread

* Re: install.info failure
  2021-05-25 20:58     ` Marlon Richert
@ 2021-05-25 21:54       ` Bart Schaefer
  2021-05-25 22:16       ` dana
  1 sibling, 0 replies; 19+ messages in thread
From: Bart Schaefer @ 2021-05-25 21:54 UTC (permalink / raw)
  To: Marlon Richert; +Cc: Daniel Shahaf, Zsh Hackers' List

On Tue, May 25, 2021 at 1:59 PM Marlon Richert <marlon.richert@gmail.com> wrote:
>
> On Mon, May 24, 2021 at 11:22 PM Daniel Shahaf <d.s@daniel.shahaf.name> wrote:
> >
> > > Regression from 48853, which added a noderef() to something that isn't
> > > the argument of a texinode().
>
> I would be grateful if someone else could post a fix for that.

The fix could be to do what Daniel suggested in workers/48900, or to
remove the ifzman/ifnzman distinction and use the "... above" text for
both, or it could be to remove the cross-reference entirely.

Your call.


^ permalink raw reply	[flat|nested] 19+ messages in thread

* Re: install.info failure
  2021-05-25 20:58     ` Marlon Richert
  2021-05-25 21:54       ` Bart Schaefer
@ 2021-05-25 22:16       ` dana
  2021-05-27 18:26         ` Marlon Richert
  1 sibling, 1 reply; 19+ messages in thread
From: dana @ 2021-05-25 22:16 UTC (permalink / raw)
  To: Marlon Richert; +Cc: Zsh Hackers' List

On 25 May 2021, at 15:58, Marlon Richert <marlon.richert@gmail.com> wrote:
> The problem is that there is no yodl for macOS and porting it
> is a daunting task.

FYI, you can use the yodl package from MacPorts. That's what i've always done.
It's been 2 or 3 years since i messed with it, but on my Catalina machine i
seem to have used this:

http://packages.macports.org/yodl/yodl-3.05.01_0.darwin_18.x86_64.tbz2

(No idea how long they keep these around, but the link works at the moment)

I think you need to re-./configure after installing

dana



^ permalink raw reply	[flat|nested] 19+ messages in thread

* Re: install.info failure
  2021-05-25 22:16       ` dana
@ 2021-05-27 18:26         ` Marlon Richert
  2021-05-31 22:33           ` Bart Schaefer
  0 siblings, 1 reply; 19+ messages in thread
From: Marlon Richert @ 2021-05-27 18:26 UTC (permalink / raw)
  To: dana; +Cc: Zsh Hackers' List

[-- Attachment #1: Type: text/plain, Size: 136 bytes --]

On Wed, May 26, 2021 at 1:13 AM dana <dana@dana.is> wrote:
>
> FYI, you can use the yodl package from MacPorts.

Thanks! Here's my fix:

[-- Attachment #2: 0001-Add-missing-node-refs-in-contrib.yo.txt --]
[-- Type: text/plain, Size: 2136 bytes --]

From be0a3817622ba2d8fe2275c016b11b562727c97f Mon Sep 17 00:00:00 2001
From: Marlon Richert <marlon.richert@gmail.com>
Date: Thu, 27 May 2021 21:22:24 +0300
Subject: [PATCH] Add missing node refs in contrib.yo

---
 Doc/Zsh/contrib.yo | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/Doc/Zsh/contrib.yo b/Doc/Zsh/contrib.yo
index a972f08d6..eb001e96f 100644
--- a/Doc/Zsh/contrib.yo
+++ b/Doc/Zsh/contrib.yo
@@ -26,6 +26,15 @@ endmenu()
 texinode(Utilities)(Recent Directories)()(User Contributions)
 sect(Utilities)
 
+startmenu()
+menu(Accessing On-Line Help)
+menu(Recompiling Functions)
+menu(Keyboard Definition)
+menu(Dumping Shell State)
+menu(Manipulating Hook Functions)
+endmenu()
+
+texinode(Accessing On-Line Help)(Recompiling Functions)()(Utilities)
 subsect(Accessing On-Line Help)
 cindex(helpfiles utility)
 
@@ -80,6 +89,7 @@ ifnzman(noderef(Parameters Used By The Shell))\
 installation; if it is not, copy tt(Functions/Misc/run-help) to an
 appropriate directory.
 
+texinode(Recompiling Functions)(Keyboard Definition)(Accessing On-Line Help)(Utilities)
 subsect(Recompiling Functions)
 cindex(functions, recompiling)
 cindex(zrecompile utility)
@@ -168,6 +178,7 @@ Once the digests have been created and your tt(fpath) modified to refer to
 them, you can keep them up to date by running tt(zrecompile) with no
 arguments.
 
+texinode(Keyboard Definition)(Dumping Shell State)(Recompiling Functions)(Utilities)
 subsect(Keyboard Definition)
 cindex(keyboard definition)
 
@@ -211,6 +222,7 @@ ifnzman(noderef(Parameters Used By The Shell))\
 installation; if it is not, copy tt(Functions/Misc/zkbd) to an
 appropriate directory.
 
+texinode(Dumping Shell State)(Manipulating Hook Functions)(Keyboard Definition)(Utilities)
 subsect(Dumping Shell State)
 cindex(reporter utility)
 
@@ -287,6 +299,7 @@ any prefix, even a single letter; thus tt(a) is the same as tt(aliases),
 tt(z) is the same as tt(zstyles), etc.
 enditem()
 
+texinode(Manipulating Hook Functions)()(Dumping Shell State)(Utilities)
 subsect(Manipulating Hook Functions)
 cindex(hook function utility)
 
-- 
2.30.1 (Apple Git-130)


^ permalink raw reply	[flat|nested] 19+ messages in thread

* Re: install.info failure
  2021-05-27 18:26         ` Marlon Richert
@ 2021-05-31 22:33           ` Bart Schaefer
  2021-06-01 10:44             ` Marlon Richert
  0 siblings, 1 reply; 19+ messages in thread
From: Bart Schaefer @ 2021-05-31 22:33 UTC (permalink / raw)
  To: Marlon Richert; +Cc: dana, Zsh Hackers' List

On Thu, May 27, 2021 at 11:27 AM Marlon Richert
<marlon.richert@gmail.com> wrote:
>
> On Wed, May 26, 2021 at 1:13 AM dana <dana@dana.is> wrote:
> >
> > FYI, you can use the yodl package from MacPorts.
>
> Thanks! Here's my fix:

Anyone object to this?  It changes the structure from a single page
flow in the info browser, to a series of separate pages where the
first one contains nothing but a menu.

Most other chapters with multiple internal nodes include at least one
introductory paragraph along with the menu.

I don't personally have much opinion one way or the other, if no one
else does I can commit this.  It does fix the build problem.


^ permalink raw reply	[flat|nested] 19+ messages in thread

* Re: install.info failure
  2021-05-31 22:33           ` Bart Schaefer
@ 2021-06-01 10:44             ` Marlon Richert
  2021-06-02  6:33               ` Bart Schaefer
  0 siblings, 1 reply; 19+ messages in thread
From: Marlon Richert @ 2021-06-01 10:44 UTC (permalink / raw)
  To: Bart Schaefer; +Cc: dana, Zsh Hackers' List

[-- Attachment #1: Type: text/plain, Size: 819 bytes --]

On Tue, Jun 1, 2021 at 1:33 AM Bart Schaefer <schaefer@brasslantern.com> wrote:
>
> On Thu, May 27, 2021 at 11:27 AM Marlon Richert
> <marlon.richert@gmail.com> wrote:
> >
> > On Wed, May 26, 2021 at 1:13 AM dana <dana@dana.is> wrote:
> > >
> > > FYI, you can use the yodl package from MacPorts.
> >
> > Thanks! Here's my fix:
>
> Anyone object to this?  It changes the structure from a single page
> flow in the info browser, to a series of separate pages where the
> first one contains nothing but a menu.
>
> Most other chapters with multiple internal nodes include at least one
> introductory paragraph along with the menu.
>
> I don't personally have much opinion one way or the other, if no one
> else does I can commit this.  It does fix the build problem.

Instead of an introductory paragraph, how about this?

[-- Attachment #2: 0001-Add-missing-node-refs-in-contrib.yo-change-Utilities.txt --]
[-- Type: text/plain, Size: 5434 bytes --]

From 07e6f6889223068450e3a56ee046563f5ef0e59b Mon Sep 17 00:00:00 2001
From: Marlon Richert <marlon.richert@gmail.com>
Date: Tue, 1 Jun 2021 13:17:29 +0300
Subject: [PATCH] Add missing node refs in contrib.yo & change Utilities
 subsections to sections

---
 Doc/Zsh/contrib.yo | 47 +++++++++++++++++++++++++++-------------------
 Doc/Zsh/manual.yo  |  6 +++++-
 2 files changed, 33 insertions(+), 20 deletions(-)

diff --git a/Doc/Zsh/contrib.yo b/Doc/Zsh/contrib.yo
index a972f08d6..6861e98fd 100644
--- a/Doc/Zsh/contrib.yo
+++ b/Doc/Zsh/contrib.yo
@@ -10,7 +10,11 @@ these are documented here.  For documentation on other contributed items
 such as shell functions, look for comments in the function source files.
 
 startmenu()
-menu(Utilities)
+menu(Accessing On-Line Help)
+menu(Recompiling Functions)
+menu(Keyboard Definition)
+menu(Dumping Shell State)
+menu(Manipulating Hook Functions)
 menu(Recent Directories)
 menu(Other Directory Functions)
 menu(Version Control Information)
@@ -23,10 +27,8 @@ menu(User Configuration Functions)
 menu(Other Functions)
 endmenu()
 
-texinode(Utilities)(Recent Directories)()(User Contributions)
-sect(Utilities)
-
-subsect(Accessing On-Line Help)
+texinode(Accessing On-Line Help)(Recompiling Functions)()(User Contributions)
+sect(Accessing On-Line Help)
 cindex(helpfiles utility)
 
 The key sequence tt(ESC h) is normally bound by ZLE to execute the
@@ -80,7 +82,8 @@ ifnzman(noderef(Parameters Used By The Shell))\
 installation; if it is not, copy tt(Functions/Misc/run-help) to an
 appropriate directory.
 
-subsect(Recompiling Functions)
+texinode(Recompiling Functions)(Keyboard Definition)(Accessing On-Line Help)(User Contributions)
+sect(Recompiling Functions)
 cindex(functions, recompiling)
 cindex(zrecompile utility)
 
@@ -168,7 +171,8 @@ Once the digests have been created and your tt(fpath) modified to refer to
 them, you can keep them up to date by running tt(zrecompile) with no
 arguments.
 
-subsect(Keyboard Definition)
+texinode(Keyboard Definition)(Dumping Shell State)(Recompiling Functions)(User Contributions)
+sect(Keyboard Definition)
 cindex(keyboard definition)
 
 findex(zkbd)
@@ -211,7 +215,8 @@ ifnzman(noderef(Parameters Used By The Shell))\
 installation; if it is not, copy tt(Functions/Misc/zkbd) to an
 appropriate directory.
 
-subsect(Dumping Shell State)
+texinode(Dumping Shell State)(Manipulating Hook Functions)(Keyboard Definition)(User Contributions)
+sect(Dumping Shell State)
 cindex(reporter utility)
 
 Occasionally you may encounter what appears to be a bug in the shell,
@@ -287,7 +292,8 @@ any prefix, even a single letter; thus tt(a) is the same as tt(aliases),
 tt(z) is the same as tt(zstyles), etc.
 enditem()
 
-subsect(Manipulating Hook Functions)
+texinode(Manipulating Hook Functions)(Recent Directories)(Dumping Shell State)(User Contributions)
+sect(Manipulating Hook Functions)
 cindex(hook function utility)
 
 startitem()
@@ -378,7 +384,7 @@ hooks, then all hooks should be managed only via this function.
 )
 enditem()
 
-texinode(Recent Directories)(Other Directory Functions)(Utilities)(User Contributions)
+texinode(Recent Directories)(Other Directory Functions)(Manipulating Hook Functions)(User Contributions)
 cindex(recent directories, maintaining list of)
 cindex(directories, maintaining list of recent)
 findex(cdr)
@@ -4358,9 +4364,10 @@ The return status is 0 if at least one match was performed, else 1.
 findex(run-help)
 item(tt(run-help) var(cmd))(
 This function is designed to be invoked by the tt(run-help) ZLE widget,
-in place of the default alias.  See `Accessing On-Line Help'
-ifzman(above)\
-ifnzman((noderef(Utilities))) for setup instructions.
+in place of the default alias.  See 
+ifzman(see the bf(Accessing On-Line Help) section above)\
+ifnzman(noderef(Accessing On-Line Help)) 
+for setup instructions.
 
 In the discussion which follows, if var(cmd) is a file system path, it is
 first reduced to its rightmost component (the file name).
@@ -4580,9 +4587,10 @@ appear in the zsh distribution, but can be created by linking tt(zmv) to
 the names tt(zcp) and tt(zln) in some directory in your tt(fpath).
 )
 item(tt(zkbd))(
-See `Keyboard Definition'
-ifzman(above)\
-ifnzman((noderef(Utilities))).
+See 
+ifzman(see the bf(Keyboard Definition) section above)\
+ifnzman(noderef(Keyboard Definition))\
+.
 )
 findex(zmv)
 redef(SPACES)(0)(tt(ifztexi(NOTRANS(@ @ @ @ ))ifnztexi(    )))
@@ -4665,9 +4673,10 @@ tt(zmv) source file, usually located in one of the directories named in
 your tt(fpath), or in tt(Functions/Misc/zmv) in the zsh distribution.
 )
 item(tt(zrecompile))(
-See `Recompiling Functions'
-ifzman(above)\
-ifnzman((noderef(Utilities))).
+See 
+ifzman(see the bf(Recompiling Functions) section above)\
+ifnzman(noderef(Recompiling Functions))\
+.
 )
 findex(zstyle+)
 item(tt(zstyle+) var(context) var(style) var(value) [ tt(+) var(subcontext) var(style) var(value) ... ])(
diff --git a/Doc/Zsh/manual.yo b/Doc/Zsh/manual.yo
index 119849e4c..7fd670abe 100644
--- a/Doc/Zsh/manual.yo
+++ b/Doc/Zsh/manual.yo
@@ -162,7 +162,11 @@ menu(Miscellaneous Features)
 
 User Contributions
 
-menu(Utilities)
+menu(Accessing On-Line Help)
+menu(Recompiling Functions)
+menu(Keyboard Definition)
+menu(Dumping Shell State)
+menu(Manipulating Hook Functions)
 menu(Recent Directories)
 menu(Other Directory Functions)
 menu(Version Control Information)
-- 
2.30.1 (Apple Git-130)


^ permalink raw reply	[flat|nested] 19+ messages in thread

* Re: install.info failure
  2021-06-01 10:44             ` Marlon Richert
@ 2021-06-02  6:33               ` Bart Schaefer
  2021-06-04 21:49                 ` dana
  0 siblings, 1 reply; 19+ messages in thread
From: Bart Schaefer @ 2021-06-02  6:33 UTC (permalink / raw)
  To: Marlon Richert; +Cc: dana, Zsh Hackers' List

On Tue, Jun 1, 2021 at 3:45 AM Marlon Richert <marlon.richert@gmail.com> wrote:
>
> On Tue, Jun 1, 2021 at 1:33 AM Bart Schaefer <schaefer@brasslantern.com> wrote:
> >
> > Anyone object to this?  It changes the structure from a single page
> > flow in the info browser, to a series of separate pages where the
> > first one contains nothing but a menu.
> >
> > Most other chapters with multiple internal nodes include at least one
> > introductory paragraph along with the menu.
>
> Instead of an introductory paragraph, how about this?

This one removes the "Utilities" section entirely and puts its
subsections directly into the "User Contributions" menu.

Anyone else care to comment on that?


^ permalink raw reply	[flat|nested] 19+ messages in thread

* Re: install.info failure
  2021-06-02  6:33               ` Bart Schaefer
@ 2021-06-04 21:49                 ` dana
  2021-06-05 16:09                   ` Bart Schaefer
  0 siblings, 1 reply; 19+ messages in thread
From: dana @ 2021-06-04 21:49 UTC (permalink / raw)
  To: Bart Schaefer; +Cc: Marlon Richert, Zsh Hackers' List

On 2 Jun 2021, at 01:33, Bart Schaefer <schaefer@brasslantern.com> wrote:
> Anyone else care to comment on that?

I'm not sure I understand the root issue here, but, just in terms of
consistency with the rest of the documentation, neither of the proposed
changes seem ideal, do they? I don't know enough about Yodl to know what else
to do off the top of my head, though

dana



^ permalink raw reply	[flat|nested] 19+ messages in thread

* Re: install.info failure
  2021-06-04 21:49                 ` dana
@ 2021-06-05 16:09                   ` Bart Schaefer
  2021-06-13 18:23                     ` [PATCH] " Bart Schaefer
  0 siblings, 1 reply; 19+ messages in thread
From: Bart Schaefer @ 2021-06-05 16:09 UTC (permalink / raw)
  To: dana; +Cc: Marlon Richert, Zsh Hackers' List

On Fri, Jun 4, 2021 at 2:49 PM dana <dana@dana.is> wrote:
>
> On 2 Jun 2021, at 01:33, Bart Schaefer <schaefer@brasslantern.com> wrote:
> > Anyone else care to comment on that?
>
> I'm not sure I understand the root issue here, but, just in terms of
> consistency with the rest of the documentation, neither of the proposed
> changes seem ideal, do they? I don't know enough about Yodl to know what else
> to do off the top of my head, though

Consistency with what was previously there would be to remove the
linked cross-reference and just make a plain-text reference to the
other section.  All this stuff that Marlon is doing is adding to the
internal linkages, which is well-intentioned but unrelated to the
original change that created the build problem.


^ permalink raw reply	[flat|nested] 19+ messages in thread

* [PATCH] Re: install.info failure
  2021-06-05 16:09                   ` Bart Schaefer
@ 2021-06-13 18:23                     ` Bart Schaefer
  0 siblings, 0 replies; 19+ messages in thread
From: Bart Schaefer @ 2021-06-13 18:23 UTC (permalink / raw)
  To: Zsh Hackers' List; +Cc: Marlon Richert

[-- Attachment #1: Type: text/plain, Size: 530 bytes --]

On Sat, Jun 5, 2021 at 9:09 AM Bart Schaefer <schaefer@brasslantern.com> wrote:
>
> Consistency with what was previously there would be to remove the
> linked cross-reference and just make a plain-text reference to the
> other section.

Here's a patch to do that, just to un-break the build.

> All this stuff that Marlon is doing is adding to the
> internal linkages, which is well-intentioned but unrelated to the
> original change that created the build problem.

If we want to pick some of this up later, nothing prevents it.

[-- Attachment #2: infoxrefgaff.txt --]
[-- Type: text/plain, Size: 746 bytes --]

diff --git a/Doc/Zsh/contrib.yo b/Doc/Zsh/contrib.yo
index a972f08d6..e74528341 100644
--- a/Doc/Zsh/contrib.yo
+++ b/Doc/Zsh/contrib.yo
@@ -2043,9 +2043,8 @@ beyond the scope of tt(localoptions), should your function need that.
 )
 item(Modify hooks)(
 Use of tt(add-zsh-hook) and tt(add-zle-hook-widget) is recommended (see
-ifzman(the bf(Manipulating Hook Functions) section above)\
-ifnzman(noderef(Manipulating Hook Functions))\
-). All hooks that follow the naming pattern tt(prompt_)var(theme)tt(_)var(hook)
+the bf(Manipulating Hook Functions) section above).
+All hooks that follow the naming pattern tt(prompt_)var(theme)tt(_)var(hook)
 are automatically removed when the prompt theme changes or is disabled.
 )
 item(Declare cleanup)(

^ permalink raw reply	[flat|nested] 19+ messages in thread

* Re: install.info failure
@ 2021-06-05 10:47 Thomas Paulsen
  0 siblings, 0 replies; 19+ messages in thread
From: Thomas Paulsen @ 2021-06-05 10:47 UTC (permalink / raw)
  To: zsh-workers

[-- Attachment #1: Type: text/html, Size: 888 bytes --]

^ permalink raw reply	[flat|nested] 19+ messages in thread

end of thread, other threads:[~2021-06-13 18:23 UTC | newest]

Thread overview: 19+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-05-22 13:11 install.info failure Vin Shelton
2021-05-22 13:23 ` Daniel Shahaf
2021-05-24 20:22   ` Daniel Shahaf
2021-05-25  4:00     ` Jun T
2021-05-25  6:48       ` Bart Schaefer
2021-05-25  8:25         ` Jun T
2021-05-25 16:00           ` Bart Schaefer
2021-05-25 16:47           ` Daniel Shahaf
2021-05-25 20:58     ` Marlon Richert
2021-05-25 21:54       ` Bart Schaefer
2021-05-25 22:16       ` dana
2021-05-27 18:26         ` Marlon Richert
2021-05-31 22:33           ` Bart Schaefer
2021-06-01 10:44             ` Marlon Richert
2021-06-02  6:33               ` Bart Schaefer
2021-06-04 21:49                 ` dana
2021-06-05 16:09                   ` Bart Schaefer
2021-06-13 18:23                     ` [PATCH] " Bart Schaefer
2021-06-05 10:47 Thomas Paulsen

Code repositories for project(s) associated with this public inbox

	https://git.vuxu.org/mirror/zsh/

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).