The enclosed patch expands (and hopefully clarifies) the documentation
for rotate_up, plus fixes one or two other niggles in the docs.
Simon
--- core.ops.old Sat Apr 6 19:12:43 2002
+++ core.ops Sat Apr 6 21:12:42 2002
@@ -229,8 +229,13 @@
=item B<print>(in INT, in NUM)
+=item B<print>(in INT, in STR)
+
=item B<print>(in INT, in PMC)
+Print $2 to the file specified by file descriptor $1; for $1 equal to
+0, 1 or 2, we use stdin, stdout or stderr respectively.
+
=cut
inline op print(in INT) {
@@ -2543,8 +2548,13 @@
=item B<rotate_up>(in INT)
-Rotate the top $1 entries in the user stack so that the top entry
-becomes the bottom entry in that range.
+Rotate the top $1 entries in the user stack by one. If $1 is positive,
+then the stack rotates upwards: the ($1)th entry becomes the ($1-1)th
+entry and so on, all the way up to the top of the stack, while the
+entry formerly at the top of the stack becomes the new ($1)th entry.
+If $1 is negative, the stack rotates downwards: the top entry becomes
+the second entry, the second becomes the third etc., while the former
+($1)th entry becomes the new top entry.
=cut
