Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: update REPL namespace documentation #2158

Merged
merged 1 commit into from
Apr 14, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion lib/node_modules/@stdlib/namespace/aliases/data/data.json

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion lib/node_modules/@stdlib/repl/code-blocks/data/data.json

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion lib/node_modules/@stdlib/repl/data/example.json
Original file line number Diff line number Diff line change
@@ -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"}
2 changes: 1 addition & 1 deletion lib/node_modules/@stdlib/repl/data/help.json

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion lib/node_modules/@stdlib/repl/data/info.json
Original file line number Diff line number Diff line change
@@ -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"}
Loading
Loading