hook_menu doc has some confusing text in it

I see your confusion.

What it's trying to say is that if you have something like this:

 $items['abc/def'] = array(
      'page callback' => 'mymodule_abc_view',
      'page arguments' => array(1, 'foo'),
    );

And you visit path abc/def/ghi/jkl

the function mymodule_abc_view() will get arguments: 'def', 'foo' [from the 'page arguments'], followed by 'ghi', 'jkl' [from the additional path components, as described above that paragraph].

Agreed that this paragraph needs a rewrite, possibly with this example, to make it clearer.

Here's a suggested fix.

Previous patch was incomplete...

Looks like my local copy was outdated, re-rolled against a fresh copy...

I like it! A good concrete example is worth a thousand explanations, to paraphrase the usual picture's value statement.

8.x/7.x please... and then this is probably also worth porting to 6.x, don't you think? Works the same there. If we port to 6.x, we have to move this to the Documentation project, component "api doc files", and mark "patch/to be ported" -- the hook docs are there for 6.x.

Committed to 8.x and 7.x. Thanks!

Since the D6 port is in the Documentation project, I filed it as a separate issue. I didn't want to move this one out of Drupal core.
#1201380: hook_menu doc has some confusing text in it