Subject: Re: bug#28237: 25.2; doc string of `Info-virtual-nodes'

From: Lars Ingebrigtsen <[email-masked]>
Date: Mon, 15 Jul 2019 13:51:05 +0200

Drew Adams <[email-masked]> writes:

> Neither OPERATION nor HANDLER is specified well.
>
> 1. These parts of the doc string are incomprehensible:
>
>      OPERATION is one of the following operation symbols `find-node'
>                   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>      that define what HANDLER function to call instead of calling the
>      default corresponding function to override it.
>      ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
>    I can't even parse the first bit.  Is it trying to say that OPERATION
>    must be `find-node'?  (No idea.)
>
>    The second bit: what is the "default corresponding function"?  What
>    does that mean?  Default wrt what?  Corresponding to what?
>
> 2. HANDLER is not specified at all.  No doubt it is a function.  But
>    what arguments can or must the function accept?

Looks like Eli fixed this at the time but forgot to close this report.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no