OSDN Git Service

EQU演算子の説明の修正.
[hengband/hengband.git] / lib / help / editor.txt
index 84a94c9..c349f2b 100644 (file)
-=== Auto-Picker/Destroyer Editor ===
-
-The "auto-picker/destroyer editor" is a special text editor to write
-preferences for auto-picker/destroyer.
+[[[[G|=== Auto-Picker/Destroyer Editor ===
+
+Please choose one of the following online help files:
+
+    (a) The Basics of Auto-picker Editor      (#Editor)            
+    (b) Cur and Paste                         (#CutAndPaste)       
+    (c) Register to Auto-picker               (#RegisterName)      
+    (d) Insert Name from your Inventory       (#InsertObjectName)  
+    (e) Insert Fixed Keyword                  (#InsertKeyword)     
+    (f) Change Multiple Lines at Once         (#MultiLines)        
+    (g) Conditionals                          (#Conditionals)      
+    (h) Auto Register an Item without Editor  (#AutoRegister)      
+
+    (i) Format of Auto-picker/destroyer       (#AutopickFormat)      
+    (j) Format of Conditionals                (#ConditionFormat)     
+    (k) Sample Preference File                (lib/pref/pickpref.prf)
+
+***** [a] editor.txt#Editor
+***** [b] editor.txt#CutAndPaste
+***** [c] editor.txt#RegisterName
+***** [d] editor.txt#InsertObjectName
+***** [e] editor.txt#InsertKeyword
+***** [f] editor.txt#MultiLines
+***** [g] editor.txt#Conditionals
+***** [h] editor.txt#AutoRegister
+***** [i] editor.txt#AutopickFormat
+***** [j] editor.txt#ConditionFormat
+***** [k] ../pref/pickpref.prf
+
+***** <Editor>
+[[[[G|--- The Basics of Auto-picker Editor ---
+
+The "auto-picker editor" is a special text editor to write preferences
+for auto-picker/destroyer.
 
 To open the editor, you can press the _ key in the game or choose
 "(P) Auto-picker/destroyer editor" in the options panel (=).
 
-Press ^Q to quit the editor.  All changes will be saved automatically.
+Like normal text editor, you can move the cursor by Left, Right, Up,
+Down arrow keys, and Home, End, PageUp, and PageDown keys.  And any
+letter keys pressed are written as a text.
+
+Press ^W to finish the edito.  All changes will be saved automatically.
+Or press ^Q to quit and discard all changes.
 
 Press ESC to open a command menu.
-+----------------------------+
-| a) Save & Quit          ^Q |
-| b) Revert all changes   ^Z |
-| c) Help                    |
-| d) Move cursor           > |
-| e) Edit                  > |
-| f) Search                > |
-| g) Insert...             > |
-| h) Command letter        > |
-| i) Identify states       > |
-| j) Keywords (noun)       > |
-| k) Keywords (adjective)  > |
-+----------------------------+
-Press a-k to choose a command or open a sub-menu.  Also you can press
++---------------------------+
+| a) Help                   |
+| b) Quit without save   ^Q |
+| c) Save & Quit         ^W |
+| d) Revert all changes  ^Z |
+| e) Edit                 > |
+| f) Search               > |
+| g) Move cursor          > |
+| h) Insert...            > |
+| i) Adjective (general)  > |
+| j) Adjective (special)  > |
+| k) Keywords (noun)      > |
+| l) Command letter       > |
++---------------------------+
+Press a-l to choose a command or open a sub-menu.  Also you can press
 ^Q, ^Z, etc. to use commands without opening this menu.
 
 
-***** <Autopick>
-==== Object Auto-picker/Destroyer ====
+***** <CutAndPaste>
+[[[[G|--- Cur and Paste
+
+Cut and Paste are useful when you want to write many similer lines, or
+want to swap lines.
+Open submenu "e) Edit >",
++-------------------------+
+| a) Cut               ^X |
+| b) Copy              ^C |
+| c) Paste             ^V |
+| d) Select block      ^G |
+| e) Kill rest of line ^K |
+| f) Delete character  ^D |
+| g) Backspace         ^H |
+| h) Return            ^J |
+| i) Return            ^M |
++-------------------------+
+
+You can select a segment of the text using shift key + arrow keys.
+Selected text will be displayed in yellow.  You can press ^X to cut
+the selected text, or press ^C to copy the selected text to the
+clipboard.  Contents of the clipboard will be pasted on pressing ^V.
+
+Note that it's possible that Hengband cannot recognize shift+arrow
+keys on a minor environment.  In that case, you can press ^G and then
+move cursor to select text.
+
+
+***** <RegisterName>
+[[[[G|--- Register to Auto-picker ---
+
+***** <InsertObjectName>
+[[[[G|--- Insert Name from your Inventory ---
+
+***** <InsertKeyword>
+[[[[G|--- Insert Fixed Keyword ---
+
+***** <MultiLines>
+[[[[G|--- Change Multiple Lines at Once ---
+
+***** <Conditionals>
+[[[[G|--- Conditionals ---
+
+***** <AutoRegister>
+[[[[G|--- Auto Register an Item without Editor ---
+
+***** <AutopickFormat>
+[[[[G|--- Format of Auto-picker/destroyer ---
 
 Hengband can automatically pick up or destroy specified objects when
 you write objects name in the file "pickpref.prf" or
@@ -80,7 +162,11 @@ Keywords:
   worthless         : Items which you cannot sell match.
   artifact          : Artifacts items match.
   ego               : Ego items match.
+  good              : {good} items match.
   nameless          : Non ego/non artifact items match.
+  average           : {average} items match.
+  rare              : Rare equipment such as Dragon armors etc. match.
+  common            : Any equipments except 'rare' equipment 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.
@@ -100,6 +186,7 @@ Keywords:
   magical devices   : Wands, staffs, rods and scrolls match.
   lights            : Light sources match.
   junks             : Junk items like Shard of Pottery or etc. match.
+  corpses or skeletons : Corpses or skeletons of monsters match.
   spellbooks        : All books match.
   favorite weapons  : Weapons suitable for your class (for Priest, Monk,
                       BeastMaster, ForceTrainer, Cavalry, and Ninja)
@@ -176,17 +263,20 @@ Special Notes:
   [! ~ ; (]
   [[all] [collecting]
    [unaware] [unidentified] [identified] [*identified*] 
+   [artifact] [ego] [good] [nameless] [average]
+   [worthless] [rare] [common]
    [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 | weapons | armors | missiles | magical devices | 
-    lights | junks | spellbooks | hafted weapons | shields | bows | 
-    rings | amulets | suits | cloaks | helms | gloves | boots] :]
+   [items | weapons | favorite weapons | armors | missiles |
+    magical devices | lights | junks | corpses or skeletons | spellbooks |
+    hafted weapons | shields | bows | rings | amulets | suits | cloaks |
+    helms | gloves | boots] :]
   [[^]part-of-item-name] [#auto-inscription-string]
 
 
-=======  How to use Conditional Expressions  ========
+***** <ConditionFormat>
+[[[[G|--- Format of Conditionals ---
 
   The lines of pickpref.prf can be disabled/enabled using 
   conditional expressions. 
@@ -202,11 +292,10 @@ Special Notes:
     %:filename
       Read a file named 'filename' as a new pick-pref file. The file 
       must be in the user directory.
-      Caution: Avoid naming the parent file, or the game might freeze up.
 
   - usage of operators
     [EQU arg1 arg2 ...]
-      If all args are same, returns "1", or else returns "0".
+      If all args are the same as arg1, returns "1", or else returns "0".
     [IOR arg1 arg2 ...]
     [AND arg1 arg2 ...]
       IOR evaluates and returns all args' logical OR. IAND is logical AND.
@@ -247,193 +336,3 @@ Special Notes:
     $LEVEL
      Returns player level as two-character string.
       Ex. "01","09","10","50" etc.
-
-###############################################################
-###############################################################
----------------------------------------------------------------
-
- There is an example 'pickpref.prf' file below.
- You can copy this file to lib\user\ or ~/.angband/Hengband/.
- (UNIX user must copy to ~/.angband/Hengband/. Others must copy 
- to  lib\user\ .)
-
----------------------------------------------------------------
-###############################################################
-###############################################################
-
-wanted corpse
-wanted Skeleton
-
-# Berserker cannot use magical devices; rods, wands, and scrolls.
-?:[EQU $CLASS Berserker]
-!magical devices
-?:1
-
-unaware items
-
-#Artifact lights
-unidentified lights:^Jewel#!!
-unidentified lights:^levitation stone#!!
-unidentified lights:^Palantir#!!
-unidentified lights:^stone#@A0
-unidentified lights:^star#!!
-unidentified lights:^Incandescent Light
-unidentified lights:^Phial#!!
-
-# auto inscribe resistances (see lib/help/objects.txt#Inscriptions)
-~*identified* artifacts#%all
-
-#
-# pick all items which can stack your inventory without inscription.
-#
-collecting rod
-collecting potion
-collecting scroll
-collecting missiles
-(collecting items
-
-#
-# good items
-#
-~rod of Perception#@z0!k!!
-~rod of speed#!k!!
-~rod of Healing#!k!!
-~rod of Enlightenment#k!!
-~rod of Detection#!k!!
-
-potion of Invulnerability#!k
-Acquirement#!k
-potion of Experience
-potion of Augmentation
-*Destruction*
-Genocide
-
-potion of strength
-potion of wisdom
-potion of dexterity
-potion of constitution
-potion of intelligence
-potion of Charisma
-
-potion of life#!k
-healing#!k
-
-#
-# Magic-Eaters pick up all magical device to absorb.
-# Skeletons is material of missiles for Archers.
-# Ninja needs lights of darkness.
-# Vampire needs darkness.
-# 
-?:[EQU $CLASS Magic-Eater]
-rod of 
-staff of 
-wand of 
-?:[EQU $CLASS Archer]
-skeleton of 
-?:[EQU $CLASS Ninja]
-~lights:darkness
-Iron Spike#@v0
-?:[EQU $RACE Vampire]
-(~scroll of darkness
-(~staff of darkness
-?:1
-
-# Destroy unless very early stage.
-?:[GEQ $LEVEL 10]
-(!amulet of Adornment
-(!potion of Apple Juice
-(!Empty Bottle
-(!potion of water
-?:1
-
-# These worthless potions have some use at very early stage.
-# Command letter '(' means, 'Don't display its location in full map command.'
-?:[LEQ $LEVEL 20]
-(~potion of booze
-(~potion of Slowness
-(~potion of Sleep
-?:1
-
-# complex example; destroy needless food items.
-?:[AND [GEQ $LEVEL 20] [IOR [EQU $REALM1 Life] [EQU $REALM2 Life] [EQU $REALM1 Nature] [EQU $REALM2 Nature] [EQU $REALM1 Craft] [EQU $REALM2 Craft]]]
-(!Satisfy Hunger
-(!food
-(!Slime Mold
-(!of Elvish Waybread
-?:1
-
-
-#
-# Destroy useless equipment at high level.
-#
-# Beware!!!!
-#    The line '!nameless armors' destroy all dragon armour!
-#    '~identified armors:dragon' will prevent this dangerous behavior.
-#
-
-?:[GEQ $LEVEL 40]
-~identified armors:dragon
-~nameless armors:Elven Cloak
-~nameless armors:Shadow Cloak
-~nameless weapons:Diamond Edge
-~nameless weapons:Mace of Disruption
-~nameless weapons:Shield of Deflection
-!nameless weapons
-!nameless armors
-
-?:[GEQ $LEVEL 20]
-!nameless weapons:) (+0,+0)
-!nameless armors:,+0]
-?:1
-
-# higher rank of your spellbooks
-first realm's fourth Book of Kendo#!k
-first realm's third Book of Kendo#!k
-first realm's fourth spellbooks#@md!k
-first realm's third spellbooks#@mc!k
-second realm's fourth spellbooks#@mh!k
-second realm's third spellbooks#@mg!k
-
-# unidentified equipment
-unidentified dice boosted weapons
-unidentified more than 25 dice weapons
-unidentified weapons
-unidentified armors
-~unidentified missiles
-
-# lower rank of your spellbooks
-collecting spellbooks
-~first realm's second spellbooks#@mb!k
-~first realm's first spellbooks#@ma!k
-~second realm's second spellbooks#@mf!k
-~second realm's first spellbooks#@me!k
-
-# other spellbooks
-
-?:[GEQ $LEVEL 30]
-(!unreadable first spellbooks
-(!unreadable second spellbooks
-(!unreadable third spellbooks:arcane
-(!unreadable fourth spellbooks:arcane
-?:1
-
-# pick up for experience
-?:[IOR [EQU $CLASS Warrior] [EQU $CLASS Berserker] [AND [EQU $CLASS Paladin] [EQU $REALM1 Life]]]
-(~unreadable third spellbooks:arcane
-(~unreadable fourth spellbooks:arcane
-unreadable fourth spellbooks
-unreadable third spellbooks
-?:1
-?:[AND [EQU $CLASS Paladin] [EQU $REALM1 Death]]
-unreadable fourth spellbooks:life
-unreadable third spellbooks:life
-?:1
-
-# pick up for money
-?:[LEQ $LEVEL 29]
-(~unreadable third spellbooks:arcane
-(~unreadable fourth spellbooks:arcane
-unreadable fourth spellbooks
-unreadable third spellbooks
-?:1
-