docs: update REPL namespace documentation

PR-URL: #2158

Signed-off-by: stdlib-bot <82920195+stdlib-bot@users.noreply.github.com>
Co-authored-by: Philipp Burckhardt <pburckhardt@outlook.com>
Reviewed-by: Philipp Burckhardt <pburckhardt@outlook.com>

lib/node_modules/@stdlib/repl/data/example.json

@@ -1 +1 @@
-{"__done__":"function onTimeout() { __done__( null, 'foo' ) };\nvar res = setTimeout( onTimeout, 1000 )\n","require":"var crypto = require( 'crypto' )\n","alias2pkg":"var v = alias2pkg( 'base.sin' )\nvar v = alias2pkg( new Float64Array( 10 ) )\n","alias2related":"var v = alias2related( 'base.sin' )\nvar v = alias2related( new Float64Array( 10 ) )\n","ans":"ans\n","assignfrom":"workspace( 'foobar' );\nvar x = 3.14;\nworkspace( 'barfoo' );\nvar y = assignfrom( 'foobar', 'x' );\ny\n","assignin":"assignin( 'base', 'x', 3.14 );\nx\n","citation":"citation()\n","clear":"clear()\n","clearHistory":"clearHistory()\n","clearUserDocs":"function foo() {};\nuserDoc( 'foo', foo, '\\nfoo()\\n    Foo bar.\\n' );\nhelp( foo )\nclearUserDocs();\nhelp( foo )\n","clearVars":"var x = 3.14;\nx\nclearVars();\nx\n","clearWorkspace":"workspace( 'foobar' );\nvar x = 3.14;\nworkspace( 'barfoo' );\ntypeof x\nvarsWorkspace( 'foobar' )\nclearWorkspace( 'foobar' );\nvarsWorkspace( 'foobar' )\nworkspace( 'foobar' );\nx\n","contributors":"credits()\n","copyright":"copyright()\n","credits":"credits()\n","currentWorkspace":"currentWorkspace\n","deeprerequire":"var foo = require( './foo.js' );\nfoo = deeprerequire( './foo.js' );\n","deleteWorkspace":"workspace( 'foobar' );\nvar x = 3.14;\nworkspace( 'barfoo' );\nworkspaces()\ndeleteWorkspace( 'foobar' );\nworkspaces()\n","donate":"donate()\n","evalin":"workspace( 'foobar' );\nworkspace( 'barfoo' );\nevalin( 'foobar', 'var x = 3.14;' );\nx\nworkspace( 'foobar' );\nx\n","example":"example( base.sin )\nexample( 'base.sin' )\nexample( isString.isPrimitive )\nexample( 'isString.isPrimitive' )\nexample( new Float64Array( 10 ) )\n","global":"global\n","help":"help()\nhelp( help )\nhelp( 'help' )\nhelp( isString.isPrimitive )\nhelp( 'isString.isPrimitive' )\nhelp( new Float64Array( 10 ) )\n","info":"info( base.sin )\ninfo( 'base.sin' )\ninfo( isString.isPrimitive )\ninfo( 'isString.isPrimitive' )\ninfo( new Float64Array( 10 ) )\n","isKeyword":"isKeyword( 'Float64Array' )\nisKeyword( 'beep_boop_bop_bip_foo_bar' )\n","isWorkspace":"isWorkspace( 'base' )\nisWorkspace( /^presentation/ )\n","license":"license()\n","load":"load( './path/to/file.js' )\n","loadWorkspace":"workspace( 'foobar' );\nvar x = 3.14;\nworkspace( 'barfoo' );\ntypeof x\nloadWorkspace( 'foobar' );\nx\n","logStart":"var id = logStart( './path/to/file.txt' );\n1 + 1\n'foo'\nlogStop( id );\n","logStop":"var id = logStart( './path/to/file.txt' );\n1 + 1\n'foo'\nlogStop( id );\n","presentationStart":"var id = presentationStart( 'beep\\n---boop\\n' );\n","presentationStop":"var id = presentationStart( 'beep\\n---\\nboop\\n' );\npresentationStop();\n","quit":"quit()\n","renameWorkspace":"workspace( 'foobar' );\nvar x = 3.14;\nworkspaces()\nworkspace( 'barfoo' );\nworkspaces()\nrenameWorkspace( 'foobar', 'beepboop' );\nworkspaces()\nworkspace( 'beepboop' );\nx\n","rerequire":"var foo = require( './foo.js' );\nfoo = rerequire( './foo.js' );\n","rerun":"1+1\nrerun()\n","reset":"reset()\n","save":"save( './path/to/file.txt' )\n","saveStart":"var id = saveStart( './path/to/file.txt' );\n1 + 1\n'foo'\nsaveStop( id );\n","saveStop":"var id = saveStart( './path/to/file.txt' );\n1 + 1\n'foo'\nsaveStop( id );\n","tutorial":"var id = tutorial( 'repl' );\n","userDoc":"function foo() {};\nuserDoc( 'foo', foo, '\\nfoo()\\n    Foo bar.\\n' );\nhelp( foo )\n","vars":"vars()\nvars( { 'details': true } )\n","varsWorkspace":"varsWorkspace()\nvarsWorkspace( 'base' )\nvarsWorkspace( { 'details': true } )\n","workspace":"workspace( 'foobar' );\nvar x = 3.14;\nworkspace( 'beepboop' );\nx\n","workspaces":"workspaces()\nworkspaces( { 'details': true } )\n"}
+{"__done__":"function onTimeout() { __done__( null, 'foo' ) };\nvar res = setTimeout( onTimeout, 1000 )\n","require":"var crypto = require( 'crypto' )\n","alias2pkg":"var v = alias2pkg( 'base.sin' )\nvar v = alias2pkg( new Float64Array( 10 ) )\n","alias2related":"var v = alias2related( 'base.sin' )\nvar v = alias2related( new Float64Array( 10 ) )\n","ans":"ans\n","assignfrom":"workspace( 'foobar' );\nvar x = 3.14;\nworkspace( 'barfoo' );\nvar y = assignfrom( 'foobar', 'x' );\ny\n","assignin":"assignin( 'base', 'x', 3.14 );\nx\n","citation":"citation()\n","clear":"clear()\n","clearHistory":"clearHistory()\n","clearUserDocs":"function foo() {};\nuserDoc( 'foo', foo, '\\nfoo()\\n    Foo bar.\\n' );\nhelp( foo )\nclearUserDocs();\nhelp( foo )\n","clearVars":"var x = 3.14;\nx\nclearVars();\nx\n","clearWorkspace":"workspace( 'foobar' );\nvar x = 3.14;\nworkspace( 'barfoo' );\ntypeof x\nvarsWorkspace( 'foobar' )\nclearWorkspace( 'foobar' );\nvarsWorkspace( 'foobar' )\nworkspace( 'foobar' );\nx\n","contributors":"credits()\n","copyright":"copyright()\n","credits":"credits()\n","currentWorkspace":"currentWorkspace\n","deeprerequire":"var foo = require( './foo.js' );\nfoo = deeprerequire( './foo.js' );\n","deleteWorkspace":"workspace( 'foobar' );\nvar x = 3.14;\nworkspace( 'barfoo' );\nworkspaces()\ndeleteWorkspace( 'foobar' );\nworkspaces()\n","donate":"donate()\n","evalin":"workspace( 'foobar' );\nworkspace( 'barfoo' );\nevalin( 'foobar', 'var x = 3.14;' );\nx\nworkspace( 'foobar' );\nx\n","example":"example( base.sin )\nexample( 'base.sin' )\nexample( isString.isPrimitive )\nexample( 'isString.isPrimitive' )\nexample( new Float64Array( 10 ) )\n","global":"global\n","help":"help()\nhelp( help )\nhelp( 'help' )\nhelp( isString.isPrimitive )\nhelp( 'isString.isPrimitive' )\nhelp( new Float64Array( 10 ) )\n","info":"info( base.sin )\ninfo( 'base.sin' )\ninfo( isString.isPrimitive )\ninfo( 'isString.isPrimitive' )\ninfo( new Float64Array( 10 ) )\n","isKeyword":"isKeyword( 'Float64Array' )\nisKeyword( 'beep_boop_bop_bip_foo_bar' )\n","isWorkspace":"isWorkspace( 'base' )\nisWorkspace( /^presentation/ )\n","license":"license()\n","load":"load( './path/to/file.js' )\n","loadWorkspace":"workspace( 'foobar' );\nvar x = 3.14;\nworkspace( 'barfoo' );\ntypeof x\nloadWorkspace( 'foobar' );\nx\n","logStart":"var id = logStart( './path/to/file.txt' );\n1 + 1\n'foo'\nlogStop( id );\n","logStop":"var id = logStart( './path/to/file.txt' );\n1 + 1\n'foo'\nlogStop( id );\n","presentationStart":"var id = presentationStart( 'beep\\n---boop\\n' );\n","presentationStop":"var id = presentationStart( 'beep\\n---\\nboop\\n' );\npresentationStop();\n","quit":"quit()\n","renameWorkspace":"workspace( 'foobar' );\nvar x = 3.14;\nworkspaces()\nworkspace( 'barfoo' );\nworkspaces()\nrenameWorkspace( 'foobar', 'beepboop' );\nworkspaces()\nworkspace( 'beepboop' );\nx\n","rerequire":"var foo = require( './foo.js' );\nfoo = rerequire( './foo.js' );\n","rerun":"1+1\nrerun()\n","reset":"reset()\n","save":"save( './path/to/file.txt' )\n","saveStart":"var id = saveStart( './path/to/file.txt' );\n1 + 1\n'foo'\nsaveStop( id );\n","saveStop":"var id = saveStart( './path/to/file.txt' );\n1 + 1\n'foo'\nsaveStop( id );\n","tutorial":"var id = tutorial( 'repl' );\n","userDoc":"function foo() {};\nuserDoc( 'foo', foo, '\\nfoo()\\n    Foo bar.\\n' );\nhelp( foo )\n","vars":"vars()\nvars( { 'details': true } )\n","varsWorkspace":"varsWorkspace()\nvarsWorkspace( 'base' )\nvarsWorkspace( { 'details': true } )\n","workspace":"workspace( 'foobar' );\nvar x = 3.14;\nworkspace( 'beepboop' );\nx\n","workspaces":"workspaces()\nworkspaces( { 'details': true } )\n"}

lib/node_modules/@stdlib/repl/data/info.json

@@ -1 +1 @@
-{"__done__":"\n__done__( [error:Error|null[, results:any]] )\n    Callback invoked to confirm that an asynchronous command has finished\n    executing.\n","require":"\nrequire( id:string )\n    Imports a module, JSON, or local file.\n","alias2pkg":"\nalias2pkg( alias:any )\n    Returns the package name associated with a provided alias.\n\nalias2pkg( instance:any )\n    Returns the package name associated with a provided class instance.\n","alias2related":"\nalias2related( alias:any )\n    Returns aliases related to a specified alias.\n\nalias2related( instance:any )\n    Returns aliases associated with a provided class instance.\n","ans":"\nans\n    Result of the last successfully executed command.\n","assignfrom":"\nassignfrom( workspace:string, variable:string|symbol )\n    Reads a value from a specified workspace.\n","assignin":"\nassignin( workspace:string, variable:string|symbol, value:any )\n    Assigns a value to a variable in a specified workspace.\n","citation":"\ncitation()\n    Prints how to cite stdlib in publications.\n","clear":"\nclear()\n    Clears the entire REPL screen and scrollback history.\n","clearHistory":"\nclearHistory()\n    Clears the REPL history.\n","clearUserDocs":"\nclearUserDocs( [options] )\n    Deletes user-defined documentation.\n","clearVars":"\nclearVars( [options] )\n    Deletes user-defined variables in the current workspace.\n","clearWorkspace":"\nclearWorkspace( [name, ][options] )\n    Deletes user-defined variables in a specified workspace.\n","contributors":"\ncontributors()\n    Prints the list of contributors.\n","copyright":"\ncopyright()\n    Prints copyright information.\n","credits":"\ncredits()\n    Prints credits.\n","currentWorkspace":"\ncurrentWorkspace\n    Name of the current workspace.\n","deeprerequire":"\ndeeprerequire( id:string )\n    Re-imports a module, JSON, or local file and all its associated module\n    dependencies.\n","deleteWorkspace":"\ndeleteWorkspace( [name:string] )\n    Deletes a workspace.\n","donate":"\ndonate()\n    Prints donation information.\n","evalin":"\nevalin( workspace:string, expression:string )\n    Evaluates an expression in a specified workspace.\n","example":"\nexample( alias:any )\n    Runs examples for a specified alias.\n\nexample( property:any )\n    Runs examples for a specified property.\n\nexample( instance:any )\n    Runs examples for a provided class instance.\n","global":"\nglobal\n    Global namespace object.\n","help":"\nhelp()\n    Prints help text.\n\nhelp( alias:any )\n    Prints help text for a specified alias.\n\nhelp( property:any )\n    Prints help text for a specified property.\n\nhelp( instance:any )\n    Prints help text for a provided class instance.\n","info":"\ninfo( alias:any )\n    Prints abbreviated help text for a specified alias.\n\ninfo( property:any )\n    Prints abbreviated help text for a specified property.\n\ninfo( instance:any )\n    Prints abbreviated help text for a provided class instance.\n","isKeyword":"\nisKeyword( keyword:string )\n    Returns a boolean indicating whether a string is a reserved keyword in the\n    REPL environment.\n","isWorkspace":"\nisWorkspace( name:string|RegExp )\n    Returns a boolean indicating whether a specified workspace exists.\n","license":"\nlicense()\n    Prints license information.\n","load":"\nload( fpath:string )\n    Loads and evaluates a JavaScript file, such as a REPL history file, line-by-\n    line.\n","loadWorkspace":"\nloadWorkspace( name[, options] )\n    Loads variables from a specified workspace into the current workspace.\n","logStart":"\nlogStart( fpath:string )\n    Starts logging commands and printed output to a specified file path.\n","logStop":"\nlogStop( id:number )\n    Stops logging commands and printed output to a file path associated with a\n    specified record identifier.\n","presentationStart":"\npresentationStart( [text:string, ][options:Object] )\n    Starts a REPL presentation.\n","presentationStop":"\npresentationStop( [id:number|string] )\n    Stops a REPL presentation.\n","quit":"\nquit()\n    Exits the REPL.\n","renameWorkspace":"\nrenameWorkspace( oldName:string, newName:string )\n    Renames a workspace.\n","rerequire":"\nrerequire( id:string )\n    Re-imports a module, JSON, or local file.\n","rerun":"\nrerun( [arg] )\n    Reruns previous commands.\n","reset":"\nreset()\n    Resets the REPL.\n","save":"\nsave( fpath:string )\n    Saves previous commands to a specified file path.\n","saveStart":"\nsaveStart( fpath:string )\n    Starts saving commands to a specified file path.\n","saveStop":"\nsaveStop( id:number )\n    Stops saving commands to a file path associated with a specified record\n    identifier.\n","tutorial":"\ntutorial( [name:string, [options:Object]] )\n    Starts a tutorial.\n","userDoc":"\nuserDoc( alias:string, [ref:any,] doc:string )\n    Adds user-defined documentation.\n","vars":"\nvars( [options] )\n    Returns a list of variable names in the current workspace.\n","varsWorkspace":"\nvarsWorkspace( [name, ][options] )\n    Returns a list of variable names in a specified workspace.\n","workspace":"\nworkspace( name:string )\n    Switches to a specified workspace.\n","workspaces":"\nworkspaces( [options] )\n    Returns a list of workspace names.\n"}
+{"__done__":"\n__done__( [error:Error|null[, results:any]] )\n    Callback invoked to confirm that an asynchronous command has finished\n    executing.\n","require":"\nrequire( id:string )\n    Imports a module, JSON, or local file.\n","alias2pkg":"\nalias2pkg( alias:any )\n    Returns the package name associated with a provided alias.\n\nalias2pkg( instance:any )\n    Returns the package name associated with a provided class instance.\n","alias2related":"\nalias2related( alias:any )\n    Returns aliases related to a specified alias.\n\nalias2related( instance:any )\n    Returns aliases associated with a provided class instance.\n","ans":"\nans\n    Result of the last successfully executed command.\n","assignfrom":"\nassignfrom( workspace:string, variable:string|symbol )\n    Reads a value from a specified workspace.\n","assignin":"\nassignin( workspace:string, variable:string|symbol, value:any )\n    Assigns a value to a variable in a specified workspace.\n","citation":"\ncitation()\n    Prints how to cite stdlib in publications.\n","clear":"\nclear()\n    Clears the entire REPL screen and scrollback history.\n","clearHistory":"\nclearHistory()\n    Clears the REPL history.\n","clearUserDocs":"\nclearUserDocs( [options] )\n    Deletes user-defined documentation.\n","clearVars":"\nclearVars( [options] )\n    Deletes user-defined variables in the current workspace.\n","clearWorkspace":"\nclearWorkspace( [name, ][options] )\n    Deletes user-defined variables in a specified workspace.\n","contributors":"\ncontributors()\n    Prints the list of contributors.\n","copyright":"\ncopyright()\n    Prints copyright information.\n","credits":"\ncredits()\n    Prints credits.\n","currentWorkspace":"\ncurrentWorkspace\n    Name of the current workspace.\n","deeprerequire":"\ndeeprerequire( id:string )\n    Re-imports a module, JSON, or local file and all its associated module\n    dependencies.\n","deleteWorkspace":"\ndeleteWorkspace( [name:string] )\n    Deletes a workspace.\n","donate":"\ndonate()\n    Prints donation information.\n","evalin":"\nevalin( workspace:string, expression:string )\n    Evaluates an expression in a specified workspace.\n","example":"\nexample( alias:any )\n    Runs examples for a specified alias.\n\nexample( property:any )\n    Runs examples for a specified property.\n\nexample( instance:any )\n    Runs examples for a provided class instance.\n","global":"\nglobal\n    Global namespace object.\n","help":"\nhelp()\n    Prints help text.\n\nhelp( alias:any )\n    Prints help text for a specified alias.\n\nhelp( property:any )\n    Prints help text for a specified property.\n\nhelp( instance:any )\n    Prints help text for a provided class instance.\n","info":"\ninfo( alias:any )\n    Prints abbreviated help text for a specified alias.\n\ninfo( property:any )\n    Prints abbreviated help text for a specified property.\n\ninfo( instance:any )\n    Prints abbreviated help text for a provided class instance.\n","isKeyword":"\nisKeyword( keyword:string )\n    Returns a boolean indicating whether a string is a reserved keyword in the\n    REPL environment.\n","isWorkspace":"\nisWorkspace( name:string|RegExp )\n    Returns a boolean indicating whether a specified workspace exists.\n","license":"\nlicense()\n    Prints license information.\n","load":"\nload( fpath:string )\n    Loads and evaluates a JavaScript file, such as a REPL history file, line-by-\n    line.\n","loadWorkspace":"\nloadWorkspace( name[, options] )\n    Loads variables from a specified workspace into the current workspace.\n","logStart":"\nlogStart( fpath:string )\n    Starts logging commands and printed output to a specified file path.\n","logStop":"\nlogStop( id:number )\n    Stops logging commands and printed output to a file path associated with a\n    specified record identifier.\n","presentationStart":"\npresentationStart( [text:string, ][options:Object] )\n    Starts a REPL presentation.\n","presentationStop":"\npresentationStop( [id:number|string] )\n    Stops a REPL presentation.\n","quit":"\nquit()\n    Exits the REPL.\n","renameWorkspace":"\nrenameWorkspace( oldName:string, newName:string )\n    Renames a workspace.\n","rerequire":"\nrerequire( id:string )\n    Re-imports a module, JSON, or local file.\n","rerun":"\nrerun( [arg] )\n    Reruns previous commands.\n","reset":"\nreset()\n    Resets the REPL.\n","save":"\nsave( fpath:string )\n    Saves previous commands to a specified file path.\n","saveStart":"\nsaveStart( fpath:string )\n    Starts saving commands to a specified file path.\n","saveStop":"\nsaveStop( id:number )\n    Stops saving commands to a file path associated with a specified record\n    identifier.\n","tutorial":"\ntutorial( [name:string, [options:Object]] )\n    Starts a tutorial.\n","userDoc":"\nuserDoc( alias:string, [ref:any,] doc:string )\n    Adds user-defined documentation.\n","vars":"\nvars( [options] )\n    Returns a list of variable names in the current workspace.\n","varsWorkspace":"\nvarsWorkspace( [name, ][options] )\n    Returns a list of variable names in a specified workspace.\n","workspace":"\nworkspace( name:string )\n    Switches to a specified workspace.\n","workspaces":"\nworkspaces( [options] )\n    Returns a list of workspace names.\n"}