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.arg = Argument to {0} missing.
30 jshell.err.opt.invalid = Invalid options: {0}.
31 jshell.err.opt.one = Only one {0} option may be used.
32 jshell.err.opt.startup.one = Only one --startup or --no-startup 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 \ --class-path <path> Specify where to find user class files\n\
152 \ --startup <file> One run replacement for the start-up definitions\n\
153 \ --no-startup Do not run the start-up definitions\n\
154 \ --feedback <mode> Specify the initial feedback mode. The mode may be\n\
155 \ predefined (silent, concise, normal, or verbose) or\n\
156 \ previously user-defined\n\
157 \ -q Quiet feedback. Same as: --feedback concise\n\
158 \ -s Really quiet feedback. Same as: --feedback silent\n\
159 \ -v Verbose feedback. Same as: --feedback verbose\n\
160 \ -J<flag> Pass <flag> directly to the runtime system.\n\
161 \ Use one -J for each runtime flag or flag argument\n\
162 \ -R<flag> Pass <flag> to the remote runtime system.\n\
163 \ Use one -R for each remote flag or flag argument\n\
164 \ --help Print this synopsis of standard options\n\
165 \ --version Version information\n
166
167 help.list.summary = list the source you have typed
168 help.list.args = [<name or id>|-all|-start]
169 help.list =\
170 Show the source of snippets, prefaced with the snippet id.\n\
171 \n\
172 /list\n\t\
173 List the currently active snippets of code that you typed or read with /open\n\n\
174 /list -start\n\t\
175 List the automatically evaluated start-up snippets\n\n\
176 /list -all\n\t\
177 List all snippets including failed, overwritten, dropped, and start-up\n\n\
178 /list <name>\n\t\
179 List snippets with the specified name (preference for active snippets)\n\n\
180 /list <id>\n\t\
181 List the snippet with the specified snippet id
182
183 help.edit.summary = edit a source entry referenced by name or id
184 help.edit.args = <name or id>
185 help.edit =\
186 Edit a snippet or snippets of source in an external editor.\n\
187 The editor to use is set with /set editor.\n\
188 If no editor has been set, a simple editor will be launched.\n\
189 \n\
190 /edit <name>\n\t\
191 Edit the snippet or snippets with the specified name (preference for active snippets)\n\n\
192 /edit <id>\n\t\
193 Edit the snippet with the specified snippet id\n\n\
194 /edit\n\t\
195 Edit the currently active snippets of code that you typed or read with /open
196
197 help.drop.summary = delete a source entry referenced by name or id
198 help.drop.args = <name or id>
199 help.drop =\
200 Drop a snippet -- making it inactive.\n\
201 \n\
202 /drop <name>\n\t\
203 Drop the snippet with the specified name\n\n\
204 /drop <id>\n\t\
205 Drop the snippet with the specified snippet id
206
207 help.save.summary = Save snippet source to a file.
208 help.save.args = [-all|-history|-start] <file>
209 help.save =\
210 Save the specified snippets and/or commands to the specified file.\n\
211 \n\
212 /save <file>\n\t\
213 Save the source of current active snippets to the file.\n\n\
214 /save -all <file>\n\t\
215 Save the source of all snippets to the file.\n\t\
216 Includes source including overwritten, failed, and start-up code.\n\n\
217 /save -history <file>\n\t\
218 Save the sequential history of all commands and snippets entered since jshell was launched.\n\n\
219 /save -start <file>\n\t\
220 Save the default start-up definitions to the file.
221
222 help.open.summary = open a file as source input
223 help.open.args = <file>
224 help.open =\
225 Open a file and read its contents as snippets and commands.\n\
226 \n\
227 /open <file>\n\t\
228 Read the specified file as jshell input.
229
230 help.vars.summary = list the declared variables and their values
231 help.vars.args = [<name or id>|-all|-start]
232 help.vars =\
233 List the type, name, and value of jshell variables.\n\
234 \n\
235 /vars\n\t\
236 List the type, name, and value of the current active jshell variables\n\n\
237 /vars <name>\n\t\
238 List jshell variables with the specified name (preference for active variables)\n\n\
239 /vars <id>\n\t\
240 List the jshell variable with the specified snippet id\n\n\
241 /vars -start\n\t\
242 List the automatically added start-up jshell variables\n\n\
243 /vars -all\n\t\
244 List all jshell variables including failed, overwritten, dropped, and start-up
245
246 help.methods.summary = list the declared methods and their signatures
247 help.methods.args = [<name or id>|-all|-start]
248 help.methods =\
249 List the name, parameter types, and return type of jshell methods.\n\
250 \n\
251 /methods\n\t\
252 List the name, parameter types, and return type of the current active jshell methods\n\n\
253 /methods <name>\n\t\
254 List jshell methods with the specified name (preference for active methods)\n\n\
255 /methods <id>\n\t\
256 List the jshell method with the specified snippet id\n\n\
257 /methods -start\n\t\
258 List the automatically added start-up jshell methods\n\n\
259 /methods -all\n\t\
260 List all snippets including failed, overwritten, dropped, and start-up
261
262 help.types.summary = list the declared types
263 help.types.args =[<name or id>|-all|-start]
264 help.types =\
265 List jshell classes, interfaces, and enums.\n\
266 \n\
267 /types\n\t\
268 List the current active jshell classes, interfaces, and enums.\n\n\
269 /types <name>\n\t\
270 List jshell types with the specified name (preference for active types)\n\n\
271 /types <id>\n\t\
272 List the jshell type with the specified snippet id\n\n\
273 /types -start\n\t\
274 List the automatically added start-up jshell types\n\n\
275 /types -all\n\t\
276 List all jshell types including failed, overwritten, dropped, and start-up
277
278 help.imports.summary = list the imported items
279 help.imports.args =
280 help.imports =\
281 List the current active jshell imports.
282
283 help.exit.summary = exit jshell
284 help.exit.args =
285 help.exit =\
286 Leave the jshell tool. No work is saved.\n\
287 Save any work before using this command
288
289 help.reset.summary = reset jshell
290 help.reset.args =
291 help.reset =\
292 Reset the jshell tool code and execution state:\n\t\
293 * All entered code is lost.\n\t\
294 * Start-up code is re-executed.\n\t\
295 * The execution state is restarted.\n\t\
296 * The classpath is cleared.\n\
297 Tool settings are maintained, as set with: /set ...\n\
298 Save any work before using this command
299
300 help.reload.summary = reset and replay relevant history -- current or previous (-restore)
301 help.reload.args = [-restore] [-quiet]
302 help.reload =\
303 Reset the jshell tool code and execution state then replay each\n\
304 jshell valid command and valid snippet in the order they were entered.\n\
305 \n\
306 /reload\n\t\
307 Reset and replay the valid history since jshell was entered, or\n\t\
308 a /reset, or /reload command was executed -- whichever is most\n\t\
309 recent.\n\n\
310 /reload -restore\n\t\
311 Reset and replay the valid history between the previous and most\n\t\
312 recent time that jshell was entered, or a /reset, or /reload\n\t\
313 command was executed. This can thus be used to restore a previous\n\t\
314 jshell tool sesson.\n\n\
315 /reload [-restore] -quiet\n\t\
316 With the '-quiet' argument the replay is not shown. Errors will display.
317
318 help.classpath.summary = add a path to the classpath
319 help.classpath.args = <path>
320 help.classpath =\
321 Append a additional path to the classpath.
322
323 help.history.summary = history of what you have typed
324 help.history.args =
325 help.history =\
326 Display the history of snippet and command input since this jshell was launched.
327
328 help.debug.summary = toggle debugging of the jshell
329 help.debug.args = [0][r][g][f][c][d][e]
330 help.debug =\
331 Display debugging information for the jshell implementation.\n\
332 0: Debugging off\n\
333 r: Tool level debugging on\n\
334 g: General debugging on\n\
335 f: File manager debugging on\n\
336 c: Completion analysis debugging on\n\
337 d: Dependency debugging on\n\
338 e: Event debugging on
339
340 help.help.summary = get information about jshell
341 help.help.args = [<command>|<subject>]
342 help.help =\
343 Display information about jshell.\n\
344 /help\n\t\
345 List the jshell commands and help subjects.\n\n\
346 /help <command>\n\t\
347 Display information about the specified comand. The slash must be included.\n\t\
348 Only the first few letters of the command are needed -- if more than one\n\t\
349 each will be displayed. Example: /help /li\n\n\
350 /help <subject>\n\t\
351 Display information about the specified help subject. Example: /help intro
352
353 help.set.summary = set jshell configuration information
354 help.set.args = editor|start|feedback|mode|prompt|truncation|format ...
355 help.set =\
356 Set jshell configuration information, including:\n\
357 the external editor to use, the start-up definitions to use, a new feedback mode,\n\
358 the command prompt, the feedback mode to use, or the format of output.\n\
359 \n\
360 /set editor <command> <optional-arg>...\n\t\
361 Specify the command to launch for the /edit command.\n\t\
362 The <command> is an operating system dependent string.\n\n\
363 /set start <file>\n\t\
364 The contents of the specified <file> become the default start-up snippets and commands.\n\n\
365 /set feedback <mode>\n\t\
366 Set the feedback mode describing displayed feedback for entered snippets and commands.\n\n\
367 /set mode <mode> [<old-mode>] [-command|-quiet|-delete]\n\t\
368 Create or update a user-defined feedback mode, optionally copying from an existing mode.\n\n\
369 /set prompt <mode> "<prompt>" "<continuation-prompt>"\n\t\
370 Set the displayed prompts for a given feedback mode.\n\n\
371 /set truncation <mode> <length> <selector>...\n\t\
372 Set the maximum length of a displayed value\n\
373 /set format <mode> <field> "<format>" <selector>...\n\t\
374 Configure a feedback mode by setting the format of a field when the selector matchs.\n\n\
375 To get more information about one of these forms, use /help with the form specified.\n\
376 For example: /help /set format
377
378 help.retain.summary = retain jshell configuration information for subsequent sessions
379 help.retain.args = editor|start|feedback|mode
380 help.retain =\
381 Retain jshell configuration information for future invocations of the jshell tool,\n\
382 including: the external editor to use, the start-up definitions to use, the\n\
383 configuration of a feedback mode, or the feedback mode to use.\n\
384 \n\
385 /retain editor [<command> <optional-arg>...]\n\t\
386 Specify the command to launch for the /edit command.\n\t\
387 The <command> is an operating system dependent string.\n\n\
388 /retain start [<file>]\n\t\
389 The contents of the specified <file> become the default start-up snippets and commands.\n\n\
390 /retain feedback [<mode>]\n\t\
391 Set the feedback mode describing displayed feedback for entered snippets and commands.\n\n\
392 /retain mode <mode>\n\t\
393 Create a user-defined feedback mode, optionally copying from an existing mode.\n\n\
394 To get more information about one of these forms, use /help with the form specified.\n\
395 For example: /help /retain feedback
396
397 help.quest.summary = get information about jshell
398 help.quest.args = [<command>|<subject>]
399 help.quest =\
400 Display information about jshell (abbreviation for /help).\n\
401 /?\n\t\
402 Display list of commands and help subjects.\n\
403 /? <command>\n\t\
404 Display information about the specified comand. The slash must be included.\n\t\
405 Only the first few letters of the command are needed -- if more than one\n\t\
406 match, each will be displayed. Example: /? /li\n\
407 /? <subject>\n\t\
408 Display information about the specified help subject. Example: /? intro
409
410 help.bang.summary = re-run last snippet
411 help.bang.args =
412 help.bang =\
413 Reevaluate the most recently entered snippet.
414
415 help.id.summary = re-run snippet by id
416 help.id.args =
417 help.id =\
418 Reevaluate the snippet specified by the id.
419
420 help.previous.summary = re-run n-th previous snippet
421 help.previous.args =
422 help.previous =\
423 Reevaluate the n-th most recently entered snippet.
424
425 help.intro.summary = an introduction to the jshell tool
426 help.intro =\
427 The jshell tool allows you to execute Java code, getting immediate results.\n\
428 You can enter a Java definition (variable, method, class, etc), like: int x = 8\n\
429 or a Java expression, like: x + x\n\
430 or a Java statement or import.\n\
431 These little chunks of Java code are called 'snippets'.\n\
432 \n\
433 There are also jshell commands that allow you to understand and\n\
434 control what you are doing, like: /list\n\
435 \n\
436 For a list of commands: /help
437
438 help.shortcuts.summary = a description of shortcuts
439 help.shortcuts =\
440 Supported shortcuts include:\n\
441 \n\
442 <tab>\n\t\t\
443 After entering the first few letters of a Java identifier,\n\t\t\
444 a jshell command, or, in some cases, a jshell command argument,\n\t\t\
445 press the <tab> key to complete the input.\n\t\t\
446 If there is more than one completion, show possible completions.\n\n\
447 Shift-<tab>\n\t\t\
448 After the name and open parenthesis of a method or constructor invocation,\n\t\t\
449 hold the <shift> key and press the <tab> to see a synopsis of all\n\t\t\
450 matching methods/constructors.\n\n\
451 <fix-shortcut> v\n\t\t\
452 After a complete expression, press "<fix-shortcut> v" to introduce a new variable\n\t\t\
453 whose type is based on the type of the expression.\n\t\t\
454 The "<fix-shortcut>" is either Alt-F1 or Alt-Enter, depending on the platform.\n\n\
455 <fix-shortcut> i\n\t\t\
456 After an unresolvable identifier, press "<fix-shortcut> i" and jshell will propose\n\t\t\
457 possible fully qualified names based on the content of the specified classpath.\n\t\t\
458 The "<fix-shortcut>" is either Alt-F1 or Alt-Enter, depending on the platform.
459
460 help.set.format = \
461 Set the format for reporting a snippet event.\n\
462 \n\t\
463 /set format <mode> <field> "<format>" <selector>...\n\
464 \n\
465 Where <mode> is the name of a previously defined feedback mode -- see '/help /set mode'.\n\
466 Where <field> is the name of context-specific format to define.\n\
467 Where <format> is a quoted string which will be the value of the field if one of\n\
468 the selectors matches (or there are no selectors). When the format is used,\n\
469 field names enclosed in braces are replaced with the value of the field at that\n\
470 time. These fields may have been previously defined with this command or may be\n\
471 one of these predefined fields specific to the context:\n\t\
472 {name} == The name, e.g.: the variable name, ...\n\t\
473 {type} == The type name. The type of a variable or expression, the\n\t\t\t\
474 parameter types of a method\n\t\
475 {value} == The result value of an expression or variable initialization\n\t\
476 {unresolved} == The list of unresolved references\n\t\
477 {errors} == The list of recoverable errors (during the processing of the\n\t\t\t\
478 "display" field only)\n\t\
479 {err} == An unformatted error line (during the processing of the\n\t\t\t\
480 "errorline" field only)\n\
481 The following fields are accessed by the tool to determine the displayed feedback:\n\t\
482 {display} == The displayed message for a snippet event\n\t\
483 {errorline} == The format of one error line within the "errors" field\n\t\
484 {pre} == The feedback prefix (begins command feedback)\n\t\
485 {post} == The feedback postfix (ends command feedback)\n\t\
486 {errorpre} == The error prefix (begins error feedback)\n\t\
487 {errorpost} == The error postfix (ends error feedback)\n\
488 These fields have default settings (which may be overwritten).\n\
489 Where <selector> is the context in which the format is applied.\n\
490 The structure of selector is a hyphen separated list of selector kind lists.\n\
491 A selector kind list is a comma separated list of values of one selector kind.\n\
492 A selector matches if each selector kind list matches; A selector kind list\n\
493 matches if one of the values matches.\n\n\
494 The case selector kind describes the kind of snippet. The values are:\n\t\
495 import -- import declaration\n\t\
496 class -- class declaration\n\t\
497 interface -- interface declaration\n\t\
498 enum -- enum declaration\n\t\
499 annotation -- annotation interface declaration\n\t\
500 method -- method declaration -- note: {type}==parameter-types\n\t\
501 vardecl -- variable declaration without init\n\t\
502 varinit -- variable declaration with init\n\t\
503 expression -- expression -- note: {name}==scratch-variable-name\n\t\
504 varvalue -- variable value expression\n\t\
505 assignment -- assign variable\n\t\
506 statement -- statement\n\
507 The action selector kind describes what happened to the snippet. The values are:\n\t\
508 added -- snippet has been added\n\t\
509 modified -- an existing snippet has been modified\n\t\
510 replaced -- an existing snippet has been replaced with a new snippet\n\t\
511 overwrote -- an existing snippet has been overwritten\n\t\
512 dropped -- snippet has been dropped\n\t\
513 used -- snippet was used when it cannot be\n\
514 The when-did-it-occur selector kind describes if this is a direct or indirect action. The values are:\n\t\
515 primary -- the entered snippet\n\t\
516 update -- an update to a dependent snippet\n\
517 The resolution-state selector kind describes the state of resolution/definition of the snippet. The values are:\n\t\
518 ok -- resolved correctly\n\t\
519 defined -- defined despite recoverably unresolved references\n\t\
520 notdefined -- not defined because of recoverably unresolved references\n\
521 The unresolved-count selector kind describes the number of unresolved references. The values are:\n\t\
522 unresolved0 -- no names are unresolved\n\t\
523 unresolved1 -- one name is unresolved\n\t\
524 unresolved2 -- two or more names are unresolved\n\
525 The errors-count selector kind describes the number of errors. The values are:\n\t\
526 error0 -- no errors\n\t\
527 error1 -- one error\n\t\
528 error2 -- two or more errors\n\n\
529 Examples:\n\t\
530 /set format myformat action 'Created' added-primary\n\t\
531 /set format myformat action 'Update replaced' replaced-update\n\t\
532 /set format myformat display '{pre}{action} class {name}{post}' class-ok\n\t\
533 /set format myformat display '{pre}{action} variable {name}, reset to null{post}' replaced-vardecl,varinit-ok-update\n\n\
534 Note that subsequent selectors for a field may overwrite some or all of previous used selectors -- last one wins\n
535
536 help.set.truncation = \
537 Set the max length a displayed value.\n\
538 \n\t\
539 /set truncation <mode> <length> <selector>...\n\
540 \n\
541 Where <mode> is the name of a previously defined feedback mode -- see '/help /set mode'.\n\
542 Where <length> is an unsigned integer representing a maximum length.\n\
543 Where <format> is a quoted string which will be the value of the field if one of\n\
544 Where <selector> is only needed if you wish to fine-tune value truncation length\n\
545 by context, <selector> is the context in which the truncation is applied.\n\
546 The structure of selector is a hyphen separated list of selector kind lists.\n\
547 A selector kind list is a comma separated list of values of one selector kind.\n\
548 A selector matches if each selector kind list matches; A selector kind list\n\
549 matches if one of the values matches.\n\n\
550 Below are the relevant selector kinds for truncation.\n\n\
551 The case selector kind describes the kind of snippet. The values are:\n\t\
552 vardecl -- variable declaration without init\n\t\
553 varinit -- variable declaration with init\n\t\
554 expression -- expression -- note: {name}==scratch-variable-name\n\t\
555 varvalue -- variable value expression\n\t\
556 assignment -- assign variable\n\t\
557 The action selector kind describes what happened to the snippet. The values are:\n\t\
558 added -- snippet has been added\n\t\
559 modified -- an existing snippet has been modified\n\t\
560 replaced -- an existing snippet has been replaced with a new snippet\n\
561 Examples:\n\t\
562 /set trunc mymode 80\n\t\
563 /set truncation mymode 45 expression\n\t\
564 /set truncation mymode 0 vardecl-modified,replaced\n\n\
565 Note that subsequent selectors for a field may overwrite some or all of previous used selectors -- last one wins\n
566
567 help.set.feedback = \
568 Set the feedback mode describing displayed feedback for entered snippets and commands.\n\
569 \n\t\
570 /set feedback <mode>\n\
571 \n\
572 Where <mode> is the name of a previously defined feedback mode.\n\
573 You may use just enough letters to make it unique.\n\
574 User-defined modes can be added, see '/help /set mode'\n\
575 Currently defined feedback modes:\n
576
577 help.set.mode = \
578 Create a user-defined feedback mode, optionally copying from an existing mode.\n\
579 \n\t\
580 /set mode <mode> [<old-mode>] [-command|-quiet|-delete]\n\
581 \n\
582 Where <new-mode> is the name of a mode you wish to create.\n\
583 Where <old-mode> is the name of a previously defined feedback mode.\n\
584 If <old-mode> is present, its settings are copied to the new mode.\n\
585 '-command' vs '-quiet' determines if informative/verifying command feedback is displayed.\n\
586 \n\
587 Once the new mode is created, use '/set format' and '/set prompt' to configure it.\n\
588 Use '/set feedback' to use the new mode.\n\
589
590 help.set.prompt = \
591 Set the prompts. Both the normal prompt and the continuation-prompt must be set.\n\
592 \n\t\
593 /set prompt <mode> \"<prompt>\" \"<continuation-prompt>\"\n\
594 \n\
595 Where <mode> is the name of a previously defined feedback mode.\n\
596 Where <prompt> and <continuation-prompt> are quoted strings printed as input prompts;\n\
597 Both may optionally contain '%s' which will be substituted with the next snippet id --\n\
598 note that what is entered may not be assigned that id, for example it may be an error or command.\n\
599 The continuation-prompt is used on the second and subsequent lines of a multi-line snippet.\n
600
601 help.set.editor =\
602 Specify the command to launch for the /edit command.\n\
603 \n\t\
604 /set editor <command>|-default\n\
605 \n\
606 The <command> is an operating system dependent string.\n\
607 The <command> may include space-separated arguments (such as flags)\n\
608 When /edit is used, the temporary file to edit will be appended as the last argument.\n\
609 If instead the -default option is specified, the built-in default editor will be used.
610
611 help.set.start =\
612 Set the start-up configuration -- a sequence of snippets and commands read at start-up.\n\
613 \n\t\
614 /set start <file>|-default|-none\n\
615 \n\
616 The contents of the specified <file> become the start-up snippets and commands used\n\
617 when the /reset or /reload commands are used in this session.\n\
618 If instead the -default option is specified, the predefined start-up snippets\n\
619 will be used.\n\
620 If the -none option is used, the start-up will be empty -- no start-up snippets\n\
621 or commands will be used.\n\
622 This command is good for testing the start-up settings. To retain them for future\n\
623 runs of the jshell tool use the command:\n\t\
624 /retain start\n
625
626 help.retain.feedback = \
627 Retain which feedback mode to use for displayed feedback for entered snippets and commands.\n\
628 This feedback mode will be used in this and future sessions of the jshell tool.\n\
629 \n\t\
630 /retain feedback [<mode>]\n\
631 \n\
632 Where <mode> is the name of a previously defined feedback mode.\n\
633 You may use just enough letters to make it unique.\n\
634 If the <mode> is not specified, this command retains the current mode (as set\n\
635 with the most recent /set feedback or /retain feedback command.)\n\
636
637 help.retain.mode = \
638 Retain the existence and configuration of a user-defined feedback mode.\n\
639 This mode will be available in this and future sessions of the jshell tool.
640 \n\t\
641 /retain mode <mode>\n\
642 \n\
643 Where <mode> is the name of a mode you wish to retain.\n\
644 The <mode> must previously have been created with /set mode and\n\
645 configured as desired with /set prompt, /set format, and /set truncation.\n
646
647 help.retain.editor =\
648 Retain the command to launch for the /edit command. This command will be invoked when\n\
649 the /edit command is used in this and future sessions of the jshell tool.\n\
650 \n\t\
651 /retain editor [<command>|-default]\n\
652 \n\
653 If <command> is specified, it is an operating system dependent string which\n\
654 may include space-separated arguments (such as flags). When /edit is used, the\n\
655 temporary file to edit will be appended as the last argument.\n\
656 If instead the -default option is specified, the built-in default editor will be used.\n\
657 If neither is specified, the editor set in the last /set editor or /retain editor\n\
658 command will be used.\n\
659 The editor will be retained and used in this and future runs of the jshell tool.
660
661 help.retain.start =\
662 Retain the start-up configuration -- a sequence of snippets and commands read\n\
663 at start-up.\n\
664 \n\t\
665 /retain start [<file>|-default|-none]\n\
666 \n\
667 If <file> is specified, the contents of the specified <file> become the\n\
668 start-up snippets\n\
669 and commands.\n\
670 If instead the -default option is specified, the predefined start-up snippets\n\
671 will be the start-up.\n\
672 If the -none option is used, the start-up will be empty -- no start-up snippets\n\
673 or commands will be used.\n\
674 If none of these is specified, the start-up is the last specified in a\n\
675 ''/set start'' or ''/retain start'' command.\n\
676 The start-up will be retained and used when the jshell tool is started or reset
677
678 startup.feedback = \
679 /set mode verbose -command \n\
680 \n\
681 /set prompt verbose '\\njshell> ' ' ...> ' \n\
682 \n\
683 /set format verbose pre '| ' \n\
684 /set format verbose post '%n' \n\
685 /set format verbose errorpre '| ' \n\
686 /set format verbose errorpost '%n' \n\
687 \n\
688 /set format verbose errorline '{post}{pre} {err}' \n\
689 \n\
690 /set format verbose action 'created' added-primary \n\
691 /set format verbose action 'modified' modified-primary \n\
692 /set format verbose action 'replaced' replaced-primary \n\
693 /set format verbose action 'overwrote' overwrote-primary \n\
694 /set format verbose action 'dropped' dropped-primary \n\
695 /set format verbose action ' update created' added-update \n\
696 /set format verbose action ' update modified' modified-update \n\
697 /set format verbose action ' update replaced' replaced-update \n\
698 /set format verbose action ' update overwrote' overwrote-update \n\
699 /set format verbose action ' update dropped' dropped-update \n\
700 \n\
701 /set format verbose until ', however, it cannot be instanciated or its methods invoked until' defined-class-primary \n\
702 /set format verbose until ', however, its methods cannot be invoked until' defined-interface-primary \n\
703 /set format verbose until ', however, it cannot be used until' defined-enum,annotation-primary \n\
704 /set format verbose until ', however, it cannot be invoked until' defined-method-primary \n\
705 /set format verbose until ', however, it cannot be referenced until' notdefined-primary \n\
706 /set format verbose until ' which cannot be instanciated or its methods invoked until' defined-class-update \n\
707 /set format verbose until ' whose methods cannot be invoked until' defined-interface-update \n\
708 /set format verbose until ' which cannot be invoked until' defined-method-update \n\
709 /set format verbose until ' which cannot be referenced until' notdefined-update \n\
710 \n\
711 /set format verbose unrerr '{unresolved} is declared' unresolved1-error0 \n\
712 /set format verbose unrerr '{unresolved} are declared' unresolved2-error0 \n\
713 /set format verbose unrerr ' this error is corrected: {errors}' unresolved0-error1 \n\
714 /set format verbose unrerr '{unresolved} is declared and this error is corrected: {errors}' unresolved1-error1 \n\
715 /set format verbose unrerr '{unresolved} are declared and this error is corrected: {errors}' unresolved2-error1 \n\
716 /set format verbose unrerr ' these errors are corrected: {errors}' unresolved0-error2 \n\
717 /set format verbose unrerr '{unresolved} is declared and these errors are corrected: {errors}' unresolved1-error2 \n\
718 /set format verbose unrerr '{unresolved} are declared and these errors are corrected: {errors}' unresolved2-error2 \n\
719 \n\
720 /set format verbose resolve '{until}{unrerr}' added,modified,replaced,used \n\
721 \n\
722 /set format verbose typeKind 'class' class \n\
723 /set format verbose typeKind 'interface' interface \n\
724 /set format verbose typeKind 'enum' enum \n\
725 /set format verbose typeKind 'annotation interface' annotation \n\
726 \n\
727 /set format verbose result '{name} ==> {value}{post}' added,modified,replaced-ok-primary \n\
728 \n\
729 /set format verbose display '{result}{pre}created scratch variable {name} : {type}{post}' expression-added,modified,replaced-primary \n\
730 /set format verbose display '{result}{pre}value of {name} : {type}{post}' varvalue-primary \n\
731 /set format verbose display '{result}{pre}assigned to {name} : {type}{post}' assignment-primary \n\
732 /set format verbose display '{result}{pre}{action} variable {name} : {type}{resolve}{post}' varinit,vardecl \n\
733 /set format verbose display '{pre}{action} variable {name}{resolve}{post}' vardecl,varinit-notdefined \n\
734 /set format verbose display '{pre}{action} variable {name}{post}' dropped-vardecl,varinit,expression \n\
735 /set format verbose display '{pre}{action} variable {name}, reset to null{post}' replaced-vardecl,varinit-ok-update \n\
736 \n\
737 /set format verbose display '{pre}{action} {typeKind} {name}{resolve}{post}' class,interface,enum,annotation \n\
738 /set format verbose display '{pre}{action} method {name}({type}){resolve}{post}' method \n\
739 \n\
740 /set format verbose display '{pre}attempted to use {typeKind} {name}{resolve}{post}' used-class,interface,enum,annotation \n\
741 /set format verbose display '{pre}attempted to call method {name}({type}){resolve}{post}' used-method \n\
742 \n\
743 /set truncation verbose 80\n\
744 /set truncation verbose 1000 varvalue,expression\n\
745 \n\
746 /set mode normal -command verbose \n\
747 /set format normal display '' added,modified,replaced,overwrote,dropped-update \n\
748 /set format normal display '{pre}{action} variable {name}, reset to null{post}' replaced-vardecl,varinit-ok-update \n\
749 /set format normal display '{result}' added,modified,replaced-expression,varvalue,assignment,varinit,vardecl-ok-primary \n\
750 /set mode concise -quiet normal \n\
751 \n\
752 /set prompt concise 'jshell> ' ' ...> ' \n\
753 \n\
754 /set format concise display '' class,interface,enum,annotation,method,assignment,varinit,vardecl-ok \n\
755 \n\
756 /set feedback normal \n\
757 \n\
758 /set mode silent -quiet \n\
759 /set prompt silent '-> ' '>> ' \n\
760 /set format silent pre '| ' \n\
761 /set format silent post '%n' \n\
762 /set format silent errorpre '| ' \n\
763 /set format silent errorpost '%n' \n\
764 /set format silent display '' \n