From: ko1@... Date: 2017-07-13T02:31:33+00:00 Subject: [ruby-core:82016] [Ruby trunk Feature#13740] [PATCH] doc/extension.rdoc: start entries for threading and IO Issue #13740 has been updated by ko1 (Koichi Sasada). > void *rb_thread_call_without_gvl(void *(*func)(void *), void *data1, rb_unblock_function_t *ubf, void *data2) :: You need to mention that `func` is not allowed to call any `rb_` functions (there are exceptions but it should be used carefully). IMO this function is to danger so that I recommend to remove an explanation and only reference to the commented document in thread.c. At least, we need to emphasize the danger of this API. > int rb_io_wait_readable(int fd) :: I'm not expert on this area so this is only a question. Can we support `fd` on our documented (may it means we encourage to use them) APIs? ---------------------------------------- Feature #13740: [PATCH] doc/extension.rdoc: start entries for threading and IO https://bugs.ruby-lang.org/issues/13740#change-65747 * Author: normalperson (Eric Wong) * Status: Open * Priority: Normal * Assignee: * Target version: ---------------------------------------- Some of it derived from existing documentation in thread.c, and some of it original. It seems extension.rdoc is getting large, so maybe it is better broken up into separate manpages (section "3ruby", maybe?) Anybody care to review or comment before I commit? I'll wait a few days, but maybe I'll forget, too. Anyways no chance of breaking running code (I hope :) ---Files-------------------------------- 0001-doc-extension.rdoc-start-entries-for-threading-and-I.patch (5.13 KB) -- https://bugs.ruby-lang.org/ Unsubscribe: