MannDoor v4.05.20


Documentation (Or Lack Thereof)

I'm not a big fan of writing documentation, so unfortunately MannDoor doesn't come with any. Fortunately MannDoor comes in source form, so if you want to see what functions/procedures a particular unit has, you just have to open it in a text editor and take a look. Each function/procedure is commented at the top so you should be able to see what it does fairly easily.

Basically every function/procedure you would find in the CRT unit has been included in MannDoor, just prefixed with "m". So for example, if you are used to using KeyPressed, ReadKey and ClrScr, MannDoor implements these as mKeyPressed, mReadKey and mClrScr. Of course there are a lot of others as well, so make sure you go take a look.

If you still have trouble, your best bet is to look at MASTRMND.PAS in the EXAMPLE subdirectory. I tried to make it do all the things that may be somewhat confusing, so it should be a good reference on how things work.

About This Document

MannDoor officially supports 4 different compilers running on 5 different operating systems (8 variations in total). Unfortunately, every setup will require at least a small amount of tweaking on your part. This document is meant to assist you in setting up your chosen compiler to work with MannDoor.

Please note this list is of compilers and OS's that I personally tested with. If your favourite compiler/OS is not listed here, that does not mean it is incompatable, it just means I personally don't have the resources to test it. If you want something added to the list, send me the steps you had to take for your compiler/OS, and I'll add it.

Setup For All Systems

No matter which compiler/OS you are using, you will have to add the UNITS and UNITS\ELECOM directories into the "Unit Directories Search Path".

In Borland Pascal/Virtual Pascal that means opening the IDE and pressing ALT-O and then D to open the Directories dialog. Then you enter the paths into the "Unit directories" box.

In FreePascal that means adding -Fu lines to your FPC.CFG file. I don't use the FreePascal IDE, but I would imagine the steps are the same as for BP/VP.

In Delphi that means opening the IDE and pressing ALT-P and then O to open the Project Options dialog. Switch to the Directories/Conditionals tab and then you enter the paths into the "Search Path" box.

Setup For DOS Systems

In addition to the UNITS and UNITS\ELECOM directories, DOS compilers will also have to add the UNITS\DOS directory using the same method described above.

Borland Pascal 7.0
  1. BP\SYSUTILS.PAS must be copied somewhere that only BP will have access to it (ie \BP\UNITS)
Free Pascal 1.0.8
  1. Try to be TP/BP 7.0 compatable (-So option)

Setup For FreeBSD Systems

In addition to the UNITS and UNITS\ELECOM directories, FreeBSD compilers will also have to add the UNITS\UNIX directory using the same method described above.

Free Pascal 1.0.8
  1. Try to be TP/BP 7.0 compatable (-So option)

Setup For Linux Systems

In addition to the UNITS and UNITS\ELECOM directories, Linux compilers will also have to add the UNITS\UNIX directory using the same method described above.

Free Pascal 1.0.8
  1. Try to be TP/BP 7.0 compatable (-So option)

Setup For OS/2 System

In addition to the UNITS and UNITS\ELECOM directories, OS/2 compilers will also have to add the UNITS\OS2 directory using the same method described above.

Virtual Pascal 2.1 Build 243
  1. Virtual Pascal also needs the UNITS\ELECOM directory added to the "Resource Directories" box using the same method described above.
  2. Include Use32 unit must be enabled (Press Alt-O then C)

Setup For Win32 System

In addition to the UNITS and UNITS\ELECOM directories, Win32 compilers will also have to add the UNITS\WIN32 directory using the same method described above.

Borland Delphi 6.0
  1. Assignable typed constants must be enabled (Press Alt-P then O, Compiler tab)
  2. Generate console application must be enabled (Press Alt-P then O, Linker tab)
  3. DELPHI\CRT.PAS and DELPHI\DOS.PAS must be copied somewhere that only Delphi will have access to them
Free Pascal 1.0.8
  1. Try to be Delphi compatable (-Sd option)
Virtual Pascal 2.1 Build 279
  1. Virtual Pascal also needs the UNITS\ELECOM directory added to the "Resource Directories" box using the same method described above.
  2. Include Use32 unit must be enabled (Press Alt-O then C)
  3. VP\VPSYSW32.PAS and VP\WINDOWS.PAS must be copied to \VP21\SOURCE\RTL

    4. These files can only be used with VP2.1 b279, they probably will not work with any older or newer version

Still Have Questions?

If you're still having problems compiling the example program after following the appropriate instructions, head on over to www.randm.ca and hit the Contact link and you can then send me a message outlining your problem. Please be sure to include all relevant information, such as what compiler you are using, on what OS, what errors you are getting, and in what source file.