1 #
2 # Copyright (c) 2016, Oracle and/or its affiliates. All rights reserved.
3 # DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 #
5 # This code is free software; you can redistribute it and/or modify it
6 # under the terms of the GNU General Public License version 2 only, as
7 # published by the Free Software Foundation. Oracle designates this
8 # particular file as subject to the "Classpath" exception as provided
9 # by Oracle in the LICENSE file that accompanied this code.
10 #
11 # This code is distributed in the hope that it will be useful, but WITHOUT
12 # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 # FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 # version 2 for more details (a copy is included in the LICENSE file that
15 # accompanied this code).
16 #
17 # You should have received a copy of the GNU General Public License version
18 # 2 along with this work; if not, write to the Free Software Foundation,
19 # Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 #
21 # Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 # or visit www.oracle.com if you need additional information or have any
23 # questions.
24 #
25
26 jshell.msg.welcome =\
27 Welcome to JShell -- Version {0}\n\
28 For an introduction type: /help intro\n
29 jshell.err.opt.classpath.conflict = Conflicting -classpath option.
30 jshell.err.opt.classpath.arg = Argument to -classpath missing.
31 jshell.err.opt.feedback.arg = Argument to -feedback missing. Mode required.
32 jshell.err.opt.startup.one = Only one -startup or -nostartup option may be used.
33 jshell.err.opt.unknown = Unknown option: {0}
34
35 jshell.msg.terminated =\
36 State engine terminated.\n\
37 Restore definitions with: /reload -restore
38
39 jshell.msg.use.one.of = Use one of: {0}
40 jshell.msg.see.classes.etc = See /types, /methods, /vars, or /list
41 jshell.err.arg = Invalid ''{0}'' argument: {1}
42 jshell.msg.see = See {0} for help.
43
44 jshell.err.file.not.accessible = File ''{1}'' for ''{0}'' is not accessible: {2}
45 jshell.err.file.not.found = File ''{1}'' for ''{0}'' is not found.
46 jshell.err.file.exception = File ''{1}'' for ''{0}'' threw exception: {2}
47 jshell.err.file.filename = ''{0}'' requires a filename argument.
48
49 jshell.err.startup.unexpected.exception = Unexpected exception reading start-up: {0}
50 jshell.err.unexpected.exception = Unexpected exception: {0}
51
52 jshell.err.no.such.command.or.snippet.id = No such command or snippet id: {0}
53 jshell.err.command.ambiguous = Command: ''{0}'' is ambiguous: {1}
54 jshell.err.set.editor.arg = The ''/set editor'' command requires a path argument
55 jshell.msg.set.editor.set = Editor set to: {0}
56 jshell.err.cant.launch.editor = Cannot launch editor -- unexpected exception: {0}
57 jshell.msg.try.set.editor = Try /set editor to use external editor.
58
59 jshell.msg.try.command.without.args = Try ''{0}'' without arguments.
60 jshell.msg.no.active = There are no active definitions.
61
62 jshell.msg.resetting = Resetting...
63 jshell.msg.resetting.state = Resetting state.
64
65 jshell.err.reload.no.previous = No previous history to restore
66 jshell.err.reload.restarting.previous.state = Restarting and restoring from previous state.
67 jshell.err.reload.restarting.state = Restarting and restoring state.
68
69 jshell.msg.vars.not.active = (not-active)
70
71 jshell.err.out.of.range = Out of range
72
73 jshell.msg.error = Error:
74 jshell.msg.warning = Warning:
75
76 jshell.err.sub.arg = The ''{0}'' command requires a sub-command. See: ''/help {0}''
77 jshell.err.sub.ambiguous = Ambiguous sub-command argument to ''{0}'': {1}
78
79 jshell.err.classpath.arg = The /classpath command requires a path argument.
80 jshell.msg.classpath = Path ''{0}'' added to classpath
81
82 jshell.err.help.arg = No commands or subjects start with the provided argument: {0}
83 jshell.msg.help.begin =\
84 Type a Java language expression, statement, or declaration.\n\
85 Or type one of the following commands:\n
86 jshell.msg.help.subject =\n\
87 For more information type ''/help'' followed by the name of command or a subject.\n\
88 For example ''/help /list'' or ''/help intro''. Subjects:\n
89
90 jshell.err.drop.arg =\
91 In the /drop argument, please specify an import, variable, method, or class to drop.\n\
92 Specify by id or name. Use /list to see ids. Use /reset to reset all state.
93 jshell.err.drop.ambiguous = The argument references more than one import, variable, method, or class.
94 jshell.err.failed = Failed.
95 jshell.msg.native.method = Native Method
96 jshell.msg.unknown.source = Unknown Source
97 jshell.msg.goodbye = Goodbye
98
99 jshell.msg.help.for.help = Type /help for help.
100
101 jshell.err.mode.name = Expected a feedback mode name: {0}
102 jshell.err.missing.mode = Missing the feedback mode -- {0}
103 jshell.err.field.name = Expected a field name: {0} -- {1}
104 jshell.err.missing.field = Missing the field name -- {0}
105 jshell.err.mode.unknown = No feedback mode named: {0} -- {1}
106
107 jshell.err.feedback.does.not.match.mode = Does not match any current feedback mode: {0} -- {1}
108 jshell.err.feedback.ambiguous.mode = Matches more then one current feedback mode: {0} -- {1}
109 jshell.err.feedback.expected.format = Expected format missing -- {0}
110 jshell.err.feedback.must.be.quoted = Format ''{0}'' must be quoted -- {1}
111 jshell.err.feedback.not.a.valid.selector = Not a valid selector ''{0}'' in ''{1}'' -- {2}
112 jshell.err.feedback.multiple.sections = Selector kind in multiple sections of selector list ''{0}'' in ''{1}'' -- {2}
113 jshell.err.feedback.different.selector.kinds = Different selector kinds in same sections of selector list ''{0}'' in ''{1}'' -- {2}
114
115 jshell.msg.feedback.new.mode = Created new feedback mode: {0}
116 jshell.msg.feedback.mode = Feedback mode: {0}
117 jshell.msg.feedback.mode.following = The feedback mode should be one of the following:
118
119 jshell.err.truncation.expected.length = Expected truncation length -- {0}
120 jshell.err.truncation.length.not.integer = Truncation length must be an integer: {0} -- {1}
121
122 jshell.err.not.valid.with.predefined.mode = Not valid with a predefined mode: {0} -- {1}
123 jshell.err.retained.feedback.mode.must.be.retained.or.predefined = \
124 ''/retain feedback <mode>'' requires that <mode> is predefined or has been retained with ''/retain mode'' -- {0}
125
126 jshell.err.unknown.option = Unknown option: {0} -- {1}
127 jshell.err.default.option.or.program = Specify -default option or program, not both -- {0}
128 jshell.err.option.or.filename = Specify either one option or a startup file name -- {0}
129 jshell.err.unexpected.at.end = Unexpected arguments at end of command: {0} -- {1}
130 jshell.err.conflicting.options = Conflicting options -- {0}
131 jshell.err.cannot.delete.current.mode = The current feedback mode ''{0}'' cannot be deleted, use ''/set feedback'' first -- {1}
132 jshell.err.cannot.delete.retained.mode = The retained feedback mode ''{0}'' cannot be deleted, use ''/retain feedback'' first -- {1}
133 jshell.err.may.not.specify.options.and.snippets = Options and snippets must not both be used: {0}
134 jshell.err.no.such.snippets = No such snippet: {0}
135 jshell.err.the.snippet.cannot.be.used.with.this.command = This command does not accept the snippet ''{0}'' : {1}
136 jshell.err.retained.mode.failure = Failure in retained modes (modes cleared) -- {0} {1}
137
138 jshell.console.see.more = <press tab to see more>
139 jshell.console.do.nothing = Do nothing
140 jshell.console.choice = Choice: \
141
142 jshell.console.create.variable = Create variable
143 jshell.console.resolvable = \nThe identifier is resolvable in this context.
144 jshell.console.no.candidate = \nNo candidate fully qualified names found to import.
145 jshell.console.incomplete = \nResults may be incomplete; try again later for complete results.
146
147
148 help.usage = \
149 Usage: jshell <options> <load files>\n\
150 where possible options include:\n\
151 \ -classpath <path> Specify where to find user class files\n\
152 \ -cp <path> Specify where to find user class files\n\
153 \ -startup <file> One run replacement for the start-up definitions\n\
154 \ -nostartup Do not run the start-up definitions\n\
155 \ -feedback <mode> Specify the initial feedback mode. The mode may be\n\
156 \ predefined (silent, concise, normal, or verbose) or\n\
157 \ previously user-defined\n\
158 \ -q Quiet feedback. Same as: -feedback concise\n\
159 \ -qq Really quiet feedback. Same as: -feedback silent\n\
160 \ -v Verbose feedback. Same as: -feedback verbose\n\
161 \ -J<flag> Pass <flag> directly to the runtime system.\n\
162 \ Use one -J for each runtime flag or flag argument\n\
163 \ -R<flag> Pass <flag> to the remote runtime system.\n\
164 \ Use one -R for each remote flag or flag argument\n\
165 \ -help Print this synopsis of standard options\n\
166 \ -version Version information\n
167
168 help.list.summary = list the source you have typed
169 help.list.args = [<name or id>|-all|-start]
170 help.list =\
171 Show the source of snippets, prefaced with the snippet id.\n\
172 \n\
173 /list\n\t\
174 List the currently active snippets of code that you typed or read with /open\n\n\
175 /list -start\n\t\
176 List the automatically evaluated start-up snippets\n\n\
177 /list -all\n\t\
178 List all snippets including failed, overwritten, dropped, and start-up\n\n\
179 /list <name>\n\t\
180 List snippets with the specified name (preference for active snippets)\n\n\
181 /list <id>\n\t\
182 List the snippet with the specified snippet id
183
184 help.edit.summary = edit a source entry referenced by name or id
185 help.edit.args = <name or id>
186 help.edit =\
187 Edit a snippet or snippets of source in an external editor.\n\
188 The editor to use is set with /set editor.\n\
189 If no editor has been set, a simple editor will be launched.\n\
190 \n\
191 /edit <name>\n\t\
192 Edit the snippet or snippets with the specified name (preference for active snippets)\n\n\
193 /edit <id>\n\t\
194 Edit the snippet with the specified snippet id\n\n\
195 /edit\n\t\
196 Edit the currently active snippets of code that you typed or read with /open
197
198 help.drop.summary = delete a source entry referenced by name or id
199 help.drop.args = <name or id>
200 help.drop =\
201 Drop a snippet -- making it inactive.\n\
202 \n\
203 /drop <name>\n\t\
204 Drop the snippet with the specified name\n\n\
205 /drop <id>\n\t\
206 Drop the snippet with the specified snippet id
207
208 help.save.summary = Save snippet source to a file.
209 help.save.args = [-all|-history|-start] <file>
210 help.save =\
211 Save the specified snippets and/or commands to the specified file.\n\
212 \n\
213 /save <file>\n\t\
214 Save the source of current active snippets to the file.\n\n\
215 /save -all <file>\n\t\
216 Save the source of all snippets to the file.\n\t\
217 Includes source including overwritten, failed, and start-up code.\n\n\
218 /save -history <file>\n\t\
219 Save the sequential history of all commands and snippets entered since jshell was launched.\n\n\
220 /save -start <file>\n\t\
221 Save the default start-up definitions to the file.
222
223 help.open.summary = open a file as source input
224 help.open.args = <file>
225 help.open =\
226 Open a file and read its contents as snippets and commands.\n\
227 \n\
228 /open <file>\n\t\
229 Read the specified file as jshell input.
230
231 help.vars.summary = list the declared variables and their values
232 help.vars.args = [<name or id>|-all|-start]
233 help.vars =\
234 List the type, name, and value of jshell variables.\n\
235 \n\
236 /vars\n\t\
237 List the type, name, and value of the current active jshell variables\n\n\
238 /vars <name>\n\t\
239 List jshell variables with the specified name (preference for active variables)\n\n\
240 /vars <id>\n\t\
241 List the jshell variable with the specified snippet id\n\n\
242 /vars -start\n\t\
243 List the automatically added start-up jshell variables\n\n\
244 /vars -all\n\t\
245 List all jshell variables including failed, overwritten, dropped, and start-up
246
247 help.methods.summary = list the declared methods and their signatures
248 help.methods.args = [<name or id>|-all|-start]
249 help.methods =\
250 List the name, parameter types, and return type of jshell methods.\n\
251 \n\
252 /methods\n\t\
253 List the name, parameter types, and return type of the current active jshell methods\n\n\
254 /methods <name>\n\t\
255 List jshell methods with the specified name (preference for active methods)\n\n\
256 /methods <id>\n\t\
257 List the jshell method with the specified snippet id\n\n\
258 /methods -start\n\t\
259 List the automatically added start-up jshell methods\n\n\
260 /methods -all\n\t\
261 List all snippets including failed, overwritten, dropped, and start-up
262
263 help.types.summary = list the declared types
264 help.types.args =[<name or id>|-all|-start]
265 help.types =\
266 List jshell classes, interfaces, and enums.\n\
267 \n\
268 /types\n\t\
269 List the current active jshell classes, interfaces, and enums.\n\n\
270 /types <name>\n\t\
271 List jshell types with the specified name (preference for active types)\n\n\
272 /types <id>\n\t\
273 List the jshell type with the specified snippet id\n\n\
274 /types -start\n\t\
275 List the automatically added start-up jshell types\n\n\
276 /types -all\n\t\
277 List all jshell types including failed, overwritten, dropped, and start-up
278
279 help.imports.summary = list the imported items
280 help.imports.args =
281 help.imports =\
282 List the current active jshell imports.
283
284 help.exit.summary = exit jshell
285 help.exit.args =
286 help.exit =\
287 Leave the jshell tool. No work is saved.\n\
288 Save any work before using this command
289
290 help.reset.summary = reset jshell
291 help.reset.args =
292 help.reset =\
293 Reset the jshell tool code and execution state:\n\t\
294 * All entered code is lost.\n\t\
295 * Start-up code is re-executed.\n\t\
296 * The execution state is restarted.\n\t\
297 * The classpath is cleared.\n\
298 Tool settings are maintained, as set with: /set ...\n\
299 Save any work before using this command
300
301 help.reload.summary = reset and replay relevant history -- current or previous (-restore)
302 help.reload.args = [-restore] [-quiet]
303 help.reload =\
304 Reset the jshell tool code and execution state then replay each\n\
305 jshell valid command and valid snippet in the order they were entered.\n\
306 \n\
307 /reload\n\t\
308 Reset and replay the valid history since jshell was entered, or\n\t\
309 a /reset, or /reload command was executed -- whichever is most\n\t\
310 recent.\n\n\
311 /reload -restore\n\t\
312 Reset and replay the valid history between the previous and most\n\t\
313 recent time that jshell was entered, or a /reset, or /reload\n\t\
314 command was executed. This can thus be used to restore a previous\n\t\
315 jshell tool sesson.\n\n\
316 /reload [-restore] -quiet\n\t\
317 With the '-quiet' argument the replay is not shown. Errors will display.
318
319 help.classpath.summary = add a path to the classpath
320 help.classpath.args = <path>
321 help.classpath =\
322 Append a additional path to the classpath.
323
324 help.history.summary = history of what you have typed
325 help.history.args =
326 help.history =\
327 Display the history of snippet and command input since this jshell was launched.
328
329 help.debug.summary = toggle debugging of the jshell
330 help.debug.args = [0][r][g][f][c][d][e]
331 help.debug =\
332 Display debugging information for the jshell implementation.\n\
333 0: Debugging off\n\
334 r: Tool level debugging on\n\
335 g: General debugging on\n\
336 f: File manager debugging on\n\
337 c: Completion analysis debugging on\n\
338 d: Dependency debugging on\n\
339 e: Event debugging on
340
341 help.help.summary = get information about jshell
342 help.help.args = [<command>|<subject>]
343 help.help =\
344 Display information about jshell.\n\
345 /help\n\t\
346 List the jshell commands and help subjects.\n\n\
347 /help <command>\n\t\
348 Display information about the specified comand. The slash must be included.\n\t\
349 Only the first few letters of the command are needed -- if more than one\n\t\
350 each will be displayed. Example: /help /li\n\n\
351 /help <subject>\n\t\
352 Display information about the specified help subject. Example: /help intro
353
354 help.set.summary = set jshell configuration information
355 help.set.args = editor|start|feedback|mode|prompt|truncation|format ...
356 help.set =\
357 Set jshell configuration information, including:\n\
358 the external editor to use, the start-up definitions to use, a new feedback mode,\n\
359 the command prompt, the feedback mode to use, or the format of output.\n\
360 \n\
361 /set editor <command> <optional-arg>...\n\t\
362 Specify the command to launch for the /edit command.\n\t\
363 The <command> is an operating system dependent string.\n\n\
364 /set start <file>\n\t\
365 The contents of the specified <file> become the default start-up snippets and commands.\n\n\
366 /set feedback <mode>\n\t\
367 Set the feedback mode describing displayed feedback for entered snippets and commands.\n\n\
368 /set mode <mode> [<old-mode>] [-command|-quiet|-delete]\n\t\
369 Create or update a user-defined feedback mode, optionally copying from an existing mode.\n\n\
370 /set prompt <mode> "<prompt>" "<continuation-prompt>"\n\t\
371 Set the displayed prompts for a given feedback mode.\n\n\
372 /set truncation <mode> <length> <selector>...\n\t\
373 Set the maximum length of a displayed value\n\
374 /set format <mode> <field> "<format>" <selector>...\n\t\
375 Configure a feedback mode by setting the format of a field when the selector matchs.\n\n\
376 To get more information about one of these forms, use /help with the form specified.\n\
377 For example: /help /set format
378
379 help.retain.summary = retain jshell configuration information for subsequent sessions
380 help.retain.args = editor|start|feedback|mode
381 help.retain =\
382 Retain jshell configuration information for future invocations of the jshell tool,\n\
383 including: the external editor to use, the start-up definitions to use, the\n\
384 configuration of a feedback mode, or the feedback mode to use.\n\
385 \n\
386 /retain editor [<command> <optional-arg>...]\n\t\
387 Specify the command to launch for the /edit command.\n\t\
388 The <command> is an operating system dependent string.\n\n\
389 /retain start [<file>]\n\t\
390 The contents of the specified <file> become the default start-up snippets and commands.\n\n\
391 /retain feedback [<mode>]\n\t\
392 Set the feedback mode describing displayed feedback for entered snippets and commands.\n\n\
393 /retain mode <mode>\n\t\
394 Create a user-defined feedback mode, optionally copying from an existing mode.\n\n\
395 To get more information about one of these forms, use /help with the form specified.\n\
396 For example: /help /retain feedback
397
398 help.quest.summary = get information about jshell
399 help.quest.args = [<command>|<subject>]
400 help.quest =\
401 Display information about jshell (abbreviation for /help).\n\
402 /?\n\t\
403 Display list of commands and help subjects.\n\
404 /? <command>\n\t\
405 Display information about the specified comand. The slash must be included.\n\t\
406 Only the first few letters of the command are needed -- if more than one\n\t\
407 match, each will be displayed. Example: /? /li\n\
408 /? <subject>\n\t\
409 Display information about the specified help subject. Example: /? intro
410
411 help.bang.summary = re-run last snippet
412 help.bang.args =
413 help.bang =\
414 Reevaluate the most recently entered snippet.
415
416 help.id.summary = re-run snippet by id
417 help.id.args =
418 help.id =\
419 Reevaluate the snippet specified by the id.
420
421 help.previous.summary = re-run n-th previous snippet
422 help.previous.args =
423 help.previous =\
424 Reevaluate the n-th most recently entered snippet.
425
426 help.intro.summary = an introduction to the jshell tool
427 help.intro =\
428 The jshell tool allows you to execute Java code, getting immediate results.\n\
429 You can enter a Java definition (variable, method, class, etc), like: int x = 8\n\
430 or a Java expression, like: x + x\n\
431 or a Java statement or import.\n\
432 These little chunks of Java code are called 'snippets'.\n\
433 \n\
434 There are also jshell commands that allow you to understand and\n\
435 control what you are doing, like: /list\n\
436 \n\
437 For a list of commands: /help
438
439 help.shortcuts.summary = a description of shortcuts
440 help.shortcuts =\
441 Supported shortcuts include:\n\
442 \n\
443 <tab>\n\t\t\
444 After entering the first few letters of a Java identifier,\n\t\t\
445 a jshell command, or, in some cases, a jshell command argument,\n\t\t\
446 press the <tab> key to complete the input.\n\t\t\
447 If there is more than one completion, show possible completions.\n\n\
448 Shift-<tab>\n\t\t\
449 After the name and open parenthesis of a method or constructor invocation,\n\t\t\
450 hold the <shift> key and press the <tab> to see a synopsis of all\n\t\t\
451 matching methods/constructors.\n\n\
452 <fix-shortcut> v\n\t\t\
453 After a complete expression, press "<fix-shortcut> v" to introduce a new variable\n\t\t\
454 whose type is based on the type of the expression.\n\t\t\
455 The "<fix-shortcut>" is either Alt-F1 or Alt-Enter, depending on the platform.\n\n\
456 <fix-shortcut> i\n\t\t\
457 After an unresolvable identifier, press "<fix-shortcut> i" and jshell will propose\n\t\t\
458 possible fully qualified names based on the content of the specified classpath.\n\t\t\
459 The "<fix-shortcut>" is either Alt-F1 or Alt-Enter, depending on the platform.
460
461 help.set.format = \
462 Set the format for reporting a snippet event.\n\
463 \n\t\
464 /set format <mode> <field> "<format>" <selector>...\n\
465 \n\
466 Where <mode> is the name of a previously defined feedback mode -- see '/help /set mode'.\n\
467 Where <field> is the name of context-specific format to define.\n\
468 Where <format> is a quoted string which will be the value of the field if one of\n\
469 the selectors matches (or there are no selectors). When the format is used,\n\
470 field names enclosed in braces are replaced with the value of the field at that\n\
471 time. These fields may have been previously defined with this command or may be\n\
472 one of these predefined fields specific to the context:\n\t\
473 {name} == The name, e.g.: the variable name, ...\n\t\
474 {type} == The type name. The type of a variable or expression, the\n\t\t\t\
475 parameter types of a method\n\t\
476 {value} == The result value of an expression or variable initialization\n\t\
477 {unresolved} == The list of unresolved references\n\t\
478 {errors} == The list of recoverable errors (during the processing of the\n\t\t\t\
479 "display" field only)\n\t\
480 {err} == An unformatted error line (during the processing of the\n\t\t\t\
481 "errorline" field only)\n\
482 The following fields are accessed by the tool to determine the displayed feedback:\n\t\
483 {display} == The displayed message for a snippet event\n\t\
484 {errorline} == The format of one error line within the "errors" field\n\t\
485 {pre} == The feedback prefix (begins command feedback)\n\t\
486 {post} == The feedback postfix (ends command feedback)\n\t\
487 {errorpre} == The error prefix (begins error feedback)\n\t\
488 {errorpost} == The error postfix (ends error feedback)\n\
489 These fields have default settings (which may be overwritten).\n\
490 Where <selector> is the context in which the format is applied.\n\
491 The structure of selector is a hyphen separated list of selector kind lists.\n\
492 A selector kind list is a comma separated list of values of one selector kind.\n\
493 A selector matches if each selector kind list matches; A selector kind list\n\
494 matches if one of the values matches.\n\n\
495 The case selector kind describes the kind of snippet. The values are:\n\t\
496 import -- import declaration\n\t\
497 class -- class declaration\n\t\
498 interface -- interface declaration\n\t\
499 enum -- enum declaration\n\t\
500 annotation -- annotation interface declaration\n\t\
501 method -- method declaration -- note: {type}==parameter-types\n\t\
502 vardecl -- variable declaration without init\n\t\
503 varinit -- variable declaration with init\n\t\
504 expression -- expression -- note: {name}==scratch-variable-name\n\t\
505 varvalue -- variable value expression\n\t\
506 assignment -- assign variable\n\t\
507 statement -- statement\n\
508 The action selector kind describes what happened to the snippet. The values are:\n\t\
509 added -- snippet has been added\n\t\
510 modified -- an existing snippet has been modified\n\t\
511 replaced -- an existing snippet has been replaced with a new snippet\n\t\
512 overwrote -- an existing snippet has been overwritten\n\t\
513 dropped -- snippet has been dropped\n\t\
514 used -- snippet was used when it cannot be\n\
515 The when-did-it-occur selector kind describes if this is a direct or indirect action. The values are:\n\t\
516 primary -- the entered snippet\n\t\
517 update -- an update to a dependent snippet\n\
518 The resolution-state selector kind describes the state of resolution/definition of the snippet. The values are:\n\t\
519 ok -- resolved correctly\n\t\
520 defined -- defined despite recoverably unresolved references\n\t\
521 notdefined -- not defined because of recoverably unresolved references\n\
522 The unresolved-count selector kind describes the number of unresolved references. The values are:\n\t\
523 unresolved0 -- no names are unresolved\n\t\
524 unresolved1 -- one name is unresolved\n\t\
525 unresolved2 -- two or more names are unresolved\n\
526 The errors-count selector kind describes the number of errors. The values are:\n\t\
527 error0 -- no errors\n\t\
528 error1 -- one error\n\t\
529 error2 -- two or more errors\n\n\
530 Examples:\n\t\
531 /set format myformat action 'Created' added-primary\n\t\
532 /set format myformat action 'Update replaced' replaced-update\n\t\
533 /set format myformat display '{pre}{action} class {name}{post}' class-ok\n\t\
534 /set format myformat display '{pre}{action} variable {name}, reset to null{post}' replaced-vardecl,varinit-ok-update\n\n\
535 Note that subsequent selectors for a field may overwrite some or all of previous used selectors -- last one wins\n
536
537 help.set.truncation = \
538 Set the max length a displayed value.\n\
539 \n\t\
540 /set truncation <mode> <length> <selector>...\n\
541 \n\
542 Where <mode> is the name of a previously defined feedback mode -- see '/help /set mode'.\n\
543 Where <length> is an unsigned integer representing a maximum length.\n\
544 Where <format> is a quoted string which will be the value of the field if one of\n\
545 Where <selector> is only needed if you wish to fine-tune value truncation length\n\
546 by context, <selector> is the context in which the truncation is applied.\n\
547 The structure of selector is a hyphen separated list of selector kind lists.\n\
548 A selector kind list is a comma separated list of values of one selector kind.\n\
549 A selector matches if each selector kind list matches; A selector kind list\n\
550 matches if one of the values matches.\n\n\
551 Below are the relevant selector kinds for truncation.\n\n\
552 The case selector kind describes the kind of snippet. The values are:\n\t\
553 vardecl -- variable declaration without init\n\t\
554 varinit -- variable declaration with init\n\t\
555 expression -- expression -- note: {name}==scratch-variable-name\n\t\
556 varvalue -- variable value expression\n\t\
557 assignment -- assign variable\n\t\
558 The action selector kind describes what happened to the snippet. The values are:\n\t\
559 added -- snippet has been added\n\t\
560 modified -- an existing snippet has been modified\n\t\
561 replaced -- an existing snippet has been replaced with a new snippet\n\
562 Examples:\n\t\
563 /set trunc mymode 80\n\t\
564 /set truncation mymode 45 expression\n\t\
565 /set truncation mymode 0 vardecl-modified,replaced\n\n\
566 Note that subsequent selectors for a field may overwrite some or all of previous used selectors -- last one wins\n
567
568 help.set.feedback = \
569 Set the feedback mode describing displayed feedback for entered snippets and commands.\n\
570 \n\t\
571 /set feedback <mode>\n\
572 \n\
573 Where <mode> is the name of a previously defined feedback mode.\n\
574 You may use just enough letters to make it unique.\n\
575 User-defined modes can be added, see '/help /set mode'\n\
576 Currently defined feedback modes:\n
577
578 help.set.mode = \
579 Create a user-defined feedback mode, optionally copying from an existing mode.\n\
580 \n\t\
581 /set mode <mode> [<old-mode>] [-command|-quiet|-delete]\n\
582 \n\
583 Where <new-mode> is the name of a mode you wish to create.\n\
584 Where <old-mode> is the name of a previously defined feedback mode.\n\
585 If <old-mode> is present, its settings are copied to the new mode.\n\
586 '-command' vs '-quiet' determines if informative/verifying command feedback is displayed.\n\
587 \n\
588 Once the new mode is created, use '/set format' and '/set prompt' to configure it.\n\
589 Use '/set feedback' to use the new mode.\n\
590
591 help.set.prompt = \
592 Set the prompts. Both the normal prompt and the continuation-prompt must be set.\n\
593 \n\t\
594 /set prompt <mode> \"<prompt>\" \"<continuation-prompt>\"\n\
595 \n\
596 Where <mode> is the name of a previously defined feedback mode.\n\
597 Where <prompt> and <continuation-prompt> are quoted strings printed as input prompts;\n\
598 Both may optionally contain '%s' which will be substituted with the next snippet id --\n\
599 note that what is entered may not be assigned that id, for example it may be an error or command.\n\
600 The continuation-prompt is used on the second and subsequent lines of a multi-line snippet.\n
601
602 help.set.editor =\
603 Specify the command to launch for the /edit command.\n\
604 \n\t\
605 /set editor <command>|-default\n\
606 \n\
607 The <command> is an operating system dependent string.\n\
608 The <command> may include space-separated arguments (such as flags)\n\
609 When /edit is used, the temporary file to edit will be appended as the last argument.\n\
610 If instead the -default option is specified, the built-in default editor will be used.
611
612 help.set.start =\
613 Set the start-up configuration -- a sequence of snippets and commands read at start-up.\n\
614 \n\t\
615 /set start <file>|-default|-none\n\
616 \n\
617 The contents of the specified <file> become the start-up snippets and commands used\n\
618 when the /reset or /reload commands are used in this session.\n\
619 If instead the -default option is specified, the predefined start-up snippets\n\
620 will be used.\n\
621 If the -none option is used, the start-up will be empty -- no start-up snippets\n\
622 or commands will be used.\n\
623 This command is good for testing the start-up settings. To retain them for future\n\
624 runs of the jshell tool use the command:\n\t\
625 /retain start\n
626
627 help.retain.feedback = \
628 Retain which feedback mode to use for displayed feedback for entered snippets and commands.\n\
629 This feedback mode will be used in this and future sessions of the jshell tool.\n\
630 \n\t\
631 /retain feedback [<mode>]\n\
632 \n\
633 Where <mode> is the name of a previously defined feedback mode.\n\
634 You may use just enough letters to make it unique.\n\
635 If the <mode> is not specified, this command retains the current mode (as set\n\
636 with the most recent /set feedback or /retain feedback command.)\n\
637
638 help.retain.mode = \
639 Retain the existence and configuration of a user-defined feedback mode.\n\
640 This mode will be available in this and future sessions of the jshell tool.
641 \n\t\
642 /retain mode <mode>\n\
643 \n\
644 Where <mode> is the name of a mode you wish to retain.\n\
645 The <mode> must previously have been created with /set mode and\n\
646 configured as desired with /set prompt, /set format, and /set truncation.\n
647
648 help.retain.editor =\
649 Retain the command to launch for the /edit command. This command will be invoked when\n\
650 the /edit command is used in this and future sessions of the jshell tool.\n\
651 \n\t\
652 /retain editor [<command>|-default]\n\
653 \n\
654 If <command> is specified, it is an operating system dependent string which\n\
655 may include space-separated arguments (such as flags). When /edit is used, the\n\
656 temporary file to edit will be appended as the last argument.\n\
657 If instead the -default option is specified, the built-in default editor will be used.\n\
658 If neither is specified, the editor set in the last /set editor or /retain editor\n\
659 command will be used.\n\
660 The editor will be retained and used in this and future runs of the jshell tool.
661
662 help.retain.start =\
663 Retain the start-up configuration -- a sequence of snippets and commands read\n\
664 at start-up.\n\
665 \n\t\
666 /retain start [<file>|-default|-none]\n\
667 \n\
668 If <file> is specified, the contents of the specified <file> become the\n\
669 start-up snippets\n\
670 and commands.\n\
671 If instead the -default option is specified, the predefined start-up snippets\n\
672 will be the start-up.\n\
673 If the -none option is used, the start-up will be empty -- no start-up snippets\n\
674 or commands will be used.\n\
675 If none of these is specified, the start-up is the last specified in a\n\
676 ''/set start'' or ''/retain start'' command.\n\
677 The start-up will be retained and used when the jshell tool is started or reset
678
679 startup.feedback = \
680 /set mode verbose -command \n\
681 \n\
682 /set prompt verbose '\\njshell> ' ' ...> ' \n\
683 \n\
684 /set format verbose pre '| ' \n\
685 /set format verbose post '%n' \n\
686 /set format verbose errorpre '| ' \n\
687 /set format verbose errorpost '%n' \n\
688 \n\
689 /set format verbose errorline '{post}{pre} {err}' \n\
690 \n\
691 /set format verbose action 'created' added-primary \n\
692 /set format verbose action 'modified' modified-primary \n\
693 /set format verbose action 'replaced' replaced-primary \n\
694 /set format verbose action 'overwrote' overwrote-primary \n\
695 /set format verbose action 'dropped' dropped-primary \n\
696 /set format verbose action ' update created' added-update \n\
697 /set format verbose action ' update modified' modified-update \n\
698 /set format verbose action ' update replaced' replaced-update \n\
699 /set format verbose action ' update overwrote' overwrote-update \n\
700 /set format verbose action ' update dropped' dropped-update \n\
701 \n\
702 /set format verbose until ', however, it cannot be instanciated or its methods invoked until' defined-class-primary \n\
703 /set format verbose until ', however, its methods cannot be invoked until' defined-interface-primary \n\
704 /set format verbose until ', however, it cannot be used until' defined-enum,annotation-primary \n\
705 /set format verbose until ', however, it cannot be invoked until' defined-method-primary \n\
706 /set format verbose until ', however, it cannot be referenced until' notdefined-primary \n\
707 /set format verbose until ' which cannot be instanciated or its methods invoked until' defined-class-update \n\
708 /set format verbose until ' whose methods cannot be invoked until' defined-interface-update \n\
709 /set format verbose until ' which cannot be invoked until' defined-method-update \n\
710 /set format verbose until ' which cannot be referenced until' notdefined-update \n\
711 \n\
712 /set format verbose unrerr '{unresolved} is declared' unresolved1-error0 \n\
713 /set format verbose unrerr '{unresolved} are declared' unresolved2-error0 \n\
714 /set format verbose unrerr ' this error is corrected: {errors}' unresolved0-error1 \n\
715 /set format verbose unrerr '{unresolved} is declared and this error is corrected: {errors}' unresolved1-error1 \n\
716 /set format verbose unrerr '{unresolved} are declared and this error is corrected: {errors}' unresolved2-error1 \n\
717 /set format verbose unrerr ' these errors are corrected: {errors}' unresolved0-error2 \n\
718 /set format verbose unrerr '{unresolved} is declared and these errors are corrected: {errors}' unresolved1-error2 \n\
719 /set format verbose unrerr '{unresolved} are declared and these errors are corrected: {errors}' unresolved2-error2 \n\
720 \n\
721 /set format verbose resolve '{until}{unrerr}' added,modified,replaced,used \n\
722 \n\
723 /set format verbose typeKind 'class' class \n\
724 /set format verbose typeKind 'interface' interface \n\
725 /set format verbose typeKind 'enum' enum \n\
726 /set format verbose typeKind 'annotation interface' annotation \n\
727 \n\
728 /set format verbose result '{name} ==> {value}{post}' added,modified,replaced-ok-primary \n\
729 \n\
730 /set format verbose display '{result}{pre}created scratch variable {name} : {type}{post}' expression-added,modified,replaced-primary \n\
731 /set format verbose display '{result}{pre}value of {name} : {type}{post}' varvalue-primary \n\
732 /set format verbose display '{result}{pre}assigned to {name} : {type}{post}' assignment-primary \n\
733 /set format verbose display '{result}{pre}{action} variable {name} : {type}{resolve}{post}' varinit,vardecl \n\
734 /set format verbose display '{pre}{action} variable {name}{resolve}{post}' vardecl,varinit-notdefined \n\
735 /set format verbose display '{pre}{action} variable {name}{post}' dropped-vardecl,varinit,expression \n\
736 /set format verbose display '{pre}{action} variable {name}, reset to null{post}' replaced-vardecl,varinit-ok-update \n\
737 \n\
738 /set format verbose display '{pre}{action} {typeKind} {name}{resolve}{post}' class,interface,enum,annotation \n\
739 /set format verbose display '{pre}{action} method {name}({type}){resolve}{post}' method \n\
740 \n\
741 /set format verbose display '{pre}attempted to use {typeKind} {name}{resolve}{post}' used-class,interface,enum,annotation \n\
742 /set format verbose display '{pre}attempted to call method {name}({type}){resolve}{post}' used-method \n\
743 \n\
744 /set truncation verbose 80\n\
745 /set truncation verbose 1000 varvalue,expression\n\
746 \n\
747 /set mode normal -command verbose \n\
748 /set format normal display '' added,modified,replaced,overwrote,dropped-update \n\
749 /set format normal display '{pre}{action} variable {name}, reset to null{post}' replaced-vardecl,varinit-ok-update \n\
750 /set format normal display '{result}' added,modified,replaced-expression,varvalue,assignment,varinit,vardecl-ok-primary \n\
751 /set mode concise -quiet normal \n\
752 \n\
753 /set prompt concise 'jshell> ' ' ...> ' \n\
754 \n\
755 /set format concise display '' class,interface,enum,annotation,method,assignment,varinit,vardecl-ok \n\
756 \n\
757 /set feedback normal \n\
758 \n\
759 /set mode silent -quiet \n\
760 /set prompt silent '-> ' '>> ' \n\
761 /set format silent pre '| ' \n\
762 /set format silent post '%n' \n\
763 /set format silent errorpre '| ' \n\
764 /set format silent errorpost '%n' \n\
765 /set format silent display '' \n