sleepy_penguin 1.0.0 → 1.1.1

data/.document

@@ -5,5 +5,6 @@ NEWS
 ChangeLog
 lib
 ext/sleepy_penguin/init.c
+ext/sleepy_penguin/epoll.c
 ext/sleepy_penguin/eventfd.c
 ext/sleepy_penguin/timerfd.c

data/.gitignore

@@ -18,3 +18,4 @@ pkg/
 /man
 tags
 TAGS
+/LATEST

data/.manifest

@@ -1,11 +1,13 @@
 .document
 .gitignore
 .manifest
+.wrongdoc.yml
 COPYING
 ChangeLog
 GIT-VERSION-FILE
 GIT-VERSION-GEN
 GNUmakefile
+LATEST
 LICENSE
 NEWS
 README

data/.wrongdoc.yml

@@ -0,0 +1,4 @@
+---
+cgit_url: http://git.bogomips.org/cgit/sleepy_penguin.git
+git_url: git://git.bogomips.org/sleepy_penguin.git
+rdoc_url: http://bogomips.org/sleepy_penguin/

data/ChangeLog

@@ -1,158 +1,228 @@
-ChangeLog from git://git.bogomips.org/sleepy_penguin.git ()
+ChangeLog from http://git.bogomips.org/cgit/sleepy_penguin.git
 
-    commit 97e9a7e764f912fddea75409dd388eaf3abe6a73
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Sun Sep 26 06:29:09 2010 +0000
-    
-        update documentation and build
-        
-        Should be ready for release
-    
-    commit 29bbb053277e9c054f1433c66a2e83ada44a5e8d
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Sun Sep 26 06:01:23 2010 +0000
-    
-        test_epoll: workaround less aggressive GC in rbx
-        
-        Some of the GC tests aren't realistic, but if they work in MRI
-        then we can expect them to work reasonably well everywhere.
-    
-    commit 43124e76e219d0be968fdeb09f6389d6895b0caf
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Sun Sep 26 06:00:10 2010 +0000
-    
-        provide rb_io_close() for Rubinius
-        
-        Rubinius 1.1.1 does not include this function
-        
-        ref: http://github.com/evanphx/rubinius/issues/497
-    
-    commit f3fd4447b650e75f48ac0fb9bada9b411c4b89cd
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Sun Sep 26 05:50:24 2010 +0000
-    
-        epoll: fix typo for rb_memerror()
-        
-        Tested on Rubinius.
-    
-    commit 63b5fa10ae2f196f392bc6a9360ed2343215ce78
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Sun Sep 26 04:00:30 2010 +0000
-    
-        misc documentation updates
-        
-        We shall release without SignalFD support
-    
-    commit 1ad58cb0fd9045b8fa26b85d68ddf2eb06827dd3
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Thu Sep 23 05:25:54 2010 +0000
-    
-        wire up EventFD class
-        
-        This wraps the eventfd(2) interface of Linux.  Like TimerFD, it
-        is not available on older distributions.
-    
-    commit 2d5886698c3f7241ab23771c2876b985708ded40
-    Author: Eric Wong <e@yhbt.net>
-    Date:   Mon Sep 20 16:49:57 2010 +0000
-    
-        add TimerFD class
-        
-        This wraps the timerfd_* interface in the Linux kernel.
-        It is not available on older distributions.
-    
-    commit 4a9ce0319f6e0250c4a8e01284fd5684936bde21
-    Author: Eric Wong <normalperson@yhbt.net>
-    Date:   Sun Sep 26 03:49:14 2010 +0000
-    
-        epoll: add cross-thread test/example
-        
-        This can potentially be very powerful under 1.9
-        with native threads
-    
-    commit 96dad9948d3a7b181d50a9fcb35320677edc352b
-    Author: Eric Wong <normalperson@yhbt.net>
-    Date:   Sun Sep 26 03:48:50 2010 +0000
-    
-        epoll: fix MRI 1.8 build
-        
-        It was just st.h in the old days.
-    
-    commit a226d237666728ea9242f6079b2c76528d53cdb2
-    Author: Eric Wong <normalperson@yhbt.net>
-    Date:   Sun Sep 26 02:46:51 2010 +0000
-    
-        Epoll#dup and Epoll#clone inherit close-on-exec
-        
-        There can be ways (in the future) where supporting
-        Epoll#dup/Epoll#clone can proveuseful, so continue to
-        support them until proven otherwise.
-    
-    commit 3ca3a23d3e68f62af6d57cf22825b2751c226fff
-    Author: Eric Wong <normalperson@yhbt.net>
-    Date:   Sun Sep 26 02:12:15 2010 +0000
-    
-        simplify epoll_create1 wrapper
-        
-        There are no FD flags besides FD_CLOEXEC, so
-        there's no point in making an extra fcntl()
-        call.
-    
-    commit 43153f218e14cad3a2c6f4056fcf02dc49dc4b36
-    Author: Eric Wong <normalperson@yhbt.net>
-    Date:   Sun Sep 26 01:41:47 2010 +0000
-    
-        epoll: add fork protection
-        
-        It's dangerous to preserve epoll descriptors across fork,
-        especially in Ruby where the GC can invalidate objects at any
-        time.  Installing pthread_atfork hooks prevents VALUE references
-        stored in the kernel from leaking across process boundaries,
-        making it far more difficult for a sanely written application to
-        leak invalid VALUEs to the user.
-    
-    commit 81d66a794338e241e00b9ffd66fc94b80064475d
-    Author: Eric Wong <normalperson@yhbt.net>
-    Date:   Sat Sep 25 20:32:32 2010 +0000
-    
-        Epoll#del only takes one argument
-        
-        We don't have to emulate the C API exactly, and it
-        makes life saner/easier for our users.
-    
-    commit bc4aaf4afdfb42ad5cc5e0729f816fbefb3d338e
-    Author: Eric Wong <normalperson@yhbt.net>
-    Date:   Sat Sep 25 20:08:18 2010 +0000
-    
-        epoll: factor out event data packing/unpacking
-        
-        Storing Ruby object values in the kernel means
-        they won't be visible to the GC, but for the
-        most part it's safe.
-    
-    commit 6296604742ed27ede171dad28f7d2bec2092d122
-    Author: Eric Wong <normalperson@yhbt.net>
-    Date:   Sat Sep 25 19:27:09 2010 +0000
-    
-        tests for EPOLLET and EINPROGRESS
-        
-        Just to make sure edge-triggering works on newly
-        created TCP connections.
-    
-    commit e9e91bd9b9c571e9f3374a4b5aa44573f60c3d32
-    Author: Eric Wong <normalperson@yhbt.net>
-    Date:   Sat Aug 21 09:00:57 2010 +0000
-    
-        extconf: enable detection of {timer,signal,event}fd.h
-    
-    commit 7f841e560fae9406192994df352bfb902b2ebbe8
-    Author: Eric Wong <normalperson@yhbt.net>
-    Date:   Sat Aug 21 09:00:42 2010 +0000
-    
-        README: clarify that we're a Ruby library
-    
-    commit 133a7dad4b2179093e5bbb7db6db6c31a51817b7
-    Author: Eric Wong <normalperson@yhbt.net>
-    Date:   Sat Aug 21 08:44:08 2010 +0000
-    
-        initial - epoll support working
+   commit ab4f1a27e5d2c1688a33870b6d070aaa510ccdbc
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Thu Jan 13 14:26:58 2011 -0800
+   
+       sleepy_penguin 1.1.1 - soft feathers, soft delete
+       
+       SleepyPenguin::Epoll#delete method added for "soft" failures
+       Documentation updates and cleanups, the website is now
+       JavaScript-free!
+       
+       (Ignore the 1.1.0 "release", it was a lie)
+   
+   commit f1729b7dfcf9b77e68d27304bfd7324724d43989
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Thu Jan 13 14:35:42 2011 -0800
+   
+       packaging fixups, oops
+       
+       Ugh, release got fat-fingered :<
+   
+   commit 7702d83a9a090ae73ace947be807f3f740b9d770
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Thu Jan 13 14:26:58 2011 -0800
+   
+       sleepy_penguin 1.1.0 - soft feathers, soft delete
+       
+       SleepyPenguin::Epoll#delete method added for "soft" failures
+       Documentation updates and cleanups, the website is now
+       JavaScript-free!
+   
+   commit a29b597e57cfcdf6a25cb4e8c12094e059833878
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Thu Jan 13 14:25:27 2011 -0800
+   
+       epoll: add "delete" for soft failures
+       
+       No need to burden applications.
+   
+   commit 9c44f01af3538fa51eeecd4944cca0ae1bc885b1
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Thu Jan 13 14:09:26 2011 -0800
+   
+       minor doc updates, use wrongdoc
+       
+       Switch documentation over to wrongdoc, no more JavaScript!
+       Our documentation still sucks.
+   
+   commit 4e7fdc58a9ce5b3be5f4213ff4d2fbefac7b5cc5
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Thu Jan 13 13:59:56 2011 -0800
+   
+       test_epoll: redundant, redefined method, oops!
+   
+   commit f8a85cee27e4344783d560810a1a51dd43d5a92d
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Thu Jan 13 13:52:30 2011 -0800
+   
+       extconf.rb: remove unnecessary dir_config
+       
+       We do not depend on external libraries other than the
+       system C library
+   
+   commit 942e89550795316b01430c3d278c9d8ef20cc617
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Mon Sep 27 17:21:46 2010 -0700
+   
+       README: update summary
+       
+       It seems to make more sense this way...  Editors wanted :)
+   
+   commit 97e9a7e764f912fddea75409dd388eaf3abe6a73
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Sun Sep 26 06:29:09 2010 +0000
+   
+       update documentation and build
+       
+       Should be ready for release
+   
+   commit 29bbb053277e9c054f1433c66a2e83ada44a5e8d
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Sun Sep 26 06:01:23 2010 +0000
+   
+       test_epoll: workaround less aggressive GC in rbx
+       
+       Some of the GC tests aren't realistic, but if they work in MRI
+       then we can expect them to work reasonably well everywhere.
+   
+   commit 43124e76e219d0be968fdeb09f6389d6895b0caf
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Sun Sep 26 06:00:10 2010 +0000
+   
+       provide rb_io_close() for Rubinius
+       
+       Rubinius 1.1.1 does not include this function
+       
+       ref: http://github.com/evanphx/rubinius/issues/497
+   
+   commit f3fd4447b650e75f48ac0fb9bada9b411c4b89cd
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Sun Sep 26 05:50:24 2010 +0000
+   
+       epoll: fix typo for rb_memerror()
+       
+       Tested on Rubinius.
+   
+   commit 63b5fa10ae2f196f392bc6a9360ed2343215ce78
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Sun Sep 26 04:00:30 2010 +0000
+   
+       misc documentation updates
+       
+       We shall release without SignalFD support
+   
+   commit 1ad58cb0fd9045b8fa26b85d68ddf2eb06827dd3
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Thu Sep 23 05:25:54 2010 +0000
+   
+       wire up EventFD class
+       
+       This wraps the eventfd(2) interface of Linux.  Like TimerFD, it
+       is not available on older distributions.
+   
+   commit 2d5886698c3f7241ab23771c2876b985708ded40
+   Author: Eric Wong <e@yhbt.net>
+   Date:   Mon Sep 20 16:49:57 2010 +0000
+   
+       add TimerFD class
+       
+       This wraps the timerfd_* interface in the Linux kernel.
+       It is not available on older distributions.
+   
+   commit 4a9ce0319f6e0250c4a8e01284fd5684936bde21
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Sun Sep 26 03:49:14 2010 +0000
+   
+       epoll: add cross-thread test/example
+       
+       This can potentially be very powerful under 1.9
+       with native threads
+   
+   commit 96dad9948d3a7b181d50a9fcb35320677edc352b
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Sun Sep 26 03:48:50 2010 +0000
+   
+       epoll: fix MRI 1.8 build
+       
+       It was just st.h in the old days.
+   
+   commit a226d237666728ea9242f6079b2c76528d53cdb2
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Sun Sep 26 02:46:51 2010 +0000
+   
+       Epoll#dup and Epoll#clone inherit close-on-exec
+       
+       There can be ways (in the future) where supporting
+       Epoll#dup/Epoll#clone can proveuseful, so continue to
+       support them until proven otherwise.
+   
+   commit 3ca3a23d3e68f62af6d57cf22825b2751c226fff
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Sun Sep 26 02:12:15 2010 +0000
+   
+       simplify epoll_create1 wrapper
+       
+       There are no FD flags besides FD_CLOEXEC, so
+       there's no point in making an extra fcntl()
+       call.
+   
+   commit 43153f218e14cad3a2c6f4056fcf02dc49dc4b36
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Sun Sep 26 01:41:47 2010 +0000
+   
+       epoll: add fork protection
+       
+       It's dangerous to preserve epoll descriptors across fork,
+       especially in Ruby where the GC can invalidate objects at any
+       time.  Installing pthread_atfork hooks prevents VALUE references
+       stored in the kernel from leaking across process boundaries,
+       making it far more difficult for a sanely written application to
+       leak invalid VALUEs to the user.
+   
+   commit 81d66a794338e241e00b9ffd66fc94b80064475d
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Sat Sep 25 20:32:32 2010 +0000
+   
+       Epoll#del only takes one argument
+       
+       We don't have to emulate the C API exactly, and it
+       makes life saner/easier for our users.
+   
+   commit bc4aaf4afdfb42ad5cc5e0729f816fbefb3d338e
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Sat Sep 25 20:08:18 2010 +0000
+   
+       epoll: factor out event data packing/unpacking
+       
+       Storing Ruby object values in the kernel means
+       they won't be visible to the GC, but for the
+       most part it's safe.
+   
+   commit 6296604742ed27ede171dad28f7d2bec2092d122
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Sat Sep 25 19:27:09 2010 +0000
+   
+       tests for EPOLLET and EINPROGRESS
+       
+       Just to make sure edge-triggering works on newly
+       created TCP connections.
+   
+   commit e9e91bd9b9c571e9f3374a4b5aa44573f60c3d32
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Sat Aug 21 09:00:57 2010 +0000
+   
+       extconf: enable detection of {timer,signal,event}fd.h
+   
+   commit 7f841e560fae9406192994df352bfb902b2ebbe8
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Sat Aug 21 09:00:42 2010 +0000
+   
+       README: clarify that we're a Ruby library
+   
+   commit 133a7dad4b2179093e5bbb7db6db6c31a51817b7
+   Author: Eric Wong <normalperson@yhbt.net>
+   Date:   Sat Aug 21 08:44:08 2010 +0000
+   
+       initial - epoll support working

data/GIT-VERSION-FILE

@@ -1 +1 @@
-GIT_VERSION = 1.0.0
+GIT_VERSION = 1.1.1

data/GIT-VERSION-GEN

@@ -1,7 +1,7 @@
 #!/bin/sh
 
 GVF=GIT-VERSION-FILE
-DEF_VER=v1.0.0.GIT
+DEF_VER=v1.1.1.GIT
 
 LF='
 '

data/GNUmakefile

@@ -3,7 +3,6 @@ all::
 RUBY = ruby
 RAKE = rake
 RSYNC = rsync
-GIT_URL = git://git.bogomips.org/sleepy_penguin.git
 
 GIT-VERSION-FILE: .FORCE-GIT-VERSION-FILE
 	@./GIT-VERSION-GEN
@@ -28,60 +27,27 @@ install:
 setup_rb_files := .config InstalledFiles
 prep_setup_rb := @-$(RM) $(setup_rb_files);$(MAKE) -C $(ext) clean
 
+extdir := ext/sleepy_penguin
 clean:
-	-$(MAKE) -C ext/sleepy_penguin clean
-	$(RM) $(setup_rb_files) ext/sleepy_penguin/Makefile
-
-pkg_extra := GIT-VERSION-FILE NEWS ChangeLog
-manifest: $(pkg_extra)
-	$(RM) .manifest
-	$(MAKE) .manifest
-
-.manifest:
-	(git ls-files && \
-         for i in $@ $(pkg_extra); \
-	 do echo $$i; done) | LC_ALL=C sort > $@+
-	cmp $@+ $@ || mv $@+ $@
-	$(RM) $@+
+	-$(MAKE) -C $(extdir) clean
+	$(RM) $(setup_rb_files) $(extdir)/Makefile
 
-NEWS: GIT-VERSION-FILE
-	$(RAKE) -s news_rdoc > $@+
-	mv $@+ $@
-
-latest: NEWS
-	@awk 'BEGIN{RS="=== ";ORS=""}NR==2{sub(/\n$$/,"");print RS""$$0 }' $<
+pkg_extra := GIT-VERSION-FILE NEWS ChangeLog LATEST
+ChangeLog: GIT-VERSION-FILE .wrongdoc.yml
+	wrongdoc prepare
 
-SINCE =
-ChangeLog: LOG_VERSION = \
-  $(shell git rev-parse -q "$(GIT_VERSION)" >/dev/null 2>&1 && \
-          echo $(GIT_VERSION) || git describe)
-ifneq ($(SINCE),)
-ChangeLog: log_range = v$(SINCE)..$(LOG_VERSION)
-endif
-ChangeLog: GIT-VERSION-FILE
-	@echo "ChangeLog from $(GIT_URL) ($(log_range))" > $@+
-	@echo >> $@+
-	git log $(log_range) | sed -e 's/^/    /' >> $@+
-	mv $@+ $@
-
-news_atom := http://bogomips.org/sleepy_penguin/NEWS.atom.xml
-cgit_atom := http://git.bogomips.org/cgit/sleepy_penguin.git/atom/?h=master
-atom = <link rel="alternate" title="Atom feed" href="$(1)" \
-             type="application/atom+xml"/>
+.manifest: ChangeLog
+	(git ls-files && for i in $@ $(pkg_extra); do echo $$i; done) | \
+		LC_ALL=C sort > $@+
+	cmp $@+ $@ || mv $@+ $@
+	$(RM) $@+
 
-# using rdoc 2.5.x
-doc: .document NEWS ChangeLog
-	rdoc -t "$(shell sed -ne '1s/^= //p' README)"
+doc: .document .wrongdoc.yml
+	find lib ext -type f -name '*.rbc' -exec rm -f '{}' ';'
+	$(RM) -r doc
+	wrongdoc all
 	install -m644 COPYING doc/COPYING
 	install -m644 $(shell grep '^[A-Z]' .document) doc/
-	$(RUBY) -i -p -e \
-	  '$$_.gsub!("</title>",%q{\&$(call atom,$(cgit_atom))})' \
-	  doc/ChangeLog.html
-	$(RUBY) -i -p -e \
-	  '$$_.gsub!("</title>",%q{\&$(call atom,$(news_atom))})' \
-	  doc/NEWS.html doc/README.html
-	$(RAKE) -s news_atom > doc/NEWS.atom.xml
-	cd doc && ln README.html tmp && mv tmp index.html
 
 ifneq ($(VERSION),)
 rfproject := rainbows
@@ -94,10 +60,10 @@ release_changes := release_changes-$(VERSION)
 release-notes: $(release_notes)
 release-changes: $(release_changes)
 $(release_changes):
-	$(RAKE) -s release_changes > $@+
+	wrongdoc release_changes > $@+
 	$(VISUAL) $@+ && test -s $@+ && mv $@+ $@
 $(release_notes):
-	GIT_URL=$(GIT_URL) $(RAKE) -s release_notes > $@+
+	wrongdoc release_notes > $@+
 	$(VISUAL) $@+ && test -s $@+ && mv $@+ $@
 
 # ensures we're actually on the tagged $(VERSION), only used for release
@@ -117,19 +83,19 @@ gem: $(pkggem)
 install-gem: $(pkggem)
 	gem install $(CURDIR)/$<
 
-$(pkggem): manifest fix-perms
+$(pkggem): .manifest fix-perms
 	gem build $(rfpackage).gemspec
 	mkdir -p pkg
 	mv $(@F) $@
 
 $(pkgtgz): distdir = $(basename $@)
 $(pkgtgz): HEAD = v$(VERSION)
-$(pkgtgz): manifest fix-perms
+$(pkgtgz): .manifest fix-perms
 	@test -n "$(distdir)"
 	$(RM) -r $(distdir)
 	mkdir -p $(distdir)
-	tar c `cat .manifest` | (cd $(distdir) && tar x)
-	cd pkg && tar c $(basename $(@F)) | gzip -9 > $(@F)+
+	tar cf - `cat .manifest` | (cd $(distdir) && tar xf -)
+	cd pkg && tar cf - $(basename $(@F)) | gzip -9 > $(@F)+
 	mv $@+ $@
 
 package: $(pkgtgz) $(pkggem)
@@ -139,7 +105,7 @@ release: verify package $(release_notes) $(release_changes)
 	# make tgz release on RubyForge
 	rubyforge add_release -f -n $(release_notes) -a $(release_changes) \
 	  $(rfproject) $(rfpackage) $(VERSION) $(pkgtgz)
-	# push gem to Gemcutter
+	# push gem to RubyGems.org
 	gem push $(pkggem)
 	# in case of gem downloads from RubyForge releases page
 	-rubyforge add_file \
@@ -151,12 +117,12 @@ gem install-gem: GIT-VERSION-FILE
 	$(MAKE) $@ VERSION=$(GIT_VERSION)
 endif
 
-extdir := ext/sleepy_penguin
 ext := $(extdir)/sleepy_penguin_ext.$(DLEXT)
 $(extdir)/Makefile: $(extdir)/extconf.rb
 	cd $(@D) && $(RUBY) extconf.rb
 
-$(ext): $(wildcard $(extdir)/*.c) $(wildcard $(extdir)/*.h) $(extdir)/Makefile
+c_files := $(wildcard $(extdir)/*.[ch] $(extdir)/*/*.h)
+$(ext): $(c_files) $(extdir)/Makefile
 	$(MAKE) -C $(@D)
 
 all:: test
@@ -171,11 +137,9 @@ $(test_units): build
 # this requires GNU coreutils variants
 publish_doc:
 	-git set-file-times
-	$(RM) -r doc ChangeLog NEWS
-	$(MAKE) doc LOG_VERSION=$(shell git tag -l | tail -1)
-	$(MAKE) -s latest > doc/LATEST
-	find doc/images doc/js -type f | \
-		TZ=UTC xargs touch -d '1970-01-01 00:00:00' doc/rdoc.css
+	$(MAKE) doc
+	find doc/images -type f | \
+		TZ=UTC xargs touch -d '1970-01-01 00:00:06' doc/rdoc.css
 	$(MAKE) doc_gz
 	chmod 644 $$(find doc -type f)
 	$(RSYNC) -av doc/ bogomips.org:/srv/bogomips/sleepy_penguin/
@@ -185,8 +149,7 @@ publish_doc:
 # "gzip_static on" can serve the gzipped versions directly.
 doc_gz: docs = $(shell find doc -type f ! -regex '^.*\.\(gif\|jpg\|png\|gz\)$$')
 doc_gz:
-	touch doc/NEWS.atom.xml -d "$$(awk 'NR==1{print $$4,$$5,$$6}' NEWS)"
 	for i in $(docs); do \
 	  gzip --rsyncable -9 < $$i > $$i.gz; touch -r $$i $$i.gz; done
 
-.PHONY: .FORCE-GIT-VERSION-FILE doc manifest man test $(test_units)
+.PHONY: .FORCE-GIT-VERSION-FILE doc test $(test_units)

data/LATEST

@@ -0,0 +1,8 @@
+=== sleepy_penguin 1.1.1 - soft feathers, soft delete / 2011-01-13 22:41 UTC
+
+  SleepyPenguin::Epoll#delete method added for "soft" failures
+  Documentation updates and cleanups, the website is now
+  JavaScript-free!
+
+  (Ignore the 1.1.0 "release", it was a lie)
+

data/NEWS

@@ -1,4 +1,12 @@
-=== 1.0.0 / 2010-09-26 06:31 UTC
+=== sleepy_penguin 1.1.1 - soft feathers, soft delete / 2011-01-13 22:41 UTC
+
+  SleepyPenguin::Epoll#delete method added for "soft" failures
+  Documentation updates and cleanups, the website is now
+  JavaScript-free!
+
+  (Ignore the 1.1.0 "release", it was a lie)
+
+=== sleepy_penguin 1.0.0 / 2010-09-26 06:31 UTC
 
   Initial release
 

data/README

@@ -1,4 +1,4 @@
-= sleepy_penguin - Ruby I/O events for Linux
+= sleepy_penguin - Linux I/O events for Ruby
 
 sleepy_penguin provides access to newer, Linux-only system calls to wait
 on events from traditionally non-I/O sources.  Bindings to the eventfd,

data/Rakefile

@@ -1,106 +1,8 @@
 # -*- encoding: binary -*-
-# most tasks are in the GNUmakefile which offers better parallelism
-def tags
-  timefmt = '%Y-%m-%dT%H:%M:%SZ'
-  @tags ||= `git tag -l`.split(/\n/).map do |tag|
-    if %r{\Av[\d\.]+\z} =~ tag
-      header, subject, body = `git cat-file tag #{tag}`.split(/\n\n/, 3)
-      header = header.split(/\n/)
-      tagger = header.grep(/\Atagger /).first
-      body ||= "initial"
-      {
-        :time => Time.at(tagger.split(/ /)[-2].to_i).utc.strftime(timefmt),
-        :tagger_name => %r{^tagger ([^<]+)}.match(tagger)[1].strip,
-        :tagger_email => %r{<([^>]+)>}.match(tagger)[1].strip,
-        :id => `git rev-parse refs/tags/#{tag}`.chomp!,
-        :tag => tag,
-        :subject => subject,
-        :body => body,
-      }
-    end
-  end.compact.sort { |a,b| b[:time] <=> a[:time] }
-end
-
 cgit_url = "http://git.bogomips.org/cgit/sleepy_penguin.git"
-git_url = ENV['GIT_URL'] || 'git://git.bogomips.org/sleepy_penguin.git'
-web_url = "http://bogomips.org/sleepy_penguin"
-
-desc 'prints news as an Atom feed'
-task :news_atom do
-  require 'nokogiri'
-  new_tags = tags[0,10]
-  puts(Nokogiri::XML::Builder.new do
-    feed :xmlns => "http://www.w3.org/2005/Atom" do
-      id! "#{web_url}NEWS.atom.xml"
-      title "sleepy_penguin news"
-      subtitle "epoll"
-      link! :rel => "alternate", :type => "text/html",
-            :href => "#{web_url}NEWS.html"
-      updated(new_tags.empty? ? "1970-01-01T00:00:00Z" : new_tags.first[:time])
-      new_tags.each do |tag|
-        entry do
-          title tag[:subject]
-          updated tag[:time]
-          published tag[:time]
-          author {
-            name tag[:tagger_name]
-            email tag[:tagger_email]
-          }
-          url = "#{cgit_url}/tag/?id=#{tag[:tag]}"
-          link! :rel => "alternate", :type => "text/html", :href =>url
-          id! url
-          message_only = tag[:body].split(/\n.+\(\d+\):\n {6}/s).first.strip
-          content({:type =>:text}, message_only)
-          content(:type =>:xhtml) { pre tag[:body] }
-        end
-      end
-    end
-  end.to_xml)
-end
-
-desc 'prints RDoc-formatted news'
-task :news_rdoc do
-  tags.each do |tag|
-    time = tag[:time].tr!('T', ' ').gsub!(/:\d\dZ/, ' UTC')
-    puts "=== #{tag[:tag].sub(/^v/, '')} / #{time}"
-    puts ""
-
-    body = tag[:body]
-    puts tag[:body].gsub(/^/sm, "  ").gsub(/[ \t]+$/sm, "")
-    puts ""
-  end
-end
-
-desc "print release changelog for Rubyforge"
-task :release_changes do
-  version = ENV['VERSION'] or abort "VERSION= needed"
-  version = "v#{version}"
-  vtags = tags.map { |tag| tag[:tag] =~ /\Av/ and tag[:tag] }.sort
-  prev = vtags[vtags.index(version) - 1]
-  if prev
-    system('git', 'diff', '--stat', prev, version) or abort $?
-    puts ""
-    system('git', 'log', "#{prev}..#{version}") or abort $?
-  else
-    system('git', 'log', version) or abort $?
-  end
-end
-
-desc "print release notes for Rubyforge"
-task :release_notes do
-  spec = Gem::Specification.load('sleepy_penguin.gemspec')
-  puts spec.description.strip
-  puts ""
-  puts "* #{spec.homepage}"
-  puts "* #{spec.email}"
-  puts "* #{git_url}"
-
-  _, _, body = `git cat-file tag v#{spec.version}`.split(/\n\n/, 3)
-  print "\nChanges:\n\n"
-  puts body
-end
+git_url = 'git://git.bogomips.org/sleepy_penguin.git'
 
-desc "read news article from STDIN and post to rubyforge"
+desc "post news article to rubyforge"
 task :publish_news do
   require 'rubyforge'
   spec = Gem::Specification.load('sleepy_penguin.gemspec')

data/ext/sleepy_penguin/epoll.c

@@ -206,6 +206,8 @@ static VALUE ctl(VALUE self, VALUE io, VALUE flags, int op)
 }
 
 /*
+ * used to avoid exceptions when your app is too lazy to check
+ * what state a descriptor is in
  */
 static VALUE set(VALUE self, VALUE io, VALUE flags)
 {
@@ -232,6 +234,29 @@ static VALUE set(VALUE self, VALUE io, VALUE flags)
 	return INT2NUM(rv);
 }
 
+/*
+ * Deletes an +io+ from an epoll set, but returns nil
+ * on ENOENT instead of raising an error.  This is useful
+ * for apps that do not care to track the status of an
+ * epoll object itself.
+ */
+static VALUE delete(VALUE self, VALUE io)
+{
+	struct rb_epoll *ep = ep_get(self);
+	int fd = my_fileno(io);
+	int rv;
+
+	ep_check(ep);
+	rv = epoll_ctl(ep->fd, EPOLL_CTL_DEL, fd, NULL);
+	if (rv == -1) {
+		if (errno != ENOENT)
+			rb_sys_fail("epoll_ctl - del");
+		errno = 0;
+		return Qnil;
+	}
+	return INT2NUM(rv);
+}
+
 static VALUE epwait_result(struct rb_epoll *ep, int n)
 {
 	int i;
@@ -375,6 +400,13 @@ static VALUE real_epwait(struct rb_epoll *ep)
 }
 #endif /* 1.8 Green thread compatibility code */
 
+/*
+ * Calls epoll_wait(2) and yields
+ *
+ * :call-seq:
+ *
+ *	epoll.wait(64, 1000) { |flags, obj| ... }
+ */
 static VALUE epwait(int argc, VALUE *argv, VALUE self)
 {
 	VALUE timeout, maxevents;
@@ -529,7 +561,7 @@ void sleepy_penguin_init_epoll(void)
 {
 	VALUE mSleepyPenguin, cEpoll;
 
-	mSleepyPenguin = rb_const_get(rb_cObject, rb_intern("SleepyPenguin"));
+	mSleepyPenguin = rb_define_module("SleepyPenguin");
 	cEpoll = rb_define_class_under(mSleepyPenguin, "Epoll", rb_cObject);
 	cEpoll_IO = rb_define_class_under(cEpoll, "IO", rb_cIO);
 	rb_define_method(cEpoll, "initialize", init, -1);
@@ -541,6 +573,7 @@ void sleepy_penguin_init_epoll(void)
 	rb_define_method(cEpoll, "add", add, 2);
 	rb_define_method(cEpoll, "mod", mod, 2);
 	rb_define_method(cEpoll, "del", del, 1);
+	rb_define_method(cEpoll, "delete", delete, 1);
 	rb_define_method(cEpoll, "set", set, 2);
 	rb_define_method(cEpoll, "wait", epwait, -1);
 	rb_define_const(cEpoll, "CLOEXEC", INT2NUM(EPOLL_CLOEXEC));

data/ext/sleepy_penguin/eventfd.c

@@ -156,7 +156,7 @@ void sleepy_penguin_init_eventfd(void)
 {
 	VALUE mSleepyPenguin, cEventFD;
 
-	mSleepyPenguin = rb_const_get(rb_cObject, rb_intern("SleepyPenguin"));
+	mSleepyPenguin = rb_define_module("SleepyPenguin");
 	cEventFD = rb_define_class_under(mSleepyPenguin, "EventFD", rb_cIO);
 	rb_define_singleton_method(cEventFD, "new", create, -1);
 #ifdef EFD_NONBLOCK

data/ext/sleepy_penguin/extconf.rb

@@ -9,5 +9,4 @@ have_func('rb_io_close')
 have_func('epoll_create1', %w(sys/epoll.h))
 have_func('rb_thread_blocking_region')
 have_library('pthread')
-dir_config('sleepy_penguin')
 create_makefile('sleepy_penguin_ext')

data/ext/sleepy_penguin/timerfd.c

@@ -107,7 +107,7 @@ void sleepy_penguin_init_timerfd(void)
 {
 	VALUE mSleepyPenguin, cTimerFD;
 
-	mSleepyPenguin = rb_const_get(rb_cObject, rb_intern("SleepyPenguin"));
+	mSleepyPenguin = rb_define_module("SleepyPenguin");
 	cTimerFD = rb_define_class_under(mSleepyPenguin, "TimerFD", rb_cIO);
 	rb_define_singleton_method(cTimerFD, "create", create, -1);
 	rb_define_singleton_method(cTimerFD, "new", create, -1);

data/lib/sleepy_penguin.rb

@@ -1,7 +1,7 @@
 # -*- encoding: binary -*-
 module SleepyPenguin
 
-  # the version of sleepy penguin, currently 1.0.0
-  SLEEPY_PENGUIN_VERSION = '1.0.0'
+  # the version of sleepy_penguin, currently 1.1.1
+  SLEEPY_PENGUIN_VERSION = '1.1.1'
 end
 require 'sleepy_penguin_ext'

data/sleepy_penguin.gemspec

@@ -1,36 +1,26 @@
 ENV["VERSION"] or abort "VERSION= must be specified"
 manifest = File.readlines('.manifest').map! { |x| x.chomp! }
-summary = File.readlines("README")[0].gsub(/\A=\s+\S+[^\w]+/, '').strip
-description = File.read("README").split(/\n\n/)[1].strip
+require 'wrongdoc'
+extend Wrongdoc::Gemspec
+name, summary, title = readme_metadata
 
 Gem::Specification.new do |s|
   s.name = %q{sleepy_penguin}
-  s.version = ENV["VERSION"]
-
+  s.version = ENV["VERSION"].dup
   s.homepage = 'http://bogomips.org/sleepy_penguin/'
-  s.authors = ["sleepy_penguin hackers"]
+  s.authors = ["#{name} hackers"]
   s.date = Time.now.utc.strftime('%Y-%m-%d')
-  s.description = description
+  s.description = readme_description
   s.email = %q{sleepy.penguin@librelist.com}
-
-  s.extra_rdoc_files = File.readlines('.document').map! do |x|
-    x.chomp!
-    if File.directory?(x)
-      manifest.grep(%r{\A#{x}/})
-    elsif File.file?(x)
-      x
-    else
-      nil
-    end
-  end.flatten.compact
-
+  s.extra_rdoc_files = extra_rdoc_files(manifest)
   s.files = manifest
-  s.rdoc_options = [ "-t", summary ]
+  s.rdoc_options = rdoc_options
   s.require_paths = %w(lib ext)
   s.rubyforge_project = %q{rainbows}
   s.summary = summary
   s.test_files = Dir['test/test_*.rb']
   s.extensions = %w(ext/sleepy_penguin/extconf.rb)
+  s.add_development_dependency('wrongdoc', '~> 1.3')
 
   # s.license = %w(LGPL) # disabled for compatibility with older RubyGems
 end

data/test/test_epoll.rb

@@ -14,10 +14,6 @@ class TestEpoll < Test::Unit::TestCase
     @ep = Epoll.new
   end
 
-  def teardown
-    [ @rd, @wr, @ep ].each { |io| io.close unless io.closed? }
-  end
-
   def test_cross_thread
     tmp = []
     Thread.new { sleep 0.100; @ep.add(@wr, Epoll::OUT) }
@@ -317,4 +313,12 @@ class TestEpoll < Test::Unit::TestCase
     io = Epoll.new.to_io
     assert((io.fcntl(Fcntl::F_GETFD) & Fcntl::FD_CLOEXEC) == Fcntl::FD_CLOEXEC)
   end
+
+  def test_delete
+    assert_nil @ep.delete(@rd)
+    assert_nil @ep.delete(@wr)
+    assert_nothing_raised { @ep.add @rd, Epoll::IN }
+    assert_equal 0, @ep.delete(@rd)
+    assert_nil @ep.delete(@rd)
+  end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: sleepy_penguin
 version: !ruby/object:Gem::Version 
-  hash: 23
+  hash: 17
   prerelease: false
   segments: 
   - 1
-  - 0
-  - 0
-  version: 1.0.0
+  - 1
+  - 1
+  version: 1.1.1
 platform: ruby
 authors: 
 - sleepy_penguin hackers
@@ -15,10 +15,24 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-09-26 00:00:00 +00:00
+date: 2011-01-13 00:00:00 +00:00
 default_executable: 
-dependencies: []
-
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: wrongdoc
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 9
+        segments: 
+        - 1
+        - 3
+        version: "1.3"
+  type: :development
+  version_requirements: *id001
 description: |-
   sleepy_penguin provides access to newer, Linux-only system calls to wait
   on events from traditionally non-I/O sources.  Bindings to the eventfd,
@@ -36,17 +50,20 @@ extra_rdoc_files:
 - ChangeLog
 - lib/sleepy_penguin.rb
 - ext/sleepy_penguin/init.c
+- ext/sleepy_penguin/epoll.c
 - ext/sleepy_penguin/eventfd.c
 - ext/sleepy_penguin/timerfd.c
 files: 
 - .document
 - .gitignore
 - .manifest
+- .wrongdoc.yml
 - COPYING
 - ChangeLog
 - GIT-VERSION-FILE
 - GIT-VERSION-GEN
 - GNUmakefile
+- LATEST
 - LICENSE
 - NEWS
 - README
@@ -73,7 +90,9 @@ licenses: []
 post_install_message: 
 rdoc_options: 
 - -t
-- Ruby I/O events for Linux
+- sleepy_penguin - Linux I/O events for Ruby
+- -W
+- http://git.bogomips.org/cgit/sleepy_penguin.git/tree/%s
 require_paths: 
 - lib
 - ext
@@ -101,7 +120,7 @@ rubyforge_project: rainbows
 rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
-summary: Ruby I/O events for Linux
+summary: Linux I/O events for Ruby
 test_files: 
 - test/test_epoll.rb
 - test/test_eventfd.rb