Document $LOAD_PATH.resolve_feature_path in globals.rdoc

* RDoc does not seem to support documenting singleton object methods,
  and making $LOAD_PATH a class as a workaround is too weird.
This commit is contained in:
Benoit Daloze 2019-07-13 15:23:49 +02:00
Родитель b0f6f33094
Коммит 4a935bc6f6
3 изменённых файлов: 5 добавлений и 15 удалений

Просмотреть файл

@ -25,7 +25,10 @@ $$:: The process number of the Ruby running this script.
$?:: The status of the last executed child process. This value is
thread-local.
$LOAD_PATH:: Load path for scripts and binary modules by load or require.
Aliased to $: and $-I.
Aliased to $: and $-I. Has a singleton method
$LOAD_PATH.resolve_feature_path(feature) that returns
[:rb or :so, path], which resolves the feature to the path the
original Kernel#require method would load.
$LOADED_FEATURES:: The array contains the module names loaded by require.
Aliased to $".
$DEBUG:: The debug flag, which is set by the -d switch. Enabling debug

3
load.c
Просмотреть файл

@ -945,14 +945,13 @@ load_ext(VALUE path)
return (VALUE)dln_load(RSTRING_PTR(path));
}
/* Method is documented in vm.c */
static int
no_feature_p(const char *feature, const char *ext, int rb, int expanded, const char **fn)
{
return 0;
}
// Documented in doc/globals.rdoc
VALUE
rb_resolve_feature_path(VALUE klass, VALUE fname)
{

12
vm.c
Просмотреть файл

@ -2937,18 +2937,6 @@ static VALUE usage_analysis_operand_stop(VALUE self);
static VALUE usage_analysis_register_stop(VALUE self);
#endif
/*
* Document-method: RubyVM::resolve_feature_path
* call-seq:
* RubyVM.resolve_feature_path(feature) -> [:rb or :so, path]
*
* Identifies the file that will be loaded by "require(feature)".
* This API is experimental and just for internal use.
*
* RubyVM.resolve_feature_path("set")
* #=> [:rb, "/path/to/set.rb"]
*/
void
Init_VM(void)
{