From: <hba...@ma...> - 2007-02-10 02:23:56
|
On Feb 8, 2007, at 5:09 PM, Alan W. Irwin wrote: > I suggest we document both the full API and the redacted API for > each of the > PLplot functions where there is a difference. This amounts to > simply an > extra listing of the function call, for example, > > full API: plline(n, x, y) > redacted API: plline(x, y) This sounds good. I think we might need one line per language though, as some interfaces like Perl/PDL also change the order of the arguments. So, something like: c: plline(n, x, y) ... current documentation ... f77: plline(n,x,y) f95: plline(n,x,y) c++: plline(n,x,y) java: plline(x,y) perl: plline(x,y) python: plline(x,y) tcl/tk: plline(x,y) This function is used in examples x,y,z That looks pretty redundant though, so maybe c:, redacted: and variants by language if necessary? I'll volunteer to make this happen. -Hazen |