langtools/src/jdk.jshell/share/classes/jdk/internal/jshell/tool/resources/l10n.properties
changeset 41635 cb3d04878117
parent 41514 a75c2b869d8d
child 41641 a628785b9dd9
equal deleted inserted replaced
41634:3f9c491b05aa 41635:cb3d04878117
    50 jshell.err.startup.unexpected.exception = Unexpected exception reading start-up: {0}
    50 jshell.err.startup.unexpected.exception = Unexpected exception reading start-up: {0}
    51 jshell.err.unexpected.exception = Unexpected exception: {0}
    51 jshell.err.unexpected.exception = Unexpected exception: {0}
    52 
    52 
    53 jshell.err.no.such.command.or.snippet.id = No such command or snippet id: {0}
    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}
    54 jshell.err.command.ambiguous = Command: ''{0}'' is ambiguous: {1}
    55 jshell.err.set.editor.arg = The ''/set editor'' command requires a path argument
       
    56 jshell.msg.set.editor.set = Editor set to: {0}
    55 jshell.msg.set.editor.set = Editor set to: {0}
       
    56 jshell.msg.set.editor.retain = Editor setting retained: {0}
    57 jshell.err.cant.launch.editor = Cannot launch editor -- unexpected exception: {0}
    57 jshell.err.cant.launch.editor = Cannot launch editor -- unexpected exception: {0}
    58 jshell.msg.try.set.editor = Try /set editor to use external editor.
    58 jshell.msg.try.set.editor = Try /set editor to use external editor.
    59 jshell.msg.press.return.to.leave.edit.mode = Press return to leave edit mode.
    59 jshell.msg.press.return.to.leave.edit.mode = Press return to leave edit mode.
    60 jshell.err.wait.applies.to.external.editor = -wait applies to external editors, cannot be used with -default
    60 jshell.err.wait.applies.to.external.editor = -wait applies to external editors
       
    61 
       
    62 jshell.err.setting.to.retain.must.be.specified = The setting to retain must be specified -- {0}
       
    63 jshell.msg.set.show.mode.settings = \nTo show mode settings use ''/set prompt'', ''/set truncation'', ...\n\
       
    64 or use ''/set mode'' followed by the feedback mode name.
       
    65 jshell.err.continuation.prompt.required = Continuation prompt required -- {0}
    61 
    66 
    62 jshell.msg.try.command.without.args = Try ''{0}'' without arguments.
    67 jshell.msg.try.command.without.args = Try ''{0}'' without arguments.
    63 jshell.msg.no.active = There are no active definitions.
    68 jshell.msg.no.active = There are no active definitions.
    64 
    69 
    65 jshell.msg.resetting = Resetting...
    70 jshell.msg.resetting = Resetting...
   102 jshell.msg.help.for.help = Type /help for help.
   107 jshell.msg.help.for.help = Type /help for help.
   103 
   108 
   104 jshell.err.mode.name = Expected a feedback mode name: {0}
   109 jshell.err.mode.name = Expected a feedback mode name: {0}
   105 jshell.err.missing.mode = Missing the feedback mode -- {0}
   110 jshell.err.missing.mode = Missing the feedback mode -- {0}
   106 jshell.err.field.name = Expected a field name: {0} -- {1}
   111 jshell.err.field.name = Expected a field name: {0} -- {1}
   107 jshell.err.missing.field = Missing the field name -- {0}
       
   108 jshell.err.mode.unknown = No feedback mode named: {0} -- {1}
   112 jshell.err.mode.unknown = No feedback mode named: {0} -- {1}
   109 
   113 
   110 jshell.err.feedback.does.not.match.mode = Does not match any current feedback mode: {0} -- {1}
   114 jshell.err.feedback.does.not.match.mode = Does not match any current feedback mode: {0} -- {1}
   111 jshell.err.feedback.ambiguous.mode = Matches more then one current feedback mode: {0} -- {1}
   115 jshell.err.feedback.ambiguous.mode = Matches more then one current feedback mode: {0} -- {1}
   112 jshell.err.feedback.expected.format = Expected format missing -- {0}
       
   113 jshell.err.feedback.must.be.quoted = Format ''{0}'' must be quoted -- {1}
   116 jshell.err.feedback.must.be.quoted = Format ''{0}'' must be quoted -- {1}
   114 jshell.err.feedback.not.a.valid.selector = Not a valid selector ''{0}'' in ''{1}'' -- {2}
   117 jshell.err.feedback.not.a.valid.selector = Not a valid selector ''{0}'' in ''{1}'' -- {2}
   115 jshell.err.feedback.multiple.sections = Selector kind in multiple sections of selector list ''{0}'' in ''{1}'' -- {2}
   118 jshell.err.feedback.multiple.sections = Selector kind in multiple sections of selector list ''{0}'' in ''{1}'' -- {2}
   116 jshell.err.feedback.different.selector.kinds = Different selector kinds in same sections of selector list ''{0}'' in ''{1}'' -- {2}
   119 jshell.err.feedback.different.selector.kinds = Different selector kinds in same sections of selector list ''{0}'' in ''{1}'' -- {2}
   117 
   120 
   118 jshell.msg.feedback.new.mode = Created new feedback mode: {0}
   121 jshell.msg.feedback.new.mode = Created new feedback mode: {0}
   119 jshell.msg.feedback.mode = Feedback mode: {0}
   122 jshell.msg.feedback.mode = Feedback mode: {0}
   120 jshell.msg.feedback.mode.following = The feedback mode should be one of the following:
   123 jshell.msg.feedback.mode.following = Available feedback modes:
       
   124 jshell.msg.feedback.retained.mode.following = Retained feedback modes:
       
   125 jshell.err.mode.creation = To create a new mode either the -command or the -quiet option must be used -- {0}
       
   126 jshell.err.mode.exists = Mode to be created already exists: {0} -- {1}
   121 
   127 
   122 jshell.err.truncation.expected.length = Expected truncation length -- {0}
   128 jshell.err.truncation.expected.length = Expected truncation length -- {0}
   123 jshell.err.truncation.length.not.integer = Truncation length must be an integer: {0} -- {1}
   129 jshell.err.truncation.length.not.integer = Truncation length must be an integer: {0} -- {1}
   124 
   130 
   125 jshell.err.not.valid.with.predefined.mode = Not valid with a predefined mode: {0} -- {1}
   131 jshell.err.not.valid.with.predefined.mode = Not valid with a predefined mode: {0} -- {1}
   126 jshell.err.retained.feedback.mode.must.be.retained.or.predefined = \
   132 jshell.err.retained.feedback.mode.must.be.retained.or.predefined = \
   127 ''/retain feedback <mode>'' requires that <mode> is predefined or has been retained with ''/retain mode'' -- {0}
   133 ''/set feedback -retain <mode>'' requires that <mode> is predefined or has been retained with ''/set mode -retain'' -- {0}
   128 
   134 
   129 jshell.err.unknown.option = Unknown option: {0} -- {1}
   135 jshell.err.unknown.option = Unknown option: {0} -- {1}
   130 jshell.err.default.option.or.program = Specify -default option or program, not both -- {0}
   136 jshell.err.default.option.or.program = Specify -default option or program, not both -- {0}
   131 jshell.err.option.or.filename = Specify either one option or a startup file name -- {0}
   137 jshell.err.option.or.filename = Specify no more than one of -default, -none, or a startup file name -- {0}
   132 jshell.err.unexpected.at.end = Unexpected arguments at end of command: {0} -- {1}
   138 jshell.err.unexpected.at.end = Unexpected arguments at end of command: {0} -- {1}
   133 jshell.err.conflicting.options = Conflicting options -- {0}
   139 jshell.err.conflicting.options = Conflicting options -- {0}
   134 jshell.err.cannot.delete.current.mode = The current feedback mode ''{0}'' cannot be deleted, use ''/set feedback'' first -- {1}
   140 jshell.err.cannot.delete.current.mode = The current feedback mode ''{0}'' cannot be deleted, use ''/set feedback'' first -- {1}
   135 jshell.err.cannot.delete.retained.mode = The retained feedback mode ''{0}'' cannot be deleted, use ''/retain feedback'' first -- {1}
   141 jshell.err.cannot.delete.retained.mode = The retained feedback mode ''{0}'' cannot be deleted, use ''/set feedback -retain'' first -- {1}
   136 jshell.err.may.not.specify.options.and.snippets = Options and snippets must not both be used: {0}
   142 jshell.err.may.not.specify.options.and.snippets = Options and snippets must not both be used: {0}
   137 jshell.err.no.such.snippets = No such snippet: {0}
   143 jshell.err.no.such.snippets = No such snippet: {0}
   138 jshell.err.the.snippet.cannot.be.used.with.this.command = This command does not accept the snippet ''{0}'' : {1}
   144 jshell.err.the.snippet.cannot.be.used.with.this.command = This command does not accept the snippet ''{0}'' : {1}
   139 jshell.err.retained.mode.failure = Failure in retained modes (modes cleared) -- {0} {1}
   145 jshell.err.retained.mode.failure = Failure in retained modes (modes cleared) -- {0} {1}
   140 
   146 
   372      The <command> is an operating system dependent string.\n\n\
   378      The <command> is an operating system dependent string.\n\n\
   373 /set start <file>\n\t\
   379 /set start <file>\n\t\
   374      The contents of the specified <file> become the default start-up snippets and commands.\n\n\
   380      The contents of the specified <file> become the default start-up snippets and commands.\n\n\
   375 /set feedback <mode>\n\t\
   381 /set feedback <mode>\n\t\
   376      Set the feedback mode describing displayed feedback for entered snippets and commands.\n\n\
   382      Set the feedback mode describing displayed feedback for entered snippets and commands.\n\n\
   377 /set mode <mode> [<old-mode>] [-command|-quiet|-delete]\n\t\
   383 /set mode <mode> [<old-mode>] -command|-quiet|-delete\n\t\
   378      Create or update a user-defined feedback mode, optionally copying from an existing mode.\n\n\
   384      Create or update a user-defined feedback mode, optionally copying from an existing mode.\n\n\
   379 /set prompt <mode> "<prompt>" "<continuation-prompt>"\n\t\
   385 /set prompt <mode> "<prompt>" "<continuation-prompt>"\n\t\
   380      Set the displayed prompts for a given feedback mode.\n\n\
   386      Set the displayed prompts for a given feedback mode.\n\n\
   381 /set truncation <mode> <length> <selector>...\n\t\
   387 /set truncation <mode> <length> <selector>...\n\t\
   382      Set the maximum length of a displayed value\n\
   388      Set the maximum length of a displayed value.\n\n\
   383 /set format <mode> <field> "<format>" <selector>...\n\t\
   389 /set format <mode> <field> "<format>" <selector>...\n\t\
   384      Configure a feedback mode by setting the format of a field when the selector matchs.\n\n\
   390      Configure a feedback mode by setting the format of a field when the selector matches.\n\n\
       
   391 /set\n\t\
       
   392      Show editor, start, and feedback settings as /set commands.\n\t\
       
   393      To show the settings of any of the above, omit the set value.\n\n\
   385 To get more information about one of these forms, use /help with the form specified.\n\
   394 To get more information about one of these forms, use /help with the form specified.\n\
   386 For example:   /help /set format
   395 For example:   /help /set format
   387 
       
   388 help.retain.summary = retain jshell configuration information for subsequent sessions
       
   389 help.retain.args = editor|start|feedback|mode
       
   390 help.retain =\
       
   391 Retain jshell configuration information for future invocations of the jshell tool,\n\
       
   392 including: the external editor to use, the start-up definitions to use, the\n\
       
   393 configuration of a feedback mode, or the feedback mode to use.\n\
       
   394 \n\
       
   395 /retain editor [<command> <optional-arg>...]\n\t\
       
   396      Specify the command to launch for the /edit command.\n\t\
       
   397      The <command> is an operating system dependent string.\n\n\
       
   398 /retain start [<file>]\n\t\
       
   399      The contents of the specified <file> become the default start-up snippets and commands.\n\n\
       
   400 /retain feedback [<mode>]\n\t\
       
   401      Set the feedback mode describing displayed feedback for entered snippets and commands.\n\n\
       
   402 /retain mode <mode>\n\t\
       
   403      Create a user-defined feedback mode, optionally copying from an existing mode.\n\n\
       
   404 To get more information about one of these forms, use /help with the form specified.\n\
       
   405 For example:   /help /retain feedback
       
   406 
   396 
   407 help.quest.summary = get information about jshell
   397 help.quest.summary = get information about jshell
   408 help.quest.args = [<command>|<subject>]
   398 help.quest.args = [<command>|<subject>]
   409 help.quest =\
   399 help.quest =\
   410 Display information about jshell (abbreviation for /help).\n\
   400 Display information about jshell (abbreviation for /help).\n\
   465 <fix-shortcut> i\n\t\t\
   455 <fix-shortcut> i\n\t\t\
   466         After an unresolvable identifier, press "<fix-shortcut> i" and jshell will propose\n\t\t\
   456         After an unresolvable identifier, press "<fix-shortcut> i" and jshell will propose\n\t\t\
   467         possible fully qualified names based on the content of the specified classpath.\n\t\t\
   457         possible fully qualified names based on the content of the specified classpath.\n\t\t\
   468         The "<fix-shortcut>" is either Alt-F1 or Alt-Enter, depending on the platform.
   458         The "<fix-shortcut>" is either Alt-F1 or Alt-Enter, depending on the platform.
   469 
   459 
       
   460 help.set._retain = \
       
   461 The '-retain' option saves a setting so that it is used in future sessions.\n\
       
   462 The -retain option can be used on the following forms of /set:\n\n\t\
       
   463 /set editor -retain\n\t\
       
   464 /set start -retain\n\t\
       
   465 /set feedback -retain\n\t\
       
   466 /set mode -retain\n\n\
       
   467 See these commands for more detail -- for example /help /set editor
       
   468 
   470 help.set.format = \
   469 help.set.format = \
   471 Set the format for reporting a snippet event.\n\
   470 Set the format for reporting a snippet event:\n\
   472 \n\t\
   471 \n\t\
   473 /set format <mode> <field> "<format>" <selector>...\n\
   472 /set format <mode> <field> "<format>" <selector>...\n\
       
   473 \n\
       
   474 Show the format settings:\n\
       
   475 \n\t\
       
   476 /set format [<mode> [<field>]]\n\
   474 \n\
   477 \n\
   475 Where <mode> is the name of a previously defined feedback mode -- see '/help /set mode'.\n\
   478 Where <mode> is the name of a previously defined feedback mode -- see '/help /set mode'.\n\
   476 Where <field> is the name of context-specific format to define.\n\
   479 Where <field> is the name of context-specific format to define.\n\
   477 Where <format> is a quoted string which will be the value of the field if one of\n\
   480 Where <format> is a quoted string which will be the value of the field if one of\n\
   478 the selectors matches (or there are no selectors). When the format is used,\n\
   481 the selectors matches (or there are no selectors). When the format is used,\n\
   539 Examples:\n\t\
   542 Examples:\n\t\
   540 /set format myformat action 'Created' added-primary\n\t\
   543 /set format myformat action 'Created' added-primary\n\t\
   541 /set format myformat action 'Update replaced' replaced-update\n\t\
   544 /set format myformat action 'Update replaced' replaced-update\n\t\
   542 /set format myformat display '{pre}{action} class {name}{post}' class-ok\n\t\
   545 /set format myformat display '{pre}{action} class {name}{post}' class-ok\n\t\
   543 /set format myformat display '{pre}{action} variable {name}, reset to null{post}' replaced-vardecl,varinit-ok-update\n\n\
   546 /set format myformat display '{pre}{action} variable {name}, reset to null{post}' replaced-vardecl,varinit-ok-update\n\n\
   544 Note that subsequent selectors for a field may overwrite some or all of previous used selectors -- last one wins\n
   547 Note that subsequent selectors for a field may overwrite some or all of previous used selectors -- last one wins\n\
       
   548 \n\
       
   549 The form without <format> shows the current format settings.\n\
       
   550 When the <mode> is specified only the format settings for that mode are shown.\n\
       
   551 When both the <mode> and <field> are specified only the format settings for that\n\
       
   552 mode and field are shown.  Example:\n\t\
       
   553 /set format myformat\n\
       
   554 shows the format settings for the mode myformat\n
   545 
   555 
   546 help.set.truncation = \
   556 help.set.truncation = \
   547 Set the max length a displayed value.\n\
   557 Set the max length of a displayed value:\n\
   548 \n\t\
   558 \n\t\
   549 /set truncation <mode> <length> <selector>...\n\
   559 /set truncation <mode> <length> <selector>...\n\
       
   560 \n\
       
   561 Show the current truncation settings:\n\
       
   562 \n\t\
       
   563 /set truncation [<mode>]\n\
   550 \n\
   564 \n\
   551 Where <mode> is the name of a previously defined feedback mode -- see '/help /set mode'.\n\
   565 Where <mode> is the name of a previously defined feedback mode -- see '/help /set mode'.\n\
   552 Where <length> is an unsigned integer representing a maximum length.\n\
   566 Where <length> is an unsigned integer representing a maximum length.\n\
   553 Where <selector> is only needed if you wish to fine-tune value truncation length\n\
   567 Where <selector> is only needed if you wish to fine-tune value truncation length\n\
   554 by context, <selector> is the context in which the truncation is applied.\n\
   568 by context, <selector> is the context in which the truncation is applied.\n\
   569    replaced  -- an existing snippet has been replaced with a new snippet\n\
   583    replaced  -- an existing snippet has been replaced with a new snippet\n\
   570 Examples:\n\t\
   584 Examples:\n\t\
   571 /set trunc mymode 80\n\t\
   585 /set trunc mymode 80\n\t\
   572 /set truncation mymode 45 expression\n\t\
   586 /set truncation mymode 45 expression\n\t\
   573 /set truncation mymode 0 vardecl-modified,replaced\n\n\
   587 /set truncation mymode 0 vardecl-modified,replaced\n\n\
   574 Note that subsequent selectors for a field may overwrite some or all of previous used selectors -- last one wins\n
   588 Note that subsequent selectors for a field may overwrite some or all of previous used selectors -- last one wins\n\
       
   589 \n\
       
   590 The form without <length> shows the truncation settings.\n\
       
   591 When the <mode> is specified only the truncation settings for that mode are shown.\n\
       
   592 Example:\n\t\
       
   593 /set truncation myformat\n\
       
   594 shows the truncation settings for the mode myformat\n
   575 
   595 
   576 help.set.feedback = \
   596 help.set.feedback = \
   577 Set the feedback mode describing displayed feedback for entered snippets and commands.\n\
   597 Set the feedback mode describing displayed feedback for entered snippets and commands:\n\
   578 \n\t\
   598 \n\t\
   579 /set feedback <mode>\n\
   599 /set feedback [-retain] <mode>\n\
       
   600 \n\
       
   601 Retain the current feedback mode for future sessions:\n\
       
   602 \n\t\
       
   603 /set feedback -retain\n\
       
   604 \n\
       
   605 Show the feedback mode and list available modes:\n\
       
   606 \n\t\
       
   607 /set feedback\n\
   580 \n\
   608 \n\
   581 Where <mode> is the name of a previously defined feedback mode.\n\
   609 Where <mode> is the name of a previously defined feedback mode.\n\
   582 You may use just enough letters to make it unique.\n\
   610 You may use just enough letters to make it unique.\n\
   583 User-defined modes can be added, see '/help /set mode'\n\
   611 User-defined modes can be added, see '/help /set mode'\n\
   584 Currently defined feedback modes:\n
   612 \n\
       
   613 When the -retain option is used, the setting will be used in this and future\n\
       
   614 runs of the jshell tool.\n\
       
   615 \n\
       
   616 The form without <mode> or -retain displays the current feedback mode and available modes.\n
   585 
   617 
   586 help.set.mode = \
   618 help.set.mode = \
   587 Create a user-defined feedback mode, optionally copying from an existing mode.\n\
   619 Create a user-defined feedback mode, optionally copying from an existing mode:\n\
   588 \n\t\
   620 \n\t\
   589 /set mode <mode> [<old-mode>] [-command|-quiet|-delete]\n\
   621 /set mode <mode> [<old-mode>] [-command|-quiet|-delete]\n\
       
   622 Retain a user-defined feedback mode for future sessions:\n\
       
   623 \n\t\
       
   624 /set mode -retain <mode>\n\
       
   625 \n\
       
   626 Delete a user-defined feedback mode:\n\
       
   627 \n\t\
       
   628 /set mode -delete [-retain] <mode>\n\
       
   629 \n\
       
   630 Show feedback mode settings:\n\
       
   631 \n\t\
       
   632 /set mode [<mode>]\n\
   590 \n\
   633 \n\
   591 Where <new-mode> is the name of a mode you wish to create.\n\
   634 Where <new-mode> is the name of a mode you wish to create.\n\
   592 Where <old-mode> is the name of a previously defined feedback mode.\n\
   635 Where <old-mode> is the name of a previously defined feedback mode.\n\
   593 If <old-mode> is present, its settings are copied to the new mode.\n\
   636 If <old-mode> is present, its settings are copied to the new mode.\n\
   594 '-command' vs '-quiet' determines if informative/verifying command feedback is displayed.\n\
   637 '-command' vs '-quiet' determines if informative/verifying command feedback is displayed.\n\
   595 \n\
   638 \n\
   596 Once the new mode is created, use '/set format' and '/set prompt' to configure it.\n\
   639 Once the new mode is created, use '/set format', '/set prompt' and '/set truncation'\n\
   597 Use '/set feedback' to use the new mode.\n\
   640 to configure it.  Use '/set feedback' to use the new mode.\n\
       
   641 \n\
       
   642 When the -retain option is used, the mode (including its component prompt, format,\n\
       
   643 and truncation settings) will be used in this and future runs of the jshell tool.\n\
       
   644 When both -retain and -delete are used, the mode is deleted from the current\n\
       
   645 and future sessions.\n\
       
   646 \n\
       
   647 The form without options shows the mode settings.\n\
       
   648 When the <mode> is specified only the mode settings for that mode are shown.\n\
       
   649 Note: the settings for the mode include the settings for prompt, format, and\n\
       
   650 truncation -- so these are displayed as well.\n\
       
   651 Example:\n\t\
       
   652 /set mode myformat\n\
       
   653 shows the mode, prompt, format, and truncation settings for the mode myformat\n
   598 
   654 
   599 help.set.prompt = \
   655 help.set.prompt = \
   600 Set the prompts.  Both the normal prompt and the continuation-prompt must be set.\n\
   656 Set the prompts.  Both the normal prompt and the continuation-prompt must be set:\n\
   601 \n\t\
   657 \n\t\
   602 /set prompt <mode> \"<prompt>\" \"<continuation-prompt>\"\n\
   658 /set prompt <mode> \"<prompt>\" \"<continuation-prompt>\"\n\
       
   659 \n\
       
   660 Show the normal prompt and the continuation-prompts:\n\
       
   661 \n\t\
       
   662 /set prompt [<mode>]\n\
   603 \n\
   663 \n\
   604 Where <mode> is the name of a previously defined feedback mode.\n\
   664 Where <mode> is the name of a previously defined feedback mode.\n\
   605 Where <prompt> and <continuation-prompt> are quoted strings printed as input prompts;\n\
   665 Where <prompt> and <continuation-prompt> are quoted strings printed as input prompts;\n\
   606 Both may optionally contain '%s' which will be substituted with the next snippet id --\n\
   666 Both may optionally contain '%s' which will be substituted with the next snippet id --\n\
   607 note that what is entered may not be assigned that id, for example it may be an error or command.\n\
   667 note that what is entered may not be assigned that id, for example it may be an error or command.\n\
   608 The continuation-prompt is used on the second and subsequent lines of a multi-line snippet.\n
   668 The continuation-prompt is used on the second and subsequent lines of a multi-line snippet.\n\
       
   669 \n\
       
   670 The form without <prompt> shows the currently set prompts.\n\
       
   671 When the <mode> is specified only the prompts for that mode are shown.\n\
       
   672 Example:\n\t\
       
   673 /set prompt myformat\n\
       
   674 shows the prompts set for the mode myformat\n
   609 
   675 
   610 help.set.editor =\
   676 help.set.editor =\
   611 Specify the command to launch for the /edit command.\n\
   677 Specify the command to launch for the /edit command:\n\
   612 \n\t\
   678 \n\t\
   613 /set editor [-wait] <command>|-default\n\
   679 /set editor [-retain] [-wait] <command>\n\
       
   680 \n\t\
       
   681 /set editor [-retain] [-retain] -default\n\
       
   682 \n\
       
   683 Retain the current editor setting for future sessions:\n\
       
   684 \n\t\
       
   685 /set editor -retain\n\
       
   686 \n\
       
   687 Show the command to launch for the /edit command:\n\
       
   688 \n\t\
       
   689 /set editor\n\
   614 \n\
   690 \n\
   615 The <command> is an operating system dependent string.\n\
   691 The <command> is an operating system dependent string.\n\
   616 The <command> may include space-separated arguments (such as flags)\n\n\
   692 The <command> may include space-separated arguments (such as flags)\n\n\
   617 If the -default option is specified, the built-in default editor will be used.\n\n\
   693 If the -default option is specified, the built-in default editor will be used.\n\n\
   618 Otherwise an external editor should be specified in <command>. When <command>\n\
   694 Otherwise an external editor should be specified in <command>. When <command>\n\
   620 Normally, edit mode will last until the external editor exits. Some external editors\n\
   696 Normally, edit mode will last until the external editor exits. Some external editors\n\
   621 will exit immediately (for example, if the edit window exists) either external editor\n\
   697 will exit immediately (for example, if the edit window exists) either external editor\n\
   622 flags should be used to prevent immediate exit, or the -wait option should be used to\n\
   698 flags should be used to prevent immediate exit, or the -wait option should be used to\n\
   623 prompt the user to indicate when edit mode should end.\n\n\
   699 prompt the user to indicate when edit mode should end.\n\n\
   624 Note: while in edit mode no command inputs are seen.  After leaving edit mode changes\n\
   700 Note: while in edit mode no command inputs are seen.  After leaving edit mode changes\n\
   625 to the edited snippets are not seen.
   701 to the edited snippets are not seen.\n\
       
   702 \n\
       
   703 When the -retain option is used, the setting will be used in this and future\n\
       
   704 runs of the jshell tool.\n\
       
   705 \n\
       
   706 The form without <command> or options shows the editor setting.\n
   626 
   707 
   627 help.set.start =\
   708 help.set.start =\
   628 Set the start-up configuration -- a sequence of snippets and commands read at start-up.\n\
   709 Set the start-up configuration -- a sequence of snippets and commands read at start-up:\n\
   629 \n\t\
   710 \n\t\
   630 /set start <file>|-default|-none\n\
   711 /set start [-retain] <file>\n\
       
   712 \n\t\
       
   713 /set start [-retain] -default\n\
       
   714 \n\t\
       
   715 /set start [-retain] -none\n\
       
   716 \n\
       
   717 Retain the start-up configuration for future sessions:\n\
       
   718 \n\t\
       
   719 /set start -retain\n\
       
   720 \n\
       
   721 Show the start-up setting:\n\
       
   722 \n\t\
       
   723 /set start\n\
   631 \n\
   724 \n\
   632 The contents of the specified <file> become the start-up snippets and commands used\n\
   725 The contents of the specified <file> become the start-up snippets and commands used\n\
   633 when the /reset or /reload commands are used in this session.\n\
   726 when the /reset or /reload commands are used in this session.\n\
   634 If instead the -default option is specified, the predefined start-up snippets\n\
   727 If instead the -default option is specified, the predefined start-up snippets\n\
   635 will be used.\n\
   728 will be used.\n\
   636 If the -none option is used, the start-up will be empty -- no start-up snippets\n\
   729 If the -none option is used, the start-up will be empty -- no start-up snippets\n\
   637 or commands will be used.\n\
   730 or commands will be used.\n\
   638 This command is good for testing the start-up settings.  To retain them for future\n\
   731 This command is good for testing the start-up settings.  To retain them for future\n\
   639 runs of the jshell tool use the command:\n\t\
   732 runs of the jshell tool use the command:\n\t\
   640 /retain start\n
   733 /set start -retain\n\
   641 
   734 \n\
   642 help.retain.feedback = \
   735 When the -retain option is used, the setting will be used in this and future\n\
   643 Retain which feedback mode to use for displayed feedback for entered snippets and commands.\n\
   736 runs of the jshell tool.\n\
   644 This feedback mode will be used in this and future sessions of the jshell tool.\n\
   737 \n\
   645 \n\t\
   738 The form without <file> or options shows the start-up setting.\n\
   646 /retain feedback [<mode>]\n\
   739 Note: if the start-up was last set from a file, this is shown with the\n\
   647 \n\
   740 contents of the file followed by a 'set start' command.
   648 Where <mode> is the name of a previously defined feedback mode.\n\
       
   649 You may use just enough letters to make it unique.\n\
       
   650 If the <mode> is not specified, this command retains the current mode (as set\n\
       
   651 with the most recent /set feedback or /retain feedback command.)\n\
       
   652 
       
   653 help.retain.mode = \
       
   654 Retain the existence and configuration of a user-defined feedback mode.\n\
       
   655 This mode will be available in this and future sessions of the jshell tool.
       
   656 \n\t\
       
   657 /retain mode <mode>\n\
       
   658 \n\
       
   659 Where <mode> is the name of a mode you wish to retain.\n\
       
   660 The <mode> must previously have been created with /set mode and\n\
       
   661 configured as desired with /set prompt, /set format, and /set truncation.\n
       
   662 
       
   663 help.retain.editor =\
       
   664 Retain the command to launch for the /edit command.  This command will be invoked when\n\
       
   665 the /edit command is used in this and future sessions of the jshell tool.\n\
       
   666 \n\t\
       
   667 /retain editor [<command>|-default]\n\
       
   668 \n\
       
   669 If <command> is specified, it is an operating system dependent string which\n\
       
   670 may include space-separated arguments (such as flags). When /edit is used, the\n\
       
   671 temporary file to edit will be appended as the last argument.\n\
       
   672 If instead the -default option is specified, the built-in default editor will be used.\n\
       
   673 If neither is specified, the editor set in the last /set editor or /retain editor\n\
       
   674 command will be used.\n\
       
   675 The editor will be retained and used in this and future runs of the jshell tool.
       
   676 
       
   677 help.retain.start =\
       
   678 Retain the start-up configuration -- a sequence of snippets and commands read\n\
       
   679 at start-up.\n\
       
   680 \n\t\
       
   681 /retain start [<file>|-default|-none]\n\
       
   682 \n\
       
   683 If <file> is specified, the contents of the specified <file> become the\n\
       
   684 start-up snippets\n\
       
   685 and commands.\n\
       
   686 If instead the -default option is specified, the predefined start-up snippets\n\
       
   687 will be the start-up.\n\
       
   688 If the -none option is used, the start-up will be empty -- no start-up snippets\n\
       
   689 or commands will be used.\n\
       
   690 If none of these is specified, the start-up is the last specified in a\n\
       
   691 ''/set start'' or ''/retain start'' command.\n\
       
   692 The start-up will be retained and used when the jshell tool is started or reset
       
   693 
   741 
   694 startup.feedback = \
   742 startup.feedback = \
   695 /set mode verbose -command    \n\
   743 /set mode verbose -command    \n\
   696 \n\
   744 \n\
   697 /set prompt verbose '\\njshell> '   '   ...> '    \n\
   745 /set prompt verbose '\\njshell> '   '   ...> '    \n\
   771 \n\
   819 \n\
   772 /set feedback normal    \n\
   820 /set feedback normal    \n\
   773 \n\
   821 \n\
   774 /set mode silent -quiet    \n\
   822 /set mode silent -quiet    \n\
   775 /set prompt silent '-> ' '>> '    \n\
   823 /set prompt silent '-> ' '>> '    \n\
       
   824 /set truncation silent 80\n\
       
   825 /set truncation silent 1000                                                                  varvalue,expression\n\
   776 /set format silent pre '|  '    \n\
   826 /set format silent pre '|  '    \n\
   777 /set format silent post '%n'    \n\
   827 /set format silent post '%n'    \n\
   778 /set format silent errorpre '|  '    \n\
   828 /set format silent errorpre '|  '    \n\
   779 /set format silent errorpost '%n'    \n\
   829 /set format silent errorpost '%n'    \n\
   780 /set format silent display ''    \n
   830 /set format silent display ''    \n