Fair enough.

My first reaction when reading through most of the sample code was: "This isn't Perl, it's C" (there's a reason for that). A heads up that this was in the context of XS would save a little wasted time, both for those of us trying to make sense of what, at first glance, looks like a C programer's first attempts at Perl, and those reading through the replies.

True, it's not pseudo code, they are however cryptic abbreviations, and it is indeed true that indicating that the problem deals with XS code would save a few glazed eyes. :)