GNU bug report logs - #28237
25.2; doc string of `Info-virtual-nodes'

Previous Next

Full log

View this message in rfc822 format

From: Drew Adams <drew.adams <at> oracle.com>
To: 28237 <at> debbugs.gnu.org
Subject: bug#28237: 25.2; doc string of `Info-virtual-nodes'
Date: Fri, 25 Aug 2017 15:05:20 -0700 (PDT)

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?


In GNU Emacs 25.2.1 (x86_64-w64-mingw32)
 of 2017-04-24
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --without-dbus --without-compress-install 'CFLAGS=-O2
 -static -g3''

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.