#
# ===== How to use auto-picker/destroyer ========
#
-# Create a file named "pickpref.prf" or "pickpref-<<name>>.prf"
-# (or move and rename this file) in the same directory as your
-# user preference files. This will be ~/.angband/Hengband/
-# for UNIX, or hengband\lib\user\ for other operating systems.
-#
-# The game will read the file "pickpref-<<current character
-# name>>.prf" first and then read the file "pickpref.prf". The
-# first-read file takes priority.
-#
-# You may use the '$' command within the game to reread auto-
-# picker files.
+# Press the _ in a game to enter editor mode for preference of
+# auto-picker/destroyer. Basic usage of the editor is almost same
+# as vi, and also have emacs like commands. Most commands is
+# always displayed on the first line and the right half of the
+# screen.
+#
+# Important commands
+# 'a', 'i' or ^Q : Enter insert mode from command mode
+# ESC or ^Q : Return to command mode from insert mode
+# 'q' : Quit the editor (command mode only)
+# 'hjkl2468' : Move cursor (command mode only)
+# ^B ^N ^P ^F : Move cursor (always)
+# ^I : Choose an item from inventry/equipment, then insert its name
+# ^S : Rotates action (pick up / destroy / leave on floor)
+# ^U : Rotates idendify state (identified / unidentified / ...)
+# ^L : Insert name of the last auto-destroyed item.
+# '/' : Search string, or search an item specified by ^I or ^L.
+# 'n' : Search next
+# 'N' : Search previous
+#
+# The preference will be saved in a file named
+# "pickpref-<<name>>.prf" in your user directory; This will be
+# ~/.angband/Hengband/ for UNIX, or hengband\lib\user\ for other
+# operating systems. You may edit this file using any text
+# editor, and may use the '$' command within the game to reread
+# this file. When you don't use the in-game editor, you may use
+# "pickpref.prf" as preference file.
+#
+# When there are both files, the game will read the file
+# "pickpref-<<current character name>>.prf" first and then read
+# the file "pickpref.prf". The first-read file takes priority.
#
# Notes:
# Maximum number of active lines is 1009.
# ---------
#
# Command letter:
-# Each line determines the actions taken when you step over a kind
-# of object. Starting a line with '!' indicates that you wish to destroy
-# this kind of object. Starting a line with '~' indicates that you wish
-# to leave this kind of object on the floor. Otherwise, your character
-# will automatically attempt to pick up the object.
+# Each line determines the actions taken when you step over
+# a kind of object. Starting a line with '!' indicates that you
+# wish to destroy this kind of object. Starting a line with '~'
+# indicates that you wish to leave this kind of object on the
+# floor. Starting a line with ';' indicates that you wish to
+# force the game to ask you if you want to pick the item up or
+# not. Otherwise, your character will automatically attempt to
+# pick up the object.
# There is an additional command letter '('. It indicates that
# you don't wish this item to be displayed in full map. see below.
#
#
# all : All items match.
# collecting : Matches if you already have that same item.
+# unaware : Items with unknown effects match.
# unidentified : Unidentified items match.
# identified : Identified items match.
# *identified* : *Identified* items match.
-# nameless : Non ego/non artifact items match.
-# unaware : Items with unknown effects match.
-# worthless : Items which you cannot sell match.
# dice boosted : Weapons with boosted damage dice match.
-# more than nn dice : Weapons with dice (dd * ds) better than nn match.
+# more than N dice : Weapons with dice (dd * ds) better than +N match.
+# more bonus than N : Items which has more magical bonus than (+N) match.
+# worthless : Items which you cannot sell match.
+# artifacts : Artifacts items match.
+# ego : Ego items match.
+# nameless : Non ego/non artifact items match.
# wanted : Wanted monster's corpses or skeletons match.
# unique monster's : Unique monster's corpses, skeletons or statues match.
# human : Human corpses or skeletons match.
#
# items : All items match. Use it with an adjective for
# readability (i.e. "unaware items").
-# artifacts : All artifacts match.
# weapons : All weapons including missile weapons match.
# armors : All armors match.
# missiles : Arrows, bolts, and shots match.
-# magical devices : Wands, staffs and rods match.
+# magical devices : Wands, staffs, rods and scrolls match.
# lights : Light sources match.
# junks : Junk items like Shard of Pottery or etc. match.
# spellbooks : All books match.
#
# Strict syntax of each line is below.
#
-# [[all] [collecting] [unidentified] [identified] [*identified*]
-# [nameless] [unaware] [worthless] [dice boosted] [more than nn dice]
+# [! ~ ; (]
+# [[all] [collecting]
+# [unaware] [unidentified] [identified] [*identified*]
+# [dice boosted] [more than N dice] [more bonus than N]
+# [worthless] [artifact] [ego] [nameless]
# [wanted] [unique monster's] [human] [unreadable]
# [first realm's] [second realm's] [first] [second] [third] [fourth]
-# [items | artifacts | weapons | armors | missiles | magical devices |
+# [items | weapons | armors | missiles | magical devices |
# lights | junks | spellbooks | hafted weapons | shields | bows |
# rings | amulets | suits | cloaks | helms | gloves | boots] :]
# [[^]part-of-item-name] [#auto-inscription-string]
# Returns player name.
# $REALM1
# Returns player's first magic realm
-# Life, Sorcery, Nature, Chaos, Death, Trump Arcane, Craft,
-# Daemon, Music, Kendo
+# none, Life, Sorcery, Nature, Chaos, Death, Trump, Arcane,
+# Craft, Daemon, Crusade, Music, Kendo
# $REALM2
# Returns player's second magic realm
# $LEVEL
#Artifact lights
unidentified lights:^Jewel#!!
-unidentified lights:^levitatioin stone#!!
+unidentified lights:^levitation stone#!!
unidentified lights:^Palantir#!!
unidentified lights:^stone#@A0
unidentified lights:^star#!!
unidentified lights:^Incandescent Light
unidentified lights:^Phial#!!
-# auto inscribe resistances...
-~*identified* artifacts#%
+# auto inscribe resistances (see lib/help/objects.txt#Inscriptions)
+~*identified* artifacts#%all
#
-# pick all items which can stack your inventry without inscription.
+# pick all items which can stack your inventory without inscription.
#
collecting rod
collecting potion