kgio RubyGem user+dev discussion/patches/pulls/bugs/help
 help / color / mirror / code / Atom feed
* [PATCH] minor doc updates
@ 2015-08-12 13:04 Eric Wong
  0 siblings, 0 replies; only message in thread
From: Eric Wong @ 2015-08-12 13:04 UTC (permalink / raw)
  To: kgio-public

Ruby version changes, dropping Rubinius and MRI 1.8 support,
and clarifying a few other things.

"Linux kernel" coding style is probably a more accurate of what
we've always used as the style is probably better known than K&R
nowadays (and we do try to track Linux kernel changes (and
email-oriented development style) closely).
---
 HACKING | 16 +++++++---------
 README  |  3 ++-
 TODO    |  1 +
 3 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/HACKING b/HACKING
index 0a13e84..7aa3b7c 100644
--- a/HACKING
+++ b/HACKING
@@ -14,15 +14,14 @@ remains searchable even if Gmane becomes unavailable.
 
 === Code Compatibility
 
-We target Ruby 1.8.6+, 1.9.1+ and Rubinius 1.1+ and their
-respective C APIs.
+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 directly support non-Free platforms under any circumstances.
+We will NEVER support non-Free platforms under any circumstances.
 
-Our C code follows K&R indentation style (hard tabs, tabs are always 8
+Our C code follows Linux kernel coding style (hard tabs, tabs are always 8
 characters wide) and NOT the indentation style of Matz Ruby.
 
 == Contributing
@@ -51,7 +50,7 @@ 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 (RubyGems 1.3.5+ recommended for prerelease versions):
+Via RubyGems:
 
   gmake install-gem
 
@@ -64,10 +63,9 @@ installation done without RubyGems, however.
 
 === Tests
 
-We use GNU make to run tests in parallel.  test/unit/parallel didn't
-exist for old versions of Ruby before 1.9.3.  Users of GNU-based systems
-(such as GNU/Linux) usually have GNU make installed as "make" instead of
-"gmake".
+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:
 
diff --git a/README b/README
index a4edf57..9465fbd 100644
--- a/README
+++ b/README
@@ -10,7 +10,8 @@ Unix-like platforms).
 * Can avoid expensive exceptions on common EAGAIN/EINPROGRESS errors,
   returning :wait_readable or :wait_writable instead.
   These exceptions got more expensive to hit under Ruby 1.9.2
-  (but were fixed in Ruby 1.9.3 and later to 1.9.1 performance levels)
+  (but were fixed in Ruby 1.9.3 and later to 1.9.1 performance levels,
+   which were still bad)
 
 * Returns the unwritten portion of the string on partial writes,
   making it ideal for buffering unwritten data.
diff --git a/TODO b/TODO
index 898c0e7..c6560b2 100644
--- a/TODO
+++ b/TODO
@@ -1,2 +1,3 @@
 * remove old autopush interface (for kgio 3.x)
 * obsolete kgio by improving *_nonblock methods in Ruby itself
+  (Mostly done Ruby 2.3.0)
-- 
EW


^ permalink raw reply related	[flat|nested] only message in thread

only message in thread, other threads:[~2015-08-12 13:04 UTC | newest]

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2015-08-12 13:04 [PATCH] minor doc updates Eric Wong

Code repositories for project(s) associated with this public inbox

	https://yhbt.net/kgio.git/

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).