Laura
Occasionally it is useful to give something a printed name because we want to call it something extremely long-winded; give one thing a name that is the subset of the name of something else; or use words such as "with" or "and" that are likely to confuse Inform into thinking that the object name ends before it actually does.
Often it is enough to preface these ambiguously-titled things with "a thing called…" or "a supporter called…" or the like, as here:
prevents Inform from trying to read "Hot and Sour Soup" as two separate rooms, while
creates two objects instead of the one orange ticket that would result if the second sentence were merely "The player carries an orange."
Really long names can be a bit cumbersome. For example:
So we might instead give the photograph a printed name:
Now we've gotten around any awkwardness with printing the name -- but we also need to understand when the player refers to the photograph. When we define the names of objects under normal circumstances, Inform takes care of this automatically, but if we have especially set the printed name, we must also specially define the appropriate terms for the player to use. For this we need "understand", which will be explained in much more depth in a later chapter:
That's probably as far as we really need to go, and if you are satisfied with this behavior, there is no need to read on.
One possible objection to this solution is that Inform will accept some nonsensical formulations as applying to the photograph: for instance, it will allow >EXAMINE PHOTOGRAPH OF, >X BLONDE PHOTOGRAPH WOMAN INCRIMINATING, or even >X OF …though in the case there were two items with "of" names, the game would disambiguate with a question such as "Which do you mean, the incriminating photograph of a woman with blonde hair or the essence of wormwood?"
Traditionally, Inform has tended to be fairly flexible about word order, preferring to err in the direction of leniency. On the other hand, there are times when we need more exacting rules in order to distinguish otherwise similar cases.
Two features allow us to specify more exactly if we so desire. The first is that, if we specify a whole phrase as the name of something, all the words in that phrase are required, in the order given. Thus "Understand "blonde hair" as the photograph" would require that both "blonde" and "hair" be present, and would not recognize >X BLONDE, >X HAIR BLONDE, or >X HAIR.
Second, we can create tokens, such as "Understand "blonde hair" or "hair" as "[hair]", and then use these tokens in match phrases. This saves a good deal of time when we want to specify a number of different but fussy alternatives. So, for instance, here is a drawing that would not respond to >X OF, or >X BROWN EYES, but would respond to >X DRAWING OF MAN WITH BROWN EYES, >X MAN WITH BROWN EYES, and so on:
Test me with "test one / test two".
>(Testing.)
>[1] test one
(Testing.)
>[2] x photograph
You see nothing special about the incriminating photograph of a woman with blonde hair.
>[3] x incriminating photograph of a woman with blonde hair
You see nothing special about the incriminating photograph of a woman with blonde hair.
>[4] x hair
You see nothing special about the incriminating photograph of a woman with blonde hair.
>[5] x blonde
You see nothing special about the incriminating photograph of a woman with blonde hair.
>[6] x woman with blonde hair
You see nothing special about the incriminating photograph of a woman with blonde hair.
>[7] x incriminating photograph of a woman
You see nothing special about the incriminating photograph of a woman with blonde hair.
>[8] test two
(Testing.)
>[9] x drawing
You see nothing special about the drawing of a man with brown eyes.
>[10] x man
You see nothing special about the drawing of a man with brown eyes.
>[11] x of
You see nothing special about the incriminating photograph of a woman with blonde hair.
>[12] x drawing of man
You see nothing special about the drawing of a man with brown eyes.
>[13] x drawing of a man
You see nothing special about the drawing of a man with brown eyes.
>[14] x drawing of a man with brown eyes
You see nothing special about the drawing of a man with brown eyes.
>[15] x drawing of a brown-eyed man
You see nothing special about the drawing of a man with brown eyes.
>[16] x brown eyes
You can't see any such thing.
Further refinements are possible: the "privately-named" attribute tells Inform not to try to understand the source name of an object at all, so if we write
…the player will not be able to refer to it as "purple" or "rabbit" or "purple rabbit".
There are also ways to make names to refer to entire kinds of objects (so "dude" will refer to any man in the game); to specify names that only refer to objects in the plural (so GET PICTURES will pick up several pictures together); to reflect an object's properties (so "red apple" works only as long as the apple is in fact red); or even to refer to the object's relationships to other objects (so "bottle of wine" works only when wine is indeed in the bottle). All these refinements are discussed in the chapter on Understanding.