Dan Sugalski wrote: > > Sure. Suggestions? int perl6_parse(PerlInterp* interp, PerlIO* input); PerlIO* make_memory_stream(char* buf, ssize_t length); // length=-1 for nul-terminated int close_stream(PerlIO* stream); then if you read further, you'll eventually see: PerlIO* make_callback_stream(int (*f)(char* buf, int space, void* other), void* other); Or maybe the first thing you see is just: int perl6_parse_string(PerlInterp* interp, char* buf, ssize_t length); // length=-1 for nul-term if that really is 95% of the cases. I guess I just think that when discussing perl6_parse, it's less effort to mention the existence of make_memory_stream and close_stream than it is to explain the meaning of three mystery parameters. Especially if that knowledge can be reused for half a dozen other API calls. perl6_Scalar* perl6_eval_scalar(PerlInterp*,PerlIO*); perl6_List* perl6_eval_list(PerlInterp*,PerlIO*); int perl6_load_module(PerlInterp*, PerlIO*); // Checks magic number for .pm vs .pmc, BOM, gzip...Thread Previous | Thread Next