Thanks. That was helpful, as always. And it's a fine command to have for a macro that inserts links to other files.
Just wondering: I haven't seen this command so far. Is it documented? Is there a list of the complete set of commands available in the actual beta of NW Pro?
Such a list should (we've done all we could to limit the creation of new commands), be in the next version of the beta manual. This should get posted sometime on May 17.
It turns out that the version that's got all the new macro commands is not a public beta ("not ready for prime time"). And, therefore the manual that goes with it is not public either.
I'm afraid you'll simply have to be patient as we smooth out all the kinks.