Topic:   UNDOCUMENTED FORCE FUNCTIONS           Author: David Holmes

        What you'll find here:

        ( ) General Discussion
        ( ) Function prototypes for the Undocumented functions
        ( ) Some quick documentation for them.

        Examples: Attrs.exe             ( in the SAMPLE directory )

        General discussion:
        -------------------------------------------------------------------

        At long last, the documentation for the Undocumented FORCE
        functions!  Well, here's a quick list of the ones that I'm going
        to talk about:

        FUNCTION LOGICAL        Interrupt
        FUNCTION UINT           Int_w_flags
        PROCEDURE               make_ptr
        FUNCTION UINT           and
        FUNCTION UINT           or
        FUNCTION UINT           xor
        PROCEDURE               dec_hex


        Final Comments:
        -------------------------------------------------------------------
                I always get nervous talking about the undocumented FORCE
        functions.  They have a strange air of mystery about them, and
        sometimes I wonder why they are undocumented.  I have a feeling
        it's because they don't really "fit in" with the general scheme
        of the other functions in the library.

                Nearly all of them deal with lower-level programming that
        the designers probably wanted to hide from the user.  Of course,
        people found out about them, and many FORCE programmers don't
        mind going low-level when it makes more sense.  I suppose that's
        why they're FORCE programmers.

                If anyone thinks they know of any other undocumented
        FORCE functions that they'd like to see tested and documented,
        I'd be more than happy to oblige.  Be sure that check out the
        README.1ST in your \FORCE\BIN directory.  It lists several
        undocumented functions (which are in the header files).

                Oh, don't bother to ask about the factorial() function.
        It's not even supposed the be in the library, and calls some
        functions that don't exist.