dict.1 (4412B)
1 .TH DICT 1 2 .SH NAME 3 dict, adict \- dictionary browser 4 .SH SYNOPSIS 5 .B dict 6 [ 7 .B -k 8 ] 9 [ 10 .B -d 11 .I dictname 12 ] 13 [ 14 .B -c 15 .I command 16 ] 17 [ 18 .I pattern 19 ] 20 .B adict 21 [ 22 .B -d 23 .I dictname 24 ] 25 [ 26 .I pattern 27 ] 28 .SH DESCRIPTION 29 .I Dict 30 is a dictionary browser. 31 If a 32 .I pattern 33 is given on the command line, 34 .I dict 35 prints all matching entries; 36 otherwise it repeatedly accepts and executes commands. 37 The options are 38 .TF -d\ \fIdictname\fP 39 .TP 40 .BI -d " dictname" 41 Use the given dictionary. 42 A list of available dictionaries is printed by option 43 .BR -d? . 44 The default is the first dictionary on the list that is 45 installed on the system. 46 .TP 47 .BI -c " command" 48 Execute one command and quit. 49 The command syntax is described below. 50 .TP 51 .B -k 52 Print a pronunciation key. 53 .PD 54 .PP 55 Patterns are regular expressions (see 56 .MR regexp (7) ), 57 with an implicit leading 58 .L ^ 59 and trailing 60 .LR $ . 61 Patterns are matched against an index of headwords and variants, 62 to form a `match set'. 63 By default, both patterns and the index are folded: 64 upper case characters are mapped into their lower case equivalents, 65 and Latin accented characters are mapped into their non-accented 66 equivalents. 67 In interactive mode, there is always a `current match set' 68 and a `current entry' within the match set. 69 Commands can change either or both, as well as print the entries 70 or information about them. 71 .PP 72 Commands have an address followed by a command letter. 73 Addresses have the form: 74 .TF /\fIre\fP/.\fIn\fP 75 .TP 76 .BI / re / 77 Set the match set to all entries matching the regular expression 78 .IR re , 79 sorted in dictionary order. 80 Set the current entry to the first of the match set. 81 .TP 82 .BI ! re ! 83 Like 84 .BI / re / 85 but use exact matching, i.e., without case and accent folding. 86 .TP 87 .I n 88 An integer 89 .I n 90 means change the current entry to the 91 .IR n th 92 of the current match set. 93 .TP 94 .BI # n 95 The integer 96 .I n 97 is an absolute byte offset into the raw dictionary. 98 (See the 99 .B A 100 command, below.) 101 .TP 102 .IB addr + 103 After setting the match set and current entry according to 104 .IR addr , 105 change the match set and current entry to be the next entry 106 in the dictionary (not necessarily in the match set) after 107 the current entry. 108 .TP 109 .IB addr - 110 Like 111 .IB addr + 112 but go to previous dictionary entry. 113 .PD 114 .PP 115 The command letters come in pairs: a lower case and the 116 corresponding upper case letter. 117 The lower case version prints something about the current 118 entry only, and advances the current entry to the next 119 in the match set (wrapping around to the beginning after 120 the last). 121 The upper case version prints something about all of the 122 match set and resets the current entry to the beginning of 123 the set. 124 .TF \fLa,A\fP 125 .TP 126 .BR p , P 127 Print the whole entry. 128 .TP 129 .BR h , H 130 Print only the headword(s) of the entry. 131 .TP 132 .BR a , A 133 Print the dictionary byte offset of the entry. 134 .TP 135 .BR r , R 136 Print the whole entry in raw format (without translating 137 special characters, etc.). 138 .PD 139 .PP 140 If no command letter is given for the first command, 141 .B H 142 is assumed. 143 After an 144 .BR H , 145 the default command is 146 .BR p . 147 Otherwise, the default command is the previous command. 148 .PP 149 .I Dict 150 searches for dictionaries in the directory named by 151 .B $dictpath 152 (default 153 .BR \*9/dict ). 154 .PP 155 .I Adict 156 is a dictionary browser for 157 .MR acme (1) . 158 When run with no arguments, it creates a new 159 .I acme 160 window named 161 .B /adict/ 162 listing the installed dictionaries. 163 Clicking with button 3 on a dictionary name will create 164 a new empty window named 165 .BI /adict/ dict /. 166 Typing and then clicking on a pattern in this window will 167 create a new lookup window named 168 .BI /adict/ dict / pattern 169 containing the dictionary's definition of 170 .IR pattern . 171 Clicking with button 3 on any word in this new window will 172 create new lookup windows. 173 .PP 174 If 175 .I adict 176 is run with a 177 .I pattern , 178 it starts with the 179 .BI /adict/ dict / pattern 180 window. 181 .PP 182 If 183 .I adict 184 is run with no pattern but with a 185 .B -d 186 option, 187 it starts with the 188 .BI /adict/ dict / 189 window. 190 .SH FILES 191 .TP 192 .B \*9/dict 193 dictionaries 194 .PD 195 .SH "SEE ALSO" 196 .MR regexp (7) 197 .SH SOURCE 198 .B \*9/src/cmd/dict 199 .br 200 .B \*9/bin/adict 201 .SH BUGS 202 A font with wide coverage of the Unicode Standard 203 should be used for best results. 204 (Try 205 .BR \*9/font/pelm/unicode.9.font .) 206 .PP 207 If the 208 .I pattern 209 doesn't begin with 210 a few literal characters, matching takes a long time. 211 .PP 212 The dictionaries are not distributed outside Bell Labs, 213 though see 214 .B \*9/dict/README 215 for information on using free dictionaries prepared 216 by Project Gutenberg.