Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Loading…

Document examples/threads/*.pir #936

Closed
coke opened this Issue · 4 comments

2 participants

Will Coleda Duke Leto
Will Coleda
Owner

It would be helpful if there was a prologue to the various tests in the directory explaining which parts of threads they were showcasing - and, if possible, a note about why parrot's implementation is particularly interesting in this regard.

As an example: alloc_test.pir seems to go into an infinite loop and in the process, utilizes a CPU (plus a bit), and begins consuming memory - I could write that down, but that's not as interesting as why this example does that, which I can't figure out from looking at the code.

Another example: chameneos.pir seems to refer to http://benchmarksgame.alioth.debian.org/u32/performance.php?test=chameneosredux

It might be interesting to include a version in another language (or a pointer to one) so a user could compare the parrot version in situ against the other language; in lieu of that, perhaps include some benchmarks from a developer's machine comparing this version with another known version.

Thanks in advance.

Duke Leto
Owner

This issue is vague. Can we pair it down to an issue that is closeable or a set of closeable issues? One issue per threads example is reasonable.

@coke, are you essentially asking for some POD explanation in each thread example?

Will Coleda
Owner

Yes. Please document these examples.

Duke Leto
Owner

Is there a specific POD document where we want this documentation?

Duke Leto
Owner

Hey @coke, I think this issue can be closed, but I will let you make the final call.

If you think there are lingering things, I suggest creating new issues at this point.

Will Coleda coke closed this
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Something went wrong with that request. Please try again.