Please wrap documentation at 72 characters-per-line or less (long URLs are exempt) so it is comfortably readable from terminals.
When referencing mailing list posts, use https://yhbt.net/kgio-public/$MESSAGE_ID/ if possible Message-ID remains searchable even if the archive becomes unavailable.
We target mainline Ruby 1.9.3 and later.
All of our C code should be compatible with all reasonably modern Unices and should run on compilers supported by the versions of Ruby we target.
We will NEVER support non-Free platforms under any circumstances.
Our C code follows Linux kernel coding style (hard tabs, tabs are always 8 characters wide) and NOT the indentation style of Matz Ruby.
Contributions are welcome in the form of patches, pull requests (format email with "git request-pull"), code review, testing, documentation, user support or any other feedback. <kgio-public@yhbt.net> <yhbt.net/kgio-public/> is the current coordination point for all user and developer feedback and bug reports (domain is subject to change since ICANN cannot be trusted).
Follow conventions already established in the code and do not exceed 80 characters per line.
Inline patches (from "git format-patch -M") to the mailing list are preferred because they allow code review and comments in the reply to the patch.
We will adhere to mostly the same conventions for patch submissions as git itself. See the Documentation/SubmittingPatches document distributed with git on on patch submission guidelines to follow. Just don't email the git mailing list or maintainer with kgio patches :)
It is easy to install the contents of your git working directory:
Via RubyGems:
gmake install-gem
Without RubyGems (via setup.rb):
gmake install
It is not at all recommended to mix a RubyGems installation with an installation done without RubyGems, however.
We use GNU make to run tests in parallel for historical reasons. Users of GNU-based systems (such as GNU/Linux) usually have GNU make installed as "make" instead of "gmake".
Running the entire test suite with 4 tests in parallel:
gmake -j4 test
Running just one unit test:
gmake test/test_poll.rb
mail archives: https://yhbt.net/kgio-public/ http://7fh6tueqddpjyxjmgtdiueylzoqt6pt7hec3pukyptlmohoowvhde4yd.onion/kgio-public/ nntp://news.public-inbox.org/inbox.comp.lang.ruby.kgio nntp://7fh6tueqddpjyxjmgtdiueylzoqt6pt7hec3pukyptlmohoowvhde4yd.onion/inbox.comp.lang.ruby.kgio public: kgio-public@yhbt.net source code: git clone https://yhbt.net/kgio.git torsocks git clone http://7fh6tueqddpjyxjmgtdiueylzoqt6pt7hec3pukyptlmohoowvhde4yd.onion/kgio.git