TomeNET

(3.9b) Alternative macros: Calling objects by their name                        
--------------------------------------------------------
An alternative way to utilize macros is to not rely on item inscriptions, but
instead call the target object directly by its name!

This can either be an item name, as it appears in your inventory, or a spell
name if you want your macro to cast a spell.

The clue is that when you are asked "Aim which wand?", "Read which scroll?",
"Cast from which book?" etc. you can also press '@' key to directly type in
a name.
Note: In the special case of books, you will then be able to type in
a spell name instead of a book name, and the game will search your books for
that spell automatically.

So, instead of inscribing your potions of Healing '@q1' and having a macro
'\e)q1' you could also just have a macro '\e)q@Healing\r'.

Or, instead of inscribing a Beginner Cantrips book '@m1' and macroing the spell
Manathrust with '\e)*tm@11\r9a-' you could also just make a macro
'\e)*tm@11\r@Manathrust\r-' without the need to inscribe your book.

In fact you could make a macro '\e)*tm@Cast a spell\r@Manathrust\r-'.

Another example: '\e)m@11\r@Phase Door\r'.

IMPORTANT: Keep in mind that call-by-name is actually case-sensitive!
(So in the example above, 'Manathrust' would not work.)

Additional details:
-------------------
The text you provide for matching is treated as a partial text (sub-string)
that must occur anywhere in an inventory slot text. Only those inventory slots
are tested for this, which actually contain an item of fitting base type (tval)
for the action that is being executed.

Example: You make a macro   z@Gold-Pl\r  -this will be processed as follows:
The command is 'z' to zap a rod. So only inventory slots that contain rods will
be looked at, the rest is ignored.
Now all inventory slots that contain rods will be tested for whether they
contain the text piece 'Gold-Pl' somewhere.
So if you carry any Gold-Plated rods in your inventory they will be zapped.

Note that since it's really just all about partial-text-matching, you could
inscribe some other rods 'Gold-Pl' so the text matching would succeed, although
they aren't 'real' Gold-Plated rods. (!)