From adc5c162613053d88c076e5d441b4368a97885f4 Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Mon, 1 Jan 2024 10:43:13 +0000 Subject: doc: various updates and disclaimers Covering my ass from draconian legislation. --- HACKING | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) (limited to 'HACKING') diff --git a/HACKING b/HACKING index 5aca83e..777e75e 100644 --- a/HACKING +++ b/HACKING @@ -6,6 +6,8 @@ Like Mongrel, we use Ruby where it makes sense, and Ragel with C where it helps performance. All of the code that actually runs your Rack application is written Ruby, Ragel or C. +Ragel may be dropped in favor of a picohttpparser-based one in the future. + As far as tests and documentation goes, we're not afraid to embrace Unix and use traditional Unix tools where they make sense and get the job done. @@ -16,6 +18,9 @@ Tests are good, but slow tests make development slow, so we make tests faster (in parallel) with GNU make (instead of Rake) and avoiding RubyGems. +New tests are written in Perl 5 and use TAP +to ensure stability and immunity from Ruby incompatibilities. + Users of GNU-based systems (such as GNU/Linux) usually have GNU make installed as "make" instead of "gmake". @@ -69,10 +74,10 @@ supported by the versions of Ruby we target. === Ragel Compatibility -We target the latest released version of Ragel and will update our code -to keep up with new releases. Packaged tarballs and gems include the -generated source code so they will remain usable if compatibility is -broken. +We target the latest released version of Ragel in Debian and will update +our code to keep up with new releases. Packaged tarballs and gems +include the generated source code so they will remain usable if +compatibility is broken. == Contributing -- cgit v1.2.3-24-ge0c7