Skip to content

Commit

Permalink
[DOC] RDoc for module IRB (#738)
Browse files Browse the repository at this point in the history
[DOC] RDoc for module IRB
  • Loading branch information
BurdetteLamar authored Dec 12, 2023
1 parent 3436bdc commit f3a0626
Show file tree
Hide file tree
Showing 7 changed files with 1,069 additions and 197 deletions.
2 changes: 1 addition & 1 deletion .document
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
LICENSE.txt
README.md
doc
doc/irb/indexes.rdoc
lib/**/*.rb
1 change: 0 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,6 @@
/.yardoc
/_yardoc/
/coverage/
/doc/
/pkg/
/spec/reports/
/tmp/
Expand Down
190 changes: 190 additions & 0 deletions doc/irb/indexes.rdoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,190 @@
== Indexes

=== Index of Command-Line Options

These are the \IRB command-line options, with links to explanatory text:

- <tt>-d</tt>: Set <tt>$DEBUG</tt> and {$VERBOSE}[rdoc-ref:IRB@Verbosity]
to +true+.
- <tt>-E _ex_[:_in_]</tt>: Set initial external (ex) and internal (in)
{encodings}[rdoc-ref:IRB@Encodings] (same as <tt>ruby -E></tt>).
- <tt>-f</tt>: Don't initialize from {configuration file}[rdoc-ref:IRB@Configuration+File].
- <tt>-I _dirpath_</tt>: Specify {$LOAD_PATH directory}[rdoc-ref:IRB@Load+Modules]
(same as <tt>ruby -I</tt>).
- <tt>-r _load-module_</tt>: Require {load-module}[rdoc-ref:IRB@Load+Modules]
(same as <tt>ruby -r</tt>).
- <tt>-U</tt>: Set external and internal {encodings}[rdoc-ref:IRB@Encodings] to UTF-8.
- <tt>-w</tt>: Suppress {warnings}[rdoc-ref:IRB@Warnings] (same as <tt>ruby -w</tt>).
- <tt>-W[_level_]</tt>: Set {warning level}[rdoc-ref:IRB@Warnings];
0=silence, 1=medium, 2=verbose (same as <tt>ruby -W</tt>).
- <tt>--autocomplete</tt>: Use {auto-completion}[rdoc-ref:IRB@Automatic+Completion].
- <tt>--back-trace-limit _n_</tt>: Set a {backtrace limit}[rdoc-ref:IRB@Tracer];
display at most the top +n+ and bottom +n+ entries.
- <tt>--colorize</tt>: Use {color-highlighting}[rdoc-ref:IRB@Color+Highlighting]
for input and output.
- <tt>--context-mode _n_</tt>: Select method to create Binding object
for new {workspace}[rdoc-ref:IRB@Commands]; +n+ in range <tt>0..4</tt>.
- <tt>--echo</tt>: Print ({echo}[rdoc-ref:IRB@Return-Value+Printing+-28Echoing-29])
return values.
- <tt>--extra-doc-dir _dirpath_</tt>:
Add a {documentation directory}[rdoc-ref:IRB@RI+Documentation+Directories]
for the documentation dialog.
- <tt>--inf-ruby-mode</tt>: Set prompt mode to {:INF_RUBY}[rdoc-ref:IRB@Pre-Defined+Prompts]
(appropriate for +inf-ruby-mode+ on Emacs);
suppresses --multiline and --singleline.
- <tt>--inspect</tt>: Use method +inspect+ for printing ({echoing}[rdoc-ref:IRB@Return-Value+Printing+-28Echoing-29])
return values.
- <tt>--multiline</tt>: Use the multiline editor as the {input method}[rdoc-ref:IRB@Input+Method].
- <tt>--noautocomplete</tt>: Don't use {auto-completion}[rdoc-ref:IRB@Automatic+Completion].
- <tt>--nocolorize</tt>: Don't use {color-highlighting}[rdoc-ref:IRB@Color+Highlighting]
for input and output.
- <tt>--noecho</tt>: Don't print ({echo}[rdoc-ref:IRB@Return-Value+Printing+-28Echoing-29])
return values.
- <tt>--noecho-on-assignment</tt>: Don't print ({echo}[rdoc-ref:IRB@Return-Value+Printing+-28Echoing-29])
result on assignment.
- <tt>--noinspect</tt>: Don't se method +inspect+ for printing ({echoing}[rdoc-ref:IRB@Return-Value+Printing+-28Echoing-29])
return values.
- <tt>--nomultiline</tt>: Don't use the multiline editor as the {input method}[rdoc-ref:IRB@Input+Method].
- <tt>--noprompt</tt>: Don't print {prompts}[rdoc-ref:IRB@Prompt+and+Return+Formats].
- <tt>--noscript</tt>: Treat the first command-line argument as a normal
{command-line argument}[rdoc-ref:IRB@Initialization+Script],
and include it in +ARGV+.
- <tt>--nosingleline</tt>: Don't use the singleline editor as the {input method}[rdoc-ref:IRB@Input+Method].
- <tt>--noverbose</tt>Don't print {verbose}[rdoc-ref:IRB@Verbosity] details.
- <tt>--prompt _mode_</tt>, <tt>--prompt-mode _mode_</tt>:
Set {prompt and return formats}[rdoc-ref:IRB@Prompt+and+Return+Formats];
+mode+ may be a {pre-defined prompt}[rdoc-ref:IRB@Pre-Defined+Prompts]
or the name of a {custom prompt}[rdoc-ref:IRB@Custom+Prompts].
- <tt>--script</tt>: Treat the first command-line argument as the path to an
{initialization script}[rdoc-ref:IRB@Initialization+Script],
and omit it from +ARGV+.
- <tt>--simple-prompt</tt>, <tt>--sample-book-mode</tt>:
Set prompt mode to {:SIMPLE}[rdoc-ref:IRB@Pre-Defined+Prompts].
- <tt>--singleline</tt>: Use the singleline editor as the {input method}[rdoc-ref:IRB@Input+Method].
- <tt>--tracer</tt>: Use {Tracer}[rdoc-ref:IRB@Tracer] to print a stack trace for each input command.
- <tt>--truncate-echo-on-assignment</tt>: Print ({echo}[rdoc-ref:IRB@Return-Value+Printing+-28Echoing-29])
truncated result on assignment.
- <tt>--verbose</tt>Print {verbose}[rdoc-ref:IRB@Verbosity] details.
- <tt>-v</tt>, <tt>--version</tt>: Print the {IRB version}[rdoc-ref:IRB@Version].
- <tt>-h</tt>, <tt>--help</tt>: Print the {IRB help text}[rdoc-ref:IRB@Help].
- <tt>--</tt>: Separate options from {arguments}[rdoc-ref:IRB@Command-Line+Arguments]
on the command-line.

=== Index of \IRB.conf Entries

These are the keys for hash \IRB.conf entries, with links to explanatory text;
for each entry that is pre-defined, the initial value is given:

- <tt>:AP_NAME</tt>: \IRB {application name}[rdoc-ref:IRB@Application+Name];
initial value: <tt>'irb'</tt>.
- <tt>:AT_EXIT</tt>: Array of hooks to call
{at exit}[rdoc-ref:IRB@IRB];
initial value: <tt>[]</tt>.
- <tt>:AUTO_INDENT</tt>: Whether {automatic indentation}[rdoc-ref:IRB@Automatic+Indentation]
is enabled; initial value: +true+.
- <tt>:BACK_TRACE_LIMIT</tt>: Sets the {back trace limit}[rdoc-ref:IRB@Tracer];
initial value: +16+.
- <tt>:COMMAND_ALIASES</tt>: Defines input {command aliases}[rdoc-ref:IRB@Command+Aliases];
initial value:

{
"$": :show_source,
"@": :whereami,
}

- <tt>:CONTEXT_MODE</tt>: Sets the {context mode}[rdoc-ref:IRB@Context+Mode],
the type of binding to be used when evaluating statements;
initial value: +4+.
- <tt>:ECHO</tt>: Whether to print ({echo}[rdoc-ref:IRB@Return-Value+Printing+-28Echoing-29])
return values;
initial value: +nil+, which would set +conf.echo+ to +true+.
- <tt>:ECHO_ON_ASSIGNMENT</tt>: Whether to print ({echo}[rdoc-ref:IRB@Return-Value+Printing+-28Echoing-29])
return values on assignment;
initial value: +nil+, which would set +conf.echo_on_assignment+ to +:truncate+.
- <tt>:EVAL_HISTORY</tt>: How much {evaluation history}[rdoc-ref:IRB@Evaluation+History]
is to be stored; initial value: +nil+.
- <tt>:EXTRA_DOC_DIRS</tt>: \Array of
{RI documentation directories}[rdoc-ref:IRB@RI+Documentation+Directories]
to be parsed for the documentation dialog;
initial value: <tt>[]</tt>.
- <tt>:IGNORE_EOF</tt>: Whether to ignore {end-of-file}[rdoc-ref:IRB@End-of-File];
initial value: +false+.
- <tt>:IGNORE_SIGINT</tt>: Whether to ignore {SIGINT}[rdoc-ref:IRB@SIGINT];
initial value: +true+.
- <tt>:INSPECT_MODE</tt>: Whether to use method +inspect+ for printing
({echoing}[rdoc-ref:IRB@Return-Value+Printing+-28Echoing-29]) return values;
initial value: +true+.
- <tt>:IRB_LIB_PATH</tt>: The path to the {IRB library directory}[rdoc-ref:IRB@IRB+Library+Directory]; initial value:
<tt>"<i>RUBY_DIR</i>/lib/ruby/gems/<i>RUBY_VER_NUM</i>/gems/irb-<i>IRB_VER_NUM</i>/lib/irb"</tt>,
where:

- <i>RUBY_DIR</i> is the Ruby installation dirpath.
- <i>RUBY_VER_NUM</i> is the Ruby version number.
- <i>IRB_VER_NUM</i> is the \IRB version number.

- <tt>:IRB_NAME</tt>: {IRB name}[rdoc-ref:IRB@IRB+Name];
initial value: <tt>'irb'</tt>.
- <tt>:IRB_RC</tt>: {Configuration monitor}[rdoc-ref:IRB@Configuration+Monitor];
initial value: +nil+.
- <tt>:LC_MESSAGES</tt>: {Locale}[rdoc-ref:IRB@Locale];
initial value: IRB::Locale object.
- <tt>:LOAD_MODULES</tt>: deprecated.
- <tt>:MAIN_CONTEXT</tt>: The {context}[rdoc-ref:IRB@Session+Context] for the main \IRB session;
initial value: IRB::Context object.
- <tt>:MEASURE</tt>: Whether to
{measure performance}[rdoc-ref:IRB@Performance+Measurement];
initial value: +false+.
- <tt>:MEASURE_CALLBACKS</tt>: Callback methods for
{performance measurement}[rdoc-ref:IRB@Performance+Measurement];
initial value: <tt>[]</tt>.
- <tt>:MEASURE_PROC</tt>: Procs for
{performance measurement}[rdoc-ref:IRB@Performance+Measurement];
initial value:

{
:TIME=>#<Proc:0x0000556e271c6598 /var/lib/gems/3.0.0/gems/irb-1.8.3/lib/irb/init.rb:106>,
:STACKPROF=>#<Proc:0x0000556e271c6548 /var/lib/gems/3.0.0/gems/irb-1.8.3/lib/irb/init.rb:116>
}

- <tt>:PROMPT</tt>: \Hash of {defined prompts}[rdoc-ref:IRB@Prompt+and+Return+Formats];
initial value:

{
:NULL=>{:PROMPT_I=>nil, :PROMPT_S=>nil, :PROMPT_C=>nil, :RETURN=>"%s\n"},
:DEFAULT=>{:PROMPT_I=>"%N(%m):%03n> ", :PROMPT_S=>"%N(%m):%03n%l ", :PROMPT_C=>"%N(%m):%03n* ", :RETURN=>"=> %s\n"},
:CLASSIC=>{:PROMPT_I=>"%N(%m):%03n:%i> ", :PROMPT_S=>"%N(%m):%03n:%i%l ", :PROMPT_C=>"%N(%m):%03n:%i* ", :RETURN=>"%s\n"},
:SIMPLE=>{:PROMPT_I=>">> ", :PROMPT_S=>"%l> ", :PROMPT_C=>"?> ", :RETURN=>"=> %s\n"},
:INF_RUBY=>{:PROMPT_I=>"%N(%m):%03n> ", :PROMPT_S=>nil, :PROMPT_C=>nil, :RETURN=>"%s\n", :AUTO_INDENT=>true},
:XMP=>{:PROMPT_I=>nil, :PROMPT_S=>nil, :PROMPT_C=>nil, :RETURN=>" ==>%s\n"}
}

- <tt>:PROMPT_MODE</tt>: Name of {current prompt}[rdoc-ref:IRB@Prompt+and+Return+Formats];
initial value: +:DEFAULT+.
- <tt>:RC</tt>: Whether a {configuration file}[rdoc-ref:IRB@Configuration+File]
was found and interpreted;
initial value: +true+ if a configuration file was found, +false+ otherwise.
- <tt>:RC_NAME_GENERATOR</tt>: \Proc to generate paths of potential
{configuration files}[rdoc-ref:IRB@Configuration+File];
initial value: <tt>=> #<Proc:0x000055f9bebfed80 /var/lib/gems/3.0.0/gems/irb-1.8.3/lib/irb/init.rb:401></tt>.
- <tt>:SAVE_HISTORY</tt>: Number of commands to save in
{input command history}[rdoc-ref:IRB@Input+Command+History];
initial value: +1000+.
- <tt>:SINGLE_IRB</tt>: Whether command-line option <tt>--single-irb</tt> was given;
initial value: +true+ if the option was given, +false+ otherwise.
See {Single-IRB Mode}[rdoc-ref:IRB@Single-IRB+Mode].
- <tt>:USE_AUTOCOMPLETE</tt>: Whether to use
{automatic completion}[rdoc-ref:IRB@Automatic+Completion];
initial value: +true+.
- <tt>:USE_COLORIZE</tt>: Whether to use
{color highlighting}[rdoc-ref:IRB@Color+Highlighting];
initial value: +true+.
- <tt>:USE_LOADER</tt>: Whether to use the
{IRB loader}[rdoc-ref:IRB@IRB+Loader] for +require+ and +load+;
initial value: +false+.
- <tt>:USE_TRACER</tt>: Whether to use the
{IRB tracer}[rdoc-ref:IRB@Tracer];
initial value: +false+.
- <tt>:VERBOSE</tt>: Whether to print {verbose output}[rdoc-ref:IRB@Verbosity];
initial value: +nil+.
- <tt>:__MAIN__</tt>: The main \IRB object;
initial value: +main+.
Loading

0 comments on commit f3a0626

Please sign in to comment.