Also add a preliminary tiles documentation with 'T' as a hotkey, re-add the readme on '!' after moving options_guide.txt to '&'.
And now that the tutorial also allows inscriptions from viewing items, add an explanatory text for inscriptions.
git-svn-id: https://crawl-ref.svn.sourceforge.net/svnroot/crawl-ref/trunk@3952 c06c8d41-db1a-0410-9941-cceddc491573
MCBXXIV6GICTZB56APSXMJEI63FVQWVZR3H2DRNMMFDH2XCGK4JAC
O4IQ4YKZYB7K4WYVBGPRF43XFE54SJWCUPD7ERYTED22PDNCNUIAC
LS5XCCGKQHSJQGWLWLGTP2F5OYWK4ND5AQQAGRN6H2HVBSXNCCZAC
BFCFMN2BXNLXJCYYCL2V2XTDQQNM3PJPSRB6CU76FM3332NC7GMAC
Z6XF4AIERIW4U4AR3HU2ILYFZ54IK4K4ORQ6JKCEWRO5LZODWDDAC
77H4BWWPPGLM3PLZH4QTAJRXIZTSDVNCOKZE223I437FN2UJ34RQC
7NDXS36TE7QVXTXJWMYSVG5UHCCLPIO4VL6NXFGTDK3ZNKE3A2IAC
7HA2754QW3SBCAJ5K6KUXNXXXIZB5BIBCFPLXADCXHH6EREKXHSAC
Q4YYTFXYZUDBYWT37U354CJOAQMAAIWM5W72TAEGMEUKZIUZBMGAC
U3KGUJJQWQORJIIFH3ADVNIEEX5HOX6KEOXO7DJSL7L3Z6GG3PAQC
ESWIM76FGJL4QFLSHU6AC4D74PT7OPLQ7ZCJYWLZS5UCBAJDXYHAC
GL6SGPBZQPJBVGPOASYVCTAFXS7RNARR6Y5WZMIO5YCTB7ZJY4KAC
7K5P2GRF6QUXTMERG2R3BB6DZFQYJQ6V2KNPMBPFDLOP36NQILPAC
K2CS6TCX2NDVL2ASEHGP4J4K4IJ6FP3ANNKTSIWVG43HPYSBX6ZQC
IXVKL2SINZN4DMJSZSYFVK5YLGSBGV4KCN7GKYQL7SZQDCM3S7YQC
KPU2SA6G7UECM5N6PNXOT5CCQAYFBN47K5JYBQMFBD25HL2A5GIAC
76MT5JQZVCEU6FXMOE7ACRT4J2XGP3OMF3KGGZ4BR5F4WRKCJDRQC
NXVPOFYKJFWQWKVPQUMWH2Y2KJEZX44BUOBFJ4JD4KFGPEGYHG4QC
65CM2EZCAFFBWLAYZ7ALBV3BQKNZCYOHYIFY46KU7BZL3LHV36JAC
S32TDWCH5D5MVJTHTYQTRAU5GR4AMMVHCICEPFIHAE5BA5ZUKKTAC
ZIFFVCQ72K35WGIUMZYN3KOXIUXF2CNXWKG6ZWEZ6LT3NSF3XOQAC
7U7IZUR2C7UALYI4Y3SHBYGTHYVQM6JI4PXDFXUFL3T3L6JBSC6AC
IBONFFRJOJEKWUXXYITSPMEINMJB5AJ5Z7HHYUAC4HG7CLTRRNJQC
QUFPPRIIRXHUFEDH3EFES7CSHTA7GG2DAXTRHUAUQBYMSWK4BP6AC
RVST2QHYJ757ZHK4AUJ5NGPDZ44AD6RVFVXYPKQIBJXZBDNUCHXQC
WL5WZXFJ6TONUQRSHUY4GQ5USU47ILWNN5X2JDQZO4CRJJZSRQIAC
V6REAY6RCAG2QQ4BO54GHYOVTNCYHTLERJCIZJPSANXFBINZOTXAC
4VK7VHWRVRO66BRSGTBPSYJGGXLRF6AG6G74UDTPHTPXR7ZRNINQC
EHSY6DVGUMI6C67WKET3GDJVLWJWGYBYQONNDK5JVT7BCTHBEZVAC
UL7XFKMUX3WIU4O2LZANK4ECJ654UZPDBFGNXUEYZYOLKBYBCG6AC
FYD4A5TIETIV2ZLFYWGHXANU6WQFKMVREHM7OZY2TAXSBMMCDLJAC
G7CTMQ3VNTAB73ZI3LNZHKTAJ5LEQEGG772MVFQQ5XXLCMJVORTQC
AIIVH43Z5X3GTPFY4FXQRZPG6Y7QPH2KJ47VM2Q43PCGGD5MTMOAC
#ifdef USE_TILE
text << " With tiles, you can also chop up any corpse that shows in "
"the floor part of your inventory region, simply by doing a "
"<w>left mouse click</w> while pressing <w>Shift</w>, and "
"then eat the resulting chunks with <w>Shift + right mouse "
"click</w>.";
#endif
"you might just as well <w>d</w>rop this.";
"you might just as well <w>d</w>rop this. No god will "
"accept such rotten sacrifice, either.";
}
#ifdef USE_TILE
else
{
ostr << " For an individual corpse in your inventory, the most "
"practical way to chop it up is to drop it by clicking "
"on it with your <w>left mouse button</w> while "
"<w>Shift</w> is pressed, and then repeat that command "
"for the corpse tile now lying on the floor. If the "
"intent is to eat the chunks (rather than offer the "
"corpse), you can then press <w>Shift + right mouse "
"button</w> to do that.\n"
EOL
"If there are several items in your inventory you'd "
"like to drop, the more convenient way is to use the "
"<w>d</w>rop menu. On a related note, offering several "
"corpses on a floor square is facilitated by using the "
"<w>c</w>hop prompt where <w>c</w> is a valid synonym "
"for <w>y</w>es.";
void tutorial_inscription_info(bool autoinscribe)
{
std::ostringstream text;
text << "<" << colour_to_str(channel_to_colour(MSGCH_TUTORIAL)) << ">";
if (!autoinscribe || wherey() <= get_number_of_lines() - 10)
{
text << EOL
"Inscriptions are a powerful concept of Dungeon Crawl." EOL
"You can inscribe items to differentiate them, or to comment on them, " EOL
"but also to set rules for item interaction. If you are new to Crawl, " EOL
"you can safely ignore this feature, though." EOL;
}
if (autoinscribe && wherey() <= get_number_of_lines() - 6)
{
text << EOL EOL
"Artefacts can be autoinscribed to give a brief overview of their " EOL
"known properties. Here, doing a <w>left mouse click</w> will autoinscribe " EOL
"this item." EOL;
}
text << "(In the main screen, press <w>?6</w> for more information.)" EOL;
text << "</" << colour_to_str(channel_to_colour(MSGCH_TUTORIAL)) << ">";
formatted_string::parse_string(text.str()).display();
}
* the_manual.txt The complete manual; describing all aspects in the
detail. Contains appendices on species, classes, etc.
* options.txt Describes all options in detail. The structure of
init.txt follows this text.
* macros.txt A how-to on using macros and keymappings, with examples.
* aptitudes.txt Some numbers defining certain aspects of the races.
Helpful, but not needed for winning.
* quickstart.txt A short introduction for new players.
* ssh_guide.txt An elaborate introduction on how to get internet play
to work. For Windows only.
* irc_guide.txt An elaborate introduction on how to access the IRC
channel ##crawl.
* keys.pdf A printable document, listing all commands and it also
contains a very short guide for new players.
* crawl_manual.txt The complete manual; describing all aspects in the
detail. Contains appendices on species, classes, etc.
* options_guide.txt Describes all options in detail. The structure of
init.txt follows this text.
* macros_guide.txt A how-to on using macros and keymappings, with examples.
* aptitudes.txt Some numbers defining certain aspects of the races.
Helpful, but not needed for winning.
* quickstart.txt A short introduction for new players.
* ssh_guide.txt An elaborate introduction on how to get internet play
to work. For Windows only.
* irc_guide.txt An elaborate introduction on how to access the IRC
channel ##crawl.
* keys.pdf A printable document, listing all commands and it also
contains a very short guide for new players.
Tiles mouseclick item interaction
If you're playing with Tiles compiled, you'll find several shortcuts to
regular commands using mouseclicks.
PLAYER AVATAR
left mouseclick Pick up items on ground ('g' command).
A second click will take you to the pickup menu.
right mouseclick Character overview ('%' command).
Shift + left mouseclick Take stairs ('<' and '>' commands).
Shift + right mouseclick View religion information ('^' command).
INVENTORY MANAGEMENT
left mouseclick Execute the most common action for this item type.
weapons: wield ('w')
misc. items: wield ('w')
armour: Wear ('W')
food: eat ('e')
scroll, manual: read ('r')
potion: quaff ('q')
jewellery: Put on ('P')
spellbook: Memorise ('M')
missiles: fire ('f')
corpse: eat ('e'), for Vampires
wielded items:
rod: evoke ('v')
misc. item: evoke ('v')
weapon, staff: unwield ('w-')
armour: Take off ('T')
jewellery: Remove ('R')
others, as non-wielded
Sometimes alternative denominators are used such as "draw a card"
instead of evoke for decks of cards, or "drink blood" instead of eat.
right mouseclick Display item information ('i' + item slot).
Shift + left mouseclick Drop item ('d').
Shift + right mouseclick Execute secondary action for some item types.
weapons: fire ('f')
wielded items:
rod: unwield ('w-')
misc. item: unwield ('w-')
others, as non-wielded, or nothing
FLOOR ITEM INTERACTION
left mouseclick Pick up this item ('g').
right mouseclick Display item information.
Shift + left mouseclick 'c'hop up this corpse.
Shift + right mouseclick 'e'at this food item.
MAP INTERACTION
left mouseclick Move there, if empty, or swap places with an ally.
Attack, if adjacent non-friendly monster.
right mouseclick Display grid information (view).
Ctrl + left mouseclick Disarm adjacent trap ('Ctrl + Dir.')
Open ('O')/Close ('C') adjacent door.
MINIMAP INTERACTION
left mouseclick Autotravel to any reachable position.
holding right mouseclick Zoom into distant area.
MESSAGE AREA
any mouseclick Display message history ('Ctrl-P').
STAT AREA
any mouseclick Search / Rest for a while ('5')
MENU INTERACTION
left mouseclick Scroll to next page.
right mouseclick Escape (quit menu).
Note that, in the tutorial, some of your options settings may get
overwritten to facilitate the explanations. This concerns the
following options, and their enforced setting for tutorial games
are as follows:
delay_message_clear = false
auto_list = true
weapon = hand axe, for Berserkers
book = random, for Conjurers
and, for Tiles,
tile_show_items = !?/%=([)x}+\_.