1 #
2 # Copyright (c) 2016, 2017, 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
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.conflict = Conflicting options: both --startup and --no-startup were used.
33 jshell.err.opt.feedback.one = Only one feedback option (--feedback, -q, -s, or -v) may be used.
34 jshell.err.opt.unknown = Unknown option: {0}
35
36 jshell.msg.terminated =\
37 State engine terminated.\n\
38 Restore definitions with: /reload -restore
39
40 jshell.msg.use.one.of = Use one of: {0}
41 jshell.msg.see.classes.etc = See /types, /methods, /vars, or /list
42 jshell.err.arg = Invalid ''{0}'' argument: {1}
43 jshell.msg.see = See {0} for help.
44
45 jshell.err.file.not.accessible = File ''{1}'' for ''{0}'' is not accessible: {2}
46 jshell.err.file.not.found = File ''{1}'' for ''{0}'' is not found.
47 jshell.err.file.exception = File ''{1}'' for ''{0}'' threw exception: {2}
48 jshell.err.file.filename = ''{0}'' requires a filename argument.
49
50 jshell.err.startup.unexpected.exception = Unexpected exception reading start-up: {0}
51 jshell.err.unexpected.exception = Unexpected exception: {0}
52
53 jshell.err.no.such.command.or.snippet.id = No such command or snippet id: {0}
54 jshell.err.command.ambiguous = Command: ''{0}'' is ambiguous: {1}
55 jshell.msg.set.restore = Setting new options and restoring state.
56 jshell.msg.set.editor.set = Editor set to: {0}
57 jshell.msg.set.editor.retain = Editor setting retained: {0}
58 jshell.err.no.builtin.editor = Built-in editor not available.
59 jshell.err.cant.launch.editor = Cannot launch built-in editor -- unexpected exception: {0}
60 jshell.msg.try.set.editor = See ''/help /set editor'' to use external editor.
61 jshell.msg.press.return.to.leave.edit.mode = Press return to leave edit mode.
62 jshell.err.wait.applies.to.external.editor = -wait applies to external editors
63 jshell.label.editpad = JShell Edit Pad
64
65 jshell.err.setting.to.retain.must.be.specified = The setting to retain must be specified -- {0}
66 jshell.msg.set.show.mode.settings = \nTo show mode settings use ''/set prompt'', ''/set truncation'', ...\n\
67 or use ''/set mode'' followed by the feedback mode name.
68 jshell.err.continuation.prompt.required = Continuation prompt required -- {0}
69
70 jshell.msg.try.command.without.args = Try ''{0}'' without arguments.
71 jshell.msg.no.active = There are no active definitions.
72
73 jshell.msg.resetting = Resetting...
74 jshell.msg.resetting.state = Resetting state.
75
76 jshell.err.reload.no.previous = No previous history to restore
77 jshell.err.reload.restarting.previous.state = Restarting and restoring from previous state.
78 jshell.err.reload.restarting.state = Restarting and restoring state.
79
80 jshell.err.restart.failed = Restart failed: {0}\n\n\
81 Reverting to previous settings and restarting...
82
83 jshell.msg.vars.not.active = (not-active)
84
85 jshell.err.out.of.range = Out of range
86
87 jshell.msg.error = Error:
88 jshell.msg.warning = Warning:
89
90 jshell.err.sub.arg = The ''{0}'' command requires a sub-command. See: ''/help {0}''
91 jshell.err.sub.ambiguous = Ambiguous sub-command argument to ''{0}'': {1}
92
93 jshell.err.classpath.arg = The /classpath command requires a path argument.
94 jshell.msg.classpath = Path ''{0}'' added to classpath
95
96 jshell.err.help.arg = No commands or subjects start with the provided argument: {0}
97 jshell.msg.help.begin =\
98 Type a Java language expression, statement, or declaration.\n\
99 Or type one of the following commands:\n
100 jshell.msg.help.subject =\n\
101 For more information type ''/help'' followed by the name of a\n\
102 command or a subject.\n\
103 For example ''/help /list'' or ''/help intro''.\n\
104 \n\
105 Subjects:\n\
106 \n
107
108 jshell.err.drop.arg =\
109 In the /drop argument, please specify an import, variable, method, or class to drop.\n\
110 Specify by id or name. Use /list to see ids. Use /reset to reset all state.
111 jshell.err.drop.ambiguous = The argument references more than one import, variable, method, or class.
112 jshell.err.failed = Failed.
113 jshell.msg.native.method = Native Method
114 jshell.msg.unknown.source = Unknown Source
115 jshell.msg.goodbye = Goodbye
116
117 jshell.msg.help.for.help = Type /help for help.
118
119 jshell.err.mode.name = Expected a feedback mode name: {0}
120 jshell.err.missing.mode = Missing the feedback mode -- {0}
121 jshell.err.field.name = Expected a field name: {0} -- {1}
122 jshell.err.mode.unknown = No feedback mode named: {0} -- {1}
123
124 jshell.err.feedback.does.not.match.mode = Does not match any current feedback mode: {0} -- {1}
125 jshell.err.feedback.ambiguous.mode = Matches more then one current feedback mode: {0} -- {1}
126 jshell.err.feedback.must.be.quoted = Format ''{0}'' must be quoted -- {1}
127 jshell.err.feedback.not.a.valid.selector = Not a valid selector ''{0}'' in ''{1}'' -- {2}
128 jshell.err.feedback.multiple.sections = Selector kind in multiple sections of selector list ''{0}'' in ''{1}'' -- {2}
129 jshell.err.feedback.different.selector.kinds = Different selector kinds in same sections of selector list ''{0}'' in ''{1}'' -- {2}
130
131 jshell.msg.feedback.new.mode = Created new feedback mode: {0}
132 jshell.msg.feedback.mode = Feedback mode: {0}
133 jshell.msg.feedback.mode.following = Available feedback modes:
134 jshell.msg.feedback.retained.mode.following = Retained feedback modes:
135 jshell.err.mode.creation = To create a new mode either the -command or the -quiet option must be used -- {0}
136 jshell.err.mode.exists = Mode to be created already exists: {0} -- {1}
137
138 jshell.err.truncation.expected.length = Expected truncation length -- {0}
139 jshell.err.truncation.length.not.integer = Truncation length must be an integer: {0} -- {1}
140
141 jshell.err.not.valid.with.predefined.mode = Not valid with a predefined mode: {0} -- {1}
142 jshell.err.retained.feedback.mode.must.be.retained.or.predefined = \
143 ''/set feedback -retain <mode>'' requires that <mode> is predefined or has been retained with ''/set mode -retain'' -- {0}
144
145 jshell.err.unknown.option = Unknown option: {0} -- {1}
146 jshell.err.default.option.or.program = Specify -default option, -delete option, or program -- {0}
147 jshell.err.option.or.filename = Specify no more than one of -default, -none, or a startup file name -- {0}
148 jshell.err.unexpected.at.end = Unexpected arguments at end of command: {0} -- {1}
149 jshell.err.conflicting.options = Conflicting options -- {0}
150 jshell.err.cannot.delete.current.mode = The current feedback mode ''{0}'' cannot be deleted, use ''/set feedback'' first -- {1}
151 jshell.err.cannot.delete.retained.mode = The retained feedback mode ''{0}'' cannot be deleted, use ''/set feedback -retain'' first -- {1}
152 jshell.err.may.not.specify.options.and.snippets = Options and snippets must not both be used: {0}
153 jshell.err.no.such.snippets = No such snippet: {0}
154 jshell.err.the.snippet.cannot.be.used.with.this.command = This command does not accept the snippet ''{0}'' : {1}
155 jshell.err.retained.mode.failure = Failure in retained modes (modes cleared) -- {0} {1}
156
157 jshell.err.corrupted.stored.startup = Corrupted stored startup, using default -- {0}
158
159 jshell.console.see.synopsis = <press tab again to see synopsis>
160 jshell.console.see.full.documentation = <press tab again to see full documentation>
161 jshell.console.see.documentation = <press tab again to see documentation>
162 jshell.console.see.next.page = <press tab again to see next page>
163 jshell.console.see.next.javadoc = <press tab to see next documentation>
164 jshell.console.see.next.command.doc = <press tab to see next command>
165 jshell.console.no.such.command = No such command
166 jshell.console.completion.current.signatures = Signatures:
167 jshell.console.completion.all.completions.number = <press tab again to see all possible completions; total possible completions: {0}>
168 jshell.console.completion.all.completions = <press tab again to see all possible completions>
169 jshell.console.no.javadoc = <no documentation found>
170 jshell.console.do.nothing = Do nothing
171 jshell.console.choice = Choice: \
172
173 jshell.console.create.variable = Create variable
174 jshell.console.resolvable = \nThe identifier is resolvable in this context.
175 jshell.console.no.candidate = \nNo candidate fully qualified names found to import.
176 jshell.console.incomplete = \nResults may be incomplete; try again later for complete results.
177
178
179 help.usage = \
180 Usage: jshell <options> <load files>\n\
181 where possible options include:\n\
182 \ --class-path <path> Specify where to find user class files\n\
183 \ --module-path <path> Specify where to find application modules\n\
184 \ --add-modules <module>(,<module>)*\n\
185 \ Specify modules to resolve, or all modules on the\n\
186 \ module path if <module> is ALL-MODULE-PATHs\n\
187 \ --startup <file> One run replacement for the start-up definitions\n\
188 \ --no-startup Do not run the start-up definitions\n\
189 \ --feedback <mode> Specify the initial feedback mode. The mode may be\n\
190 \ predefined (silent, concise, normal, or verbose) or\n\
191 \ previously user-defined\n\
192 \ -q Quiet feedback. Same as: --feedback concise\n\
193 \ -s Really quiet feedback. Same as: --feedback silent\n\
194 \ -v Verbose feedback. Same as: --feedback verbose\n\
195 \ -J<flag> Pass <flag> directly to the runtime system.\n\
196 \ Use one -J for each runtime flag or flag argument\n\
197 \ -R<flag> Pass <flag> to the remote runtime system.\n\
198 \ Use one -R for each remote flag or flag argument\n\
199 \ -C<flag> Pass <flag> to the compiler.\n\
200 \ Use one -C for each compiler flag or flag argument\n\
201 \ --version Print version information and exit\n\
202 \ --show-version Print version information and continue\n\
203 \ --help Print this synopsis of standard options and exit\n\
204 \ --help-extra, -X Print help on non-standard options and exit\n
205 help.usage.x = \
206 \ --add-exports <module>/<package> Export specified module-private package to snippets\n\
207 \ --execution <spec> Specify an alternate execution engine.\n\
208 \ Where <spec> is an ExecutionControl spec.\n\
209 \ See the documentation of the package\n\
210 \ jdk.jshell.spi for the syntax of the spec\n\
211 \ \n\
212 \These options are non-standard and subject to change without notice.\n
213
214 help.list.summary = list the source you have typed
215 help.list.args = [<name or id>|-all|-start]
216 help.list =\
217 Show the source of snippets, prefaced with the snippet id.\n\
218 \n\
219 /list\n\t\
220 List the currently active snippets of code that you typed or read with /open\n\n\
221 /list -start\n\t\
222 List the automatically evaluated start-up snippets\n\n\
223 /list -all\n\t\
224 List all snippets including failed, overwritten, dropped, and start-up\n\n\
225 /list <name>\n\t\
226 List snippets with the specified name (preference for active snippets)\n\n\
227 /list <id>\n\t\
228 List the snippet with the specified snippet id
229
230 help.edit.summary = edit a source entry referenced by name or id
231 help.edit.args = <name or id>
232 help.edit =\
233 Edit a snippet or snippets of source in an external editor.\n\
234 The editor to use is set with /set editor.\n\
235 If no editor has been set, a simple editor will be launched.\n\
236 \n\
237 /edit <name>\n\t\
238 Edit the snippet or snippets with the specified name (preference for active snippets)\n\n\
239 /edit <id>\n\t\
240 Edit the snippet with the specified snippet id\n\n\
241 /edit\n\t\
242 Edit the currently active snippets of code that you typed or read with /open
243
244 help.drop.summary = delete a source entry referenced by name or id
245 help.drop.args = <name or id>
246 help.drop =\
247 Drop a snippet -- making it inactive.\n\
248 \n\
249 /drop <name>\n\t\
250 Drop the snippet with the specified name\n\n\
251 /drop <id>\n\t\
252 Drop the snippet with the specified snippet id
253
254 help.save.summary = Save snippet source to a file.
255 help.save.args = [-all|-history|-start] <file>
256 help.save =\
257 Save the specified snippets and/or commands to the specified file.\n\
258 \n\
259 /save <file>\n\t\
260 Save the source of current active snippets to the file.\n\n\
261 /save -all <file>\n\t\
262 Save the source of all snippets to the file.\n\t\
263 Includes source including overwritten, failed, and start-up code.\n\n\
264 /save -history <file>\n\t\
265 Save the sequential history of all commands and snippets entered since jshell was launched.\n\n\
266 /save -start <file>\n\t\
267 Save the default start-up definitions to the file.
268
269 help.open.summary = open a file as source input
270 help.open.args = <file>
271 help.open =\
272 Open a file and read its contents as snippets and commands.\n\
273 \n\
274 /open <file>\n\t\
275 Read the specified file as jshell input.
276
277 help.vars.summary = list the declared variables and their values
278 help.vars.args = [<name or id>|-all|-start]
279 help.vars =\
280 List the type, name, and value of jshell variables.\n\
281 \n\
282 /vars\n\t\
283 List the type, name, and value of the current active jshell variables\n\n\
284 /vars <name>\n\t\
285 List jshell variables with the specified name (preference for active variables)\n\n\
286 /vars <id>\n\t\
287 List the jshell variable with the specified snippet id\n\n\
288 /vars -start\n\t\
289 List the automatically added start-up jshell variables\n\n\
290 /vars -all\n\t\
291 List all jshell variables including failed, overwritten, dropped, and start-up
292
293 help.methods.summary = list the declared methods and their signatures
294 help.methods.args = [<name or id>|-all|-start]
295 help.methods =\
296 List the name, parameter types, and return type of jshell methods.\n\
297 \n\
298 /methods\n\t\
299 List the name, parameter types, and return type of the current active jshell methods\n\n\
300 /methods <name>\n\t\
301 List jshell methods with the specified name (preference for active methods)\n\n\
302 /methods <id>\n\t\
303 List the jshell method with the specified snippet id\n\n\
304 /methods -start\n\t\
305 List the automatically added start-up jshell methods\n\n\
306 /methods -all\n\t\
307 List all snippets including failed, overwritten, dropped, and start-up
308
309 help.types.summary = list the declared types
310 help.types.args =[<name or id>|-all|-start]
311 help.types =\
312 List jshell classes, interfaces, and enums.\n\
313 \n\
314 /types\n\t\
315 List the current active jshell classes, interfaces, and enums.\n\n\
316 /types <name>\n\t\
317 List jshell types with the specified name (preference for active types)\n\n\
318 /types <id>\n\t\
319 List the jshell type with the specified snippet id\n\n\
320 /types -start\n\t\
321 List the automatically added start-up jshell types\n\n\
322 /types -all\n\t\
323 List all jshell types including failed, overwritten, dropped, and start-up
324
325 help.imports.summary = list the imported items
326 help.imports.args =
327 help.imports =\
328 List the current active jshell imports.
329
330 help.exit.summary = exit jshell
331 help.exit.args =
332 help.exit =\
333 Leave the jshell tool. No work is saved.\n\
334 Save any work before using this command
335
336 help.reset.summary = reset jshell
337 help.reset.args = \
338 [-class-path <path>] [-module-path <path>] [-add-modules <modules>]...
339 help.reset =\
340 Reset the jshell tool code and execution state:\n\t\
341 * All entered code is lost.\n\t\
342 * Start-up code is re-executed.\n\t\
343 * The execution state is restarted.\n\t\
344 Tool settings are maintained, as set with: /set ...\n\
345 Save any work before using this command.\n\
346 The /reset command accepts context options, see:\n\n\t\
347 /help context\n\
348
349
350 help.reload.summary = reset and replay relevant history -- current or previous (-restore)
351 help.reload.args = \
352 [-restore] [-quiet] [-class-path <path>] [-module-path <path>]...
353 help.reload =\
354 Reset the jshell tool code and execution state then replay each valid snippet\n\
355 and any /drop commands in the order they were entered.\n\
356 \n\
357 /reload\n\t\
358 Reset and replay the valid history since jshell was entered, or\n\t\
359 a /reset, or /reload command was executed -- whichever is most\n\t\
360 recent.\n\n\
361 /reload -restore\n\t\
362 Reset and replay the valid history between the previous and most\n\t\
363 recent time that jshell was entered, or a /reset, or /reload\n\t\
364 command was executed. This can thus be used to restore a previous\n\t\
365 jshell tool session.\n\n\
366 /reload [-restore] -quiet\n\t\
367 With the '-quiet' argument the replay is not shown. Errors will display.\n\
368 \n\
369 Each of the above accepts context options, see:\n\n\t\
370 /help context\n\
371 \n\
372 For example:\n\n\t\
373 /reload -add-modules com.greetings -restore
374
375 help.env.summary = view or change the evaluation context
376 help.env.args = \
377 [-class-path <path>] [-module-path <path>] [-add-modules <modules>] ...
378 help.env =\
379 View or change the evaluation context. The evaluation context is the class path,\n\
380 module path, etc.\n\
381 /env\n\t\
382 Show the evaluation context displayed as context options.\n\n\
383 /env [-class-path <path>] [-module-path <path>] [-add-modules <modules>] ...\n\t\
384 With at least one option set, sets the evaluation context. If snippets\n\t\
385 have been defined, the execution state is reset with the new\n\t\
386 evaluation context and the snippets will be replayed -- the replay is not\n\t\
387 shown, however, errors will display. This is equivalent to: /reload -quiet\n\t\
388 For details of context options, see:\n\n\t\t\
389 /help context\n\n\t\
390 For example:\n\n\t\t\
391 /env -add-modules com.greetings
392
393 help.history.summary = history of what you have typed
394 help.history.args =
395 help.history =\
396 Display the history of snippet and command input since this jshell was launched.
397
398 help.debug.summary = toggle debugging of the jshell
399 help.debug.args = [0][r][g][f][c][d][e]
400 help.debug =\
401 Display debugging information for the jshell implementation.\n\
402 0: Debugging off\n\
403 r: Tool level debugging on\n\
404 g: General debugging on\n\
405 f: File manager debugging on\n\
406 c: Completion analysis debugging on\n\
407 d: Dependency debugging on\n\
408 e: Event debugging on
409
410 help.help.summary = get information about jshell
411 help.help.args = [<command>|<subject>]
412 help.help =\
413 Display information about jshell.\n\
414 /help\n\t\
415 List the jshell commands and help subjects.\n\n\
416 /help <command>\n\t\
417 Display information about the specified command. The slash must be included.\n\t\
418 Only the first few letters of the command are needed -- if more than one\n\t\
419 each will be displayed. Example: /help /li\n\n\
420 /help <subject>\n\t\
421 Display information about the specified help subject. Example: /help intro
422
423 help.set.summary = set jshell configuration information
424 help.set.args = editor|start|feedback|mode|prompt|truncation|format ...
425 help.set =\
426 Set jshell configuration information, including:\n\
427 the external editor to use, the start-up definitions to use, a new feedback mode,\n\
428 the command prompt, the feedback mode to use, or the format of output.\n\
429 \n\
430 /set editor [-wait] <command> <optional-arg>...\n\t\
431 Specify the command to launch for the /edit command.\n\t\
432 The <command> is an operating system dependent string.\n\n\
433 /set start <file>\n\t\
434 The contents of the specified <file> become the default start-up snippets and commands.\n\n\
435 /set feedback <mode>\n\t\
436 Set the feedback mode describing displayed feedback for entered snippets and commands.\n\n\
437 /set mode <mode> [<old-mode>] -command|-quiet|-delete\n\t\
438 Create or update a user-defined feedback mode, optionally copying from an existing mode.\n\n\
439 /set prompt <mode> "<prompt>" "<continuation-prompt>"\n\t\
440 Set the displayed prompts for a given feedback mode.\n\n\
441 /set truncation <mode> <length> <selector>...\n\t\
442 Set the maximum length of a displayed value.\n\n\
443 /set format <mode> <field> "<format>" <selector>...\n\t\
444 Configure a feedback mode by setting the format of a field when the selector matches.\n\n\
445 /set\n\t\
446 Show editor, start, and feedback settings as /set commands.\n\t\
447 To show the settings of any of the above, omit the set value.\n\n\
448 To get more information about one of these forms, use /help with the form specified.\n\
449 For example: /help /set format
450
451 help.quest.summary = get information about jshell
452 help.quest.args = [<command>|<subject>]
453 help.quest =\
454 Display information about jshell (abbreviation for /help).\n\
455 /?\n\t\
456 Display list of commands and help subjects.\n\
457 /? <command>\n\t\
458 Display information about the specified command. The slash must be included.\n\t\
459 Only the first few letters of the command are needed -- if more than one\n\t\
460 match, each will be displayed. Example: /? /li\n\
461 /? <subject>\n\t\
462 Display information about the specified help subject. Example: /? intro
463
464 help.bang.summary = re-run last snippet
465 help.bang.args =
466 help.bang =\
467 Reevaluate the most recently entered snippet.
468
469 help.id.summary = re-run snippet by id
470 help.id.args =
471 help.id =\
472 Reevaluate the snippet specified by the id.
473
474 help.previous.summary = re-run n-th previous snippet
475 help.previous.args =
476 help.previous =\
477 Reevaluate the n-th most recently entered snippet.
478
479 help.intro.summary = an introduction to the jshell tool
480 help.intro =\
481 The jshell tool allows you to execute Java code, getting immediate results.\n\
482 You can enter a Java definition (variable, method, class, etc), like: int x = 8\n\
483 or a Java expression, like: x + x\n\
484 or a Java statement or import.\n\
485 These little chunks of Java code are called 'snippets'.\n\
486 \n\
487 There are also jshell commands that allow you to understand and\n\
488 control what you are doing, like: /list\n\
489 \n\
490 For a list of commands: /help
491
492 help.shortcuts.summary = a description of keystrokes for snippet and command completion,\n\
493 information access, and automatic code generation
494 help.shortcuts =\
495 Supported shortcuts include:\n\
496 \n\
497 <tab>\n\t\t\
498 After entering the first few letters of a Java identifier,\n\t\t\
499 a jshell command, or, in some cases, a jshell command argument,\n\t\t\
500 press the <tab> key to complete the input.\n\t\t\
501 If there is more than one completion, then possible completions will be shown.\n\t\t\
502 Will show documentation if available and appropriate.\n\n\
503 Shift-<tab> v\n\t\t\
504 After a complete expression, hold down <shift> while pressing <tab>,\n\t\t\
505 then release and press "v", the expression will be converted to\n\t\t\
506 a variable declaration whose type is based on the type of the expression.\n\n\
507 Shift-<tab> i\n\t\t\
508 After an unresolvable identifier, hold down <shift> while pressing <tab>,\n\t\t\
509 then release and press "i", and jshell will propose possible imports\n\t\t\
510 which will resolve the identifier based on the content of the specified classpath.
511
512 help.context.summary = the evaluation context options for /env /reload and /reset
513 help.context =\
514 These options configure the evaluation context, they can be specified when\n\
515 jshell is started: on the command-line, or restarted with the commands /env,\n\
516 /reload, or /reset.\n\
517 \n\
518 They are:\n\t\
519 --class-path <class search path of directories and zip/jar files>\n\t\t\
520 A list of directories, JAR archives,\n\t\t\
521 and ZIP archives to search for class files.\n\t\t\
522 The list is separated with the path separator\n\t\t\
523 (a : on unix/linux/mac, and ; on windows).\n\t\
524 --module-path <module path>...\n\t\t\
525 A list of directories, each directory\n\t\t\
526 is a directory of modules.\n\t\t\
527 The list is separated with the path separator\n\t\t\
528 (a : on unix/linux/mac, and ; on windows).\n\t\
529 --add-modules <modulename>[,<modulename>...]\n\t\t\
530 root modules to resolve in addition to the initial module.\n\t\t\
531 <modulename> can also be ALL-DEFAULT, ALL-SYSTEM,\n\t\t\
532 ALL-MODULE-PATH.\n\t\
533 --add-exports <module>/<package>=<target-module>(,<target-module>)*\n\t\t\
534 updates <module> to export <package> to <target-module>,\n\t\t\
535 regardless of module declaration.\n\t\t\
536 <target-module> can be ALL-UNNAMED to export to all\n\t\t\
537 unnamed modules. In jshell, if the <target-module> is not\n\t\t\
538 specified (no =) then ALL-UNNAMED is used.\n\
539 \n\
540 On the command-line these options must have two dashes, e.g.: --module-path\n\
541 On jshell commands they can have one or two dashes, e.g.: -module-path\n\
542
543 help.set._retain = \
544 The '-retain' option saves a setting so that it is used in future sessions.\n\
545 The -retain option can be used on the following forms of /set:\n\n\t\
546 /set editor -retain\n\t\
547 /set start -retain\n\t\
548 /set feedback -retain\n\t\
549 /set mode -retain\n\n\
550 See these commands for more detail -- for example /help /set editor
551
552 help.set.format = \
553 Set the format for reporting a snippet event:\n\
554 \n\t\
555 /set format <mode> <field> "<format>" <selector>...\n\
556 \n\
557 Show the format settings:\n\
558 \n\t\
559 /set format [<mode> [<field>]]\n\
560 \n\
561 Where <mode> is the name of a previously defined feedback mode -- see '/help /set mode'.\n\
562 Where <field> is the name of context-specific format to define.\n\
563 Where <format> is a quoted string which will be the value of the field if one of\n\
564 the selectors matches (or there are no selectors). When the format is used,\n\
565 field names enclosed in braces are replaced with the value of the field at that\n\
566 time. These fields may have been previously defined with this command or may be\n\
567 one of these predefined fields specific to the context:\n\t\
568 {name} == The name, e.g.: the variable name, ...\n\t\
569 {type} == The type name. The type of a variable or expression, the\n\t\t\t\
570 parameter types of a method\n\t\
571 {value} == The result value of an expression or variable initialization\n\t\
572 {unresolved} == The list of unresolved references\n\t\
573 {errors} == The list of recoverable errors (during the processing of the\n\t\t\t\
574 "display" field only)\n\t\
575 {err} == An unformatted error line (during the processing of the\n\t\t\t\
576 "errorline" field only)\n\
577 The following fields are accessed by the tool to determine the displayed feedback:\n\t\
578 {display} == The displayed message for a snippet event\n\t\
579 {errorline} == The format of one error line within the "errors" field\n\t\
580 {pre} == The feedback prefix (begins command feedback)\n\t\
581 {post} == The feedback postfix (ends command feedback)\n\t\
582 {errorpre} == The error prefix (begins error feedback)\n\t\
583 {errorpost} == The error postfix (ends error feedback)\n\
584 These fields have default settings (which may be overwritten).\n\
585 Where <selector> is the context in which the format is applied.\n\
586 The structure of selector is a hyphen separated list of selector kind lists.\n\
587 A selector kind list is a comma separated list of values of one selector kind.\n\
588 A selector matches if each selector kind list matches; A selector kind list\n\
589 matches if one of the values matches.\n\n\
590 The case selector kind describes the kind of snippet. The values are:\n\t\
591 import -- import declaration\n\t\
592 class -- class declaration\n\t\
593 interface -- interface declaration\n\t\
594 enum -- enum declaration\n\t\
595 annotation -- annotation interface declaration\n\t\
596 method -- method declaration -- note: {type}==parameter-types\n\t\
597 vardecl -- variable declaration without init\n\t\
598 varinit -- variable declaration with init\n\t\
599 expression -- expression -- note: {name}==scratch-variable-name\n\t\
600 varvalue -- variable value expression\n\t\
601 assignment -- assign variable\n\t\
602 statement -- statement\n\
603 The action selector kind describes what happened to the snippet. The values are:\n\t\
604 added -- snippet has been added\n\t\
605 modified -- an existing snippet has been modified\n\t\
606 replaced -- an existing snippet has been replaced with a new snippet\n\t\
607 overwrote -- an existing snippet has been overwritten\n\t\
608 dropped -- snippet has been dropped\n\t\
609 used -- snippet was used when it cannot be\n\
610 The when-did-it-occur selector kind describes if this is a direct or indirect action. The values are:\n\t\
611 primary -- the entered snippet\n\t\
612 update -- an update to a dependent snippet\n\
613 The resolution-state selector kind describes the state of resolution/definition of the snippet. The values are:\n\t\
614 ok -- resolved correctly\n\t\
615 defined -- defined despite recoverably unresolved references\n\t\
616 notdefined -- not defined because of recoverably unresolved references\n\
617 The unresolved-count selector kind describes the number of unresolved references. The values are:\n\t\
618 unresolved0 -- no names are unresolved\n\t\
619 unresolved1 -- one name is unresolved\n\t\
620 unresolved2 -- two or more names are unresolved\n\
621 The errors-count selector kind describes the number of errors. The values are:\n\t\
622 error0 -- no errors\n\t\
623 error1 -- one error\n\t\
624 error2 -- two or more errors\n\n\
625 Examples:\n\t\
626 /set format myformat action 'Created' added-primary\n\t\
627 /set format myformat action 'Update replaced' replaced-update\n\t\
628 /set format myformat display '{pre}{action} class {name}{post}' class-ok\n\t\
629 /set format myformat display '{pre}{action} variable {name}, reset to null{post}' replaced-vardecl,varinit-ok-update\n\n\
630 Note that subsequent selectors for a field may overwrite some or all of previous used selectors -- last one wins\n\
631 \n\
632 The form without <format> shows the current format settings.\n\
633 When the <mode> is specified only the format settings for that mode are shown.\n\
634 When both the <mode> and <field> are specified only the format settings for that\n\
635 mode and field are shown. Example:\n\t\
636 /set format myformat\n\
637 shows the format settings for the mode myformat\n
638
639 help.set.truncation = \
640 Set the max length of a displayed value:\n\
641 \n\t\
642 /set truncation <mode> <length> <selector>...\n\
643 \n\
644 Show the current truncation settings:\n\
645 \n\t\
646 /set truncation [<mode>]\n\
647 \n\
648 Where <mode> is the name of a previously defined feedback mode -- see '/help /set mode'.\n\
649 Where <length> is an unsigned integer representing a maximum length.\n\
650 Where <selector> is only needed if you wish to fine-tune value truncation length\n\
651 by context, <selector> is the context in which the truncation is applied.\n\
652 The structure of selector is a hyphen separated list of selector kind lists.\n\
653 A selector kind list is a comma separated list of values of one selector kind.\n\
654 A selector matches if each selector kind list matches; A selector kind list\n\
655 matches if one of the values matches.\n\n\
656 Below are the relevant selector kinds for truncation.\n\n\
657 The case selector kind describes the kind of snippet. The values are:\n\t\
658 vardecl -- variable declaration without init\n\t\
659 varinit -- variable declaration with init\n\t\
660 expression -- expression -- note: {name}==scratch-variable-name\n\t\
661 varvalue -- variable value expression\n\t\
662 assignment -- assign variable\n\
663 The action selector kind describes what happened to the snippet. The values are:\n\t\
664 added -- snippet has been added\n\t\
665 modified -- an existing snippet has been modified\n\t\
666 replaced -- an existing snippet has been replaced with a new snippet\n\
667 Examples:\n\t\
668 /set trunc mymode 80\n\t\
669 /set truncation mymode 45 expression\n\t\
670 /set truncation mymode 0 vardecl-modified,replaced\n\n\
671 Note that subsequent selectors for a field may overwrite some or all of previous used selectors -- last one wins\n\
672 \n\
673 The form without <length> shows the truncation settings.\n\
674 When the <mode> is specified only the truncation settings for that mode are shown.\n\
675 Example:\n\t\
676 /set truncation myformat\n\
677 shows the truncation settings for the mode myformat\n
678
679 help.set.feedback = \
680 Set the feedback mode describing displayed feedback for entered snippets and commands:\n\
681 \n\t\
682 /set feedback [-retain] <mode>\n\
683 \n\
684 Retain the current feedback mode for future sessions:\n\
685 \n\t\
686 /set feedback -retain\n\
687 \n\
688 Show the feedback mode and list available modes:\n\
689 \n\t\
690 /set feedback\n\
691 \n\
692 Where <mode> is the name of a previously defined feedback mode.\n\
693 You may use just enough letters to make it unique.\n\
694 User-defined modes can be added, see '/help /set mode'\n\
695 \n\
696 When the -retain option is used, the setting will be used in this and future\n\
697 runs of the jshell tool.\n\
698 \n\
699 The form without <mode> or -retain displays the current feedback mode and available modes.\n
700
701 help.set.mode = \
702 Create a user-defined feedback mode, optionally copying from an existing mode:\n\
703 \n\t\
704 /set mode <mode> [<old-mode>] [-command|-quiet|-delete]\n\
705 Retain a user-defined feedback mode for future sessions:\n\
706 \n\t\
707 /set mode -retain <mode>\n\
708 \n\
709 Delete a user-defined feedback mode:\n\
710 \n\t\
711 /set mode -delete [-retain] <mode>\n\
712 \n\
713 Show feedback mode settings:\n\
714 \n\t\
715 /set mode [<mode>]\n\
716 \n\
717 Where <new-mode> is the name of a mode you wish to create.\n\
718 Where <old-mode> is the name of a previously defined feedback mode.\n\
719 If <old-mode> is present, its settings are copied to the new mode.\n\
720 '-command' vs '-quiet' determines if informative/verifying command feedback is displayed.\n\
721 \n\
722 Once the new mode is created, use '/set format', '/set prompt' and '/set truncation'\n\
723 to configure it. Use '/set feedback' to use the new mode.\n\
724 \n\
725 When the -retain option is used, the mode (including its component prompt, format,\n\
726 and truncation settings) will be used in this and future runs of the jshell tool.\n\
727 When both -retain and -delete are used, the mode is deleted from the current\n\
728 and future sessions.\n\
729 \n\
730 The form without options shows the mode settings.\n\
731 When the <mode> is specified only the mode settings for that mode are shown.\n\
732 Note: the settings for the mode include the settings for prompt, format, and\n\
733 truncation -- so these are displayed as well.\n\
734 Example:\n\t\
735 /set mode myformat\n\
736 shows the mode, prompt, format, and truncation settings for the mode myformat\n
737
738 help.set.prompt = \
739 Set the prompts. Both the normal prompt and the continuation-prompt must be set:\n\
740 \n\t\
741 /set prompt <mode> \"<prompt>\" \"<continuation-prompt>\"\n\
742 \n\
743 Show the normal prompt and the continuation-prompts:\n\
744 \n\t\
745 /set prompt [<mode>]\n\
746 \n\
747 Where <mode> is the name of a previously defined feedback mode.\n\
748 Where <prompt> and <continuation-prompt> are quoted strings printed as input prompts;\n\
749 Both may optionally contain '%%s' which will be substituted with the next snippet id --\n\
750 note that what is entered may not be assigned that id, for example it may be an error or command.\n\
751 The continuation-prompt is used on the second and subsequent lines of a multi-line snippet.\n\
752 \n\
753 The form without <prompt> shows the currently set prompts.\n\
754 When the <mode> is specified only the prompts for that mode are shown.\n\
755 Example:\n\t\
756 /set prompt myformat\n\
757 shows the prompts set for the mode myformat\n
758
759 help.set.editor =\
760 Specify the command to launch for the /edit command:\n\
761 \n\t\
762 /set editor [-retain] [-wait] <command>\n\
763 \n\t\
764 /set editor [-retain] -default\n\
765 \n\t\
766 /set editor [-retain] -delete\n\
767 \n\
768 Retain the current editor setting for future sessions:\n\
769 \n\t\
770 /set editor -retain\n\
771 \n\
772 Show the command to launch for the /edit command:\n\
773 \n\t\
774 /set editor\n\
775 \n\
776 The <command> is an operating system dependent string.\n\
777 The <command> may include space-separated arguments (such as flags)\n\n\
778 If the -default option is specified, the built-in default editor will be used.\n\n\
779 If the -delete option is specified, previous settings are ignored -- the editor\n\
780 settings are initialized as when starting the jshell tool. Specifically, if there\n\
781 is a retained setting it is used (unless both -retain and -delete are specified --\n\
782 which deletes the retained setting), if one of these environment variables is set\n\
783 it will be used: JSHELLEDITOR, VISUAL, or EDITOR (in that order). Otherwise the\n\
784 built-in default editor will be used.\n\n\
785 If <command> is specified, it will be used as the external editor. The <command>\n\
786 consists of the program and zero or more program arguments. When <command>\n\
787 is used, the temporary file to edit will be appended as the last argument.\n\
788 Normally, edit mode will last until the external editor exits. Some external editors\n\
789 will exit immediately (for example, if the edit window exists) either external editor\n\
790 flags should be used to prevent immediate exit, or the -wait option should be used to\n\
791 prompt the user to indicate when edit mode should end.\n\n\
792 Note: while in edit mode no command inputs are seen. After leaving edit mode changes\n\
793 to the edited snippets are not seen.\n\
794 \n\
795 When the -retain option is used, the setting will be used in this and future\n\
796 runs of the jshell tool.\n\
797 \n\
798 The form without <command> or options shows the editor setting.\n
799
800 help.set.start =\
801 Set the start-up configuration -- a sequence of snippets and commands read at start-up:\n\
802 \n\t\
803 /set start [-retain] <file>...\n\
804 \n\t\
805 /set start [-retain] -default\n\
806 \n\t\
807 /set start [-retain] -none\n\
808 \n\
809 Retain the start-up configuration for future sessions:\n\
810 \n\t\
811 /set start -retain\n\
812 \n\
813 Show the start-up setting:\n\
814 \n\t\
815 /set start\n\
816 \n\
817 The contents of the specified <file> become the start-up snippets and commands used\n\
818 when the /reset, /reload, or /env commands are used in this session.\n\
819 If instead the -default option is specified, the predefined start-up import\n\
820 snippets will be used.\n\
821 If the -none option is used, the start-up will be empty -- no start-up snippets\n\
822 or commands will be used.\n\
823 This command is good for testing the start-up settings. To retain them for future\n\
824 runs of the jshell tool use the command:\n\t\
825 /set start -retain\n\
826 \n\
827 When the -retain option is used, the setting will be used in this and future\n\
828 runs of the jshell tool.\n\
829 \n\
830 The form without <file> or options shows the start-up setting.\n\
831 Note: if the start-up was last set from a file, this is shown with the\n\
832 'set start' command followed by the contents of the file.\n\
833 \n\
834 The <file> may be an operating system file name, or one of the predefined\n\
835 startup file names: DEFAULT, PRINTING, or JAVASE.\n\
836 These are respectively: the default import snippets (as used by -default),\n\
837 definitions of print(), println(), and printf() method snippets, or\n\
838 imports of all Java SE packages.\n\
839 More than one <file> may be specified, for example:\n\
840 \n\t\
841 /set start -retain DEFAULT PRINTING
842
843 startup.feedback = \
844 /set mode verbose -command \n\
845 \n\
846 /set prompt verbose '\\njshell> ' ' ...> ' \n\
847 \n\
848 /set format verbose pre '| ' \n\
849 /set format verbose post '%n' \n\
850 /set format verbose errorpre '| ' \n\
851 /set format verbose errorpost '%n' \n\
852 \n\
853 /set format verbose errorline '{post}{pre} {err}' \n\
854 \n\
855 /set format verbose action 'created' added-primary \n\
856 /set format verbose action 'modified' modified-primary \n\
857 /set format verbose action 'replaced' replaced-primary \n\
858 /set format verbose action 'overwrote' overwrote-primary \n\
859 /set format verbose action 'dropped' dropped-primary \n\
860 /set format verbose action ' update created' added-update \n\
861 /set format verbose action ' update modified' modified-update \n\
862 /set format verbose action ' update replaced' replaced-update \n\
863 /set format verbose action ' update overwrote' overwrote-update \n\
864 /set format verbose action ' update dropped' dropped-update \n\
865 \n\
866 /set format verbose until ', however, it cannot be instantiated or its methods invoked until' defined-class-primary \n\
867 /set format verbose until ', however, its methods cannot be invoked until' defined-interface-primary \n\
868 /set format verbose until ', however, it cannot be used until' defined-enum,annotation-primary \n\
869 /set format verbose until ', however, it cannot be invoked until' defined-method-primary \n\
870 /set format verbose until ', however, it cannot be referenced until' notdefined-primary \n\
871 /set format verbose until ' which cannot be instantiated or its methods invoked until' defined-class-update \n\
872 /set format verbose until ' whose methods cannot be invoked until' defined-interface-update \n\
873 /set format verbose until ' which cannot be invoked until' defined-method-update \n\
874 /set format verbose until ' which cannot be referenced until' notdefined-update \n\
875 \n\
876 /set format verbose unrerr '{unresolved} is declared' unresolved1-error0 \n\
877 /set format verbose unrerr '{unresolved} are declared' unresolved2-error0 \n\
878 /set format verbose unrerr ' this error is corrected: {errors}' unresolved0-error1 \n\
879 /set format verbose unrerr '{unresolved} is declared and this error is corrected: {errors}' unresolved1-error1 \n\
880 /set format verbose unrerr '{unresolved} are declared and this error is corrected: {errors}' unresolved2-error1 \n\
881 /set format verbose unrerr ' these errors are corrected: {errors}' unresolved0-error2 \n\
882 /set format verbose unrerr '{unresolved} is declared and these errors are corrected: {errors}' unresolved1-error2 \n\
883 /set format verbose unrerr '{unresolved} are declared and these errors are corrected: {errors}' unresolved2-error2 \n\
884 \n\
885 /set format verbose resolve '{until}{unrerr}' defined,notdefined-added,modified,replaced,used \n\
886 \n\
887 /set format verbose typeKind 'class' class \n\
888 /set format verbose typeKind 'interface' interface \n\
889 /set format verbose typeKind 'enum' enum \n\
890 /set format verbose typeKind 'annotation interface' annotation \n\
891 \n\
892 /set format verbose result '{name} ==> {value}{post}' added,modified,replaced-ok-primary \n\
893 \n\
894 /set format verbose display '{result}{pre}created scratch variable {name} : {type}{post}' expression-added,modified,replaced-primary \n\
895 /set format verbose display '{result}{pre}value of {name} : {type}{post}' varvalue-added,modified,replaced-primary \n\
896 /set format verbose display '{result}{pre}assigned to {name} : {type}{post}' assignment-primary \n\
897 /set format verbose display '{result}{pre}{action} variable {name} : {type}{resolve}{post}' varinit,vardecl \n\
898 /set format verbose display '{pre}{action} variable {name}{resolve}{post}' vardecl,varinit-notdefined \n\
899 /set format verbose display '{pre}{action} variable {name}{post}' dropped-vardecl,varinit,expression \n\
900 /set format verbose display '{pre}{action} variable {name}, reset to null{post}' replaced-vardecl,varinit-ok-update \n\
901 \n\
902 /set format verbose display '{pre}{action} {typeKind} {name}{resolve}{post}' class,interface,enum,annotation \n\
903 /set format verbose display '{pre}{action} method {name}({type}){resolve}{post}' method \n\
904 \n\
905 /set format verbose display '{pre}attempted to use {typeKind} {name}{resolve}{post}' used-class,interface,enum,annotation \n\
906 /set format verbose display '{pre}attempted to call method {name}({type}){resolve}{post}' used-method \n\
907 \n\
908 /set truncation verbose 80\n\
909 /set truncation verbose 1000 varvalue,expression\n\
910 \n\
911 /set mode normal -command verbose \n\
912 /set format normal display '' added,modified,replaced,overwrote,dropped-update \n\
913 /set format normal display '{pre}{action} variable {name}, reset to null{post}' replaced-vardecl,varinit-ok-update \n\
914 /set format normal display '{result}' added,modified,replaced-expression,varvalue,assignment,varinit,vardecl-ok-primary \n\
915 /set mode concise -quiet normal \n\
916 \n\
917 /set prompt concise 'jshell> ' ' ...> ' \n\
918 \n\
919 /set format concise display '' class,interface,enum,annotation,method,assignment,varinit,vardecl-ok \n\
920 \n\
921 /set feedback normal \n\
922 \n\
923 /set mode silent -quiet \n\
924 /set prompt silent '-> ' '>> ' \n\
925 /set truncation silent 80\n\
926 /set truncation silent 1000 varvalue,expression\n\
927 /set format silent pre '| ' \n\
928 /set format silent post '%n' \n\
929 /set format silent errorpre '| ' \n\
930 /set format silent errorpost '%n' \n\
931 /set format silent display '' \n
932
933 jshell.fix.wrong.shortcut =\
934 Unexpected character after Shift-Tab. Use "i" for auto-import or "v" for variable creation. For more information see:\n\
935 /help shortcuts