[comp.unix.questions] bug in mp?

guy@auspex.auspex.com (Guy Harris) (06/03/89)

>There are several entries in libpm.a that appear to be useful, but
>that are not documented (at least not on SunOS 3.5).  Does anybody
>know why?  Those I have found are:

Well, the 4.3-tahoe version of the MP(3X) man page seems to document a
bunch of them.  It says:

>	fmin
>	fmout

They take a "MINT *" as their first argument, and a "FILE *" as their
second argument ("FILE *" as in Standard I/O), and do decimal input and
output of the number in question to the standard I/O stream in question.
Numbers have the form of strings of digits terminated by newline.

>	invert

Takes three "MINT *" arguments, "a", "b", and "c", respectively, and
computes "c" such that "a*c mod b = 1", for "a" and "b" relatively
prime.

>	mcan

Not documented in the 4.3-tahoe page.

>	mcmp

Takes two "MINT *" arguments, and returns a negative, zero, or positive
integer value when "a < b", "a == b", and "a > b" respectively.

>	mout

"mout(a)" is equivalent to "fmout(a, stdout)".

>	move

"move(a, b)" copies "a" to "b".

>	omin
>	omout

Like "min" and "mout", only octal rather than decimal.

>Are these really for external use?

Given that Berkeley documented them in 4.3-tahoe, I assume that in that
release, at least, they are for external use.  The 4.3BSD and 4.3-tahoe
sources are identical, except for the Makefile, and I suspect the SunOS
4.0 version is basically that of 4.3BSD; I can't speak for earlier BSD
nor SunOS releases, nor for V7 whence I think it originally came.