{
  "disks": {
    "1": {
      "dirs": [
        {
          "path": "/",
          "files": [
            {
              "name": "README",
              "size": 7891,
              "date": "1991-01-25",
              "time": "16:27"
            },
            {
              "name": "LIB",
              "dir": true,
              "date": "1991-01-23",
              "time": "16:33"
            },
            {
              "name": "DEMOS",
              "dir": true,
              "date": "1991-01-23",
              "time": "16:34"
            },
            {
              "name": "INC",
              "dir": true,
              "date": "1991-01-23",
              "time": "16:35"
            },
            {
              "name": "SOURCE",
              "dir": true,
              "date": "1991-01-23",
              "time": "16:36"
            },
            {
              "name": "UTILS",
              "dir": true,
              "date": "1991-01-23",
              "time": "16:46"
            },
            {
              "name": "ENSURE   EXE",
              "size": 8816,
              "date": "1990-02-27",
              "time": "12:55"
            },
            {
              "name": "FIND     EXE",
              "size": 49246,
              "date": "1990-10-11",
              "time": "16:08"
            },
            {
              "name": "INSTALL  BAT",
              "size": 332,
              "date": "1989-10-25",
              "time": "17:15"
            },
            {
              "name": "INSTALL1 BAT",
              "size": 3416,
              "date": "1991-01-24",
              "time": "16:45"
            },
            {
              "name": "ASK      COM",
              "size": 216,
              "date": "1985-07-30",
              "time": "14:53"
            }
          ]
        },
        {
          "path": "/LIB",
          "files": [
            {
              "name": "IBMLIB3  LIB",
              "size": 27136,
              "date": "1991-01-30",
              "time": "15:38"
            },
            {
              "name": "CLIB3    LIB",
              "size": 24064,
              "date": "1991-01-23",
              "time": "11:46"
            },
            {
              "name": "CLIBG3   LIB",
              "size": 25600,
              "date": "1991-01-23",
              "time": "12:19"
            },
            {
              "name": "IBMLIBG3 LIB",
              "size": 27648,
              "date": "1991-01-30",
              "time": "15:43"
            },
            {
              "name": "CLIBS    LIB",
              "size": 24253,
              "date": "1991-01-23",
              "time": "12:47"
            },
            {
              "name": "CLIBM    LIB",
              "size": 24253,
              "date": "1991-01-23",
              "time": "12:55"
            },
            {
              "name": "CLIBL    LIB",
              "size": 27837,
              "date": "1991-01-23",
              "time": "13:02"
            },
            {
              "name": "CLIBB    LIB",
              "size": 25789,
              "date": "1991-01-23",
              "time": "13:09"
            },
            {
              "name": "CLIBC    LIB",
              "size": 25789,
              "date": "1991-01-23",
              "time": "13:17"
            },
            {
              "name": "IBMLIBS  LIB",
              "size": 29865,
              "date": "1991-01-30",
              "time": "15:50"
            },
            {
              "name": "IBMLIBM  LIB",
              "size": 30377,
              "date": "1991-01-30",
              "time": "15:54"
            },
            {
              "name": "IBMLIBL  LIB",
              "size": 33961,
              "date": "1991-01-30",
              "time": "15:57"
            },
            {
              "name": "IBMLIBB  LIB",
              "size": 31401,
              "date": "1991-01-23",
              "time": "13:31"
            },
            {
              "name": "IBMLIBC  LIB",
              "size": 31401,
              "date": "1991-01-23",
              "time": "13:35"
            }
          ]
        },
        {
          "path": "/DEMOS",
          "files": [
            {
              "name": "CO_TEST  C",
              "size": 2842,
              "date": "1990-05-22",
              "time": "16:07"
            },
            {
              "name": "GR_TEST  C",
              "size": 4822,
              "date": "1991-01-17",
              "time": "13:49"
            },
            {
              "name": "IN_TEST  C",
              "size": 3231,
              "date": "1991-01-18",
              "time": "15:41"
            },
            {
              "name": "MN_TEST  C",
              "size": 2244,
              "date": "1990-05-22",
              "time": "11:56"
            },
            {
              "name": "MS_TEST  C",
              "size": 2141,
              "date": "1990-08-14",
              "time": "10:03"
            },
            {
              "name": "PR_TEST  C",
              "size": 3151,
              "date": "1990-05-22",
              "time": "15:37"
            },
            {
              "name": "SC_TEST1 C",
              "size": 4763,
              "date": "1990-05-22",
              "time": "11:55"
            },
            {
              "name": "SC_TEST2 C",
              "size": 4099,
              "date": "1990-05-22",
              "time": "15:39"
            },
            {
              "name": "SI_TEST  C",
              "size": 1760,
              "date": "1991-01-23",
              "time": "15:04"
            },
            {
              "name": "SY_TEST  C",
              "size": 2475,
              "date": "1990-05-22",
              "time": "16:13"
            },
            {
              "name": "TX_TEST  C",
              "size": 2655,
              "date": "1991-01-17",
              "time": "14:16"
            },
            {
              "name": "UT_TEST1 C",
              "size": 11310,
              "date": "1990-07-24",
              "time": "14:10"
            },
            {
              "name": "UT_TEST2 C",
              "size": 2701,
              "date": "1990-07-24",
              "time": "14:10"
            },
            {
              "name": "D386_O",
              "dir": true,
              "date": "1991-01-23",
              "time": "16:35"
            },
            {
              "name": "DX86_O",
              "dir": true,
              "date": "1991-01-23",
              "time": "16:35"
            },
            {
              "name": "GD386_O",
              "dir": true,
              "date": "1991-01-23",
              "time": "16:35"
            }
          ]
        },
        {
          "path": "/DEMOS/D386_O",
          "files": [
            {
              "name": "COMP     BAT",
              "size": 734,
              "date": "1991-01-25",
              "time": "15:31"
            },
            {
              "name": "RECOMP   BAT",
              "size": 988,
              "date": "1991-01-25",
              "time": "15:32"
            }
          ]
        },
        {
          "path": "/DEMOS/DX86_O",
          "files": [
            {
              "name": "RECOMP   BAT",
              "size": 1294,
              "date": "1991-01-18",
              "time": "15:37"
            },
            {
              "name": "COMP     BAT",
              "size": 966,
              "date": "1991-01-18",
              "time": "15:36"
            }
          ]
        },
        {
          "path": "/DEMOS/GD386_O",
          "files": [
            {
              "name": "COMP     BAT",
              "size": 794,
              "date": "1991-01-25",
              "time": "15:32"
            },
            {
              "name": "RECOMP   BAT",
              "size": 1048,
              "date": "1991-01-25",
              "time": "15:33"
            }
          ]
        },
        {
          "path": "/INC",
          "files": [
            {
              "name": "BLACKSTR H",
              "size": 1364,
              "date": "1991-01-17",
              "time": "11:59"
            },
            {
              "name": "PROTO    H",
              "size": 10870,
              "date": "1991-01-17",
              "time": "13:32"
            },
            {
              "name": "PRIMITIV H",
              "size": 2093,
              "date": "1990-05-21",
              "time": "15:08"
            },
            {
              "name": "CO_DEFS  H",
              "size": 2317,
              "date": "1990-05-21",
              "time": "15:08"
            },
            {
              "name": "CO_HEAD  H",
              "size": 2222,
              "date": "1990-05-21",
              "time": "15:08"
            },
            {
              "name": "GR_DEFS  H",
              "size": 667,
              "date": "1991-01-17",
              "time": "13:12"
            },
            {
              "name": "GR_HEAD  H",
              "size": 1750,
              "date": "1991-01-17",
              "time": "13:13"
            },
            {
              "name": "IN_HEAD  H",
              "size": 525,
              "date": "1990-05-21",
              "time": "15:08"
            },
            {
              "name": "KB_DEFS  H",
              "size": 2295,
              "date": "1990-05-21",
              "time": "15:08"
            },
            {
              "name": "KB_HEAD  H",
              "size": 2242,
              "date": "1990-05-21",
              "time": "15:08"
            },
            {
              "name": "MS_DEFS  H",
              "size": 1133,
              "date": "1990-05-21",
              "time": "15:08"
            },
            {
              "name": "MS_HEAD  H",
              "size": 1255,
              "date": "1990-05-23",
              "time": "15:20"
            },
            {
              "name": "PR_DEFS  H",
              "size": 2613,
              "date": "1990-05-21",
              "time": "15:08"
            },
            {
              "name": "PR_HEAD  H",
              "size": 1297,
              "date": "1990-05-21",
              "time": "15:08"
            },
            {
              "name": "SC_DEFS  H",
              "size": 622,
              "date": "1990-05-21",
              "time": "15:08"
            },
            {
              "name": "SC_HEAD  H",
              "size": 3627,
              "date": "1990-05-21",
              "time": "15:08"
            },
            {
              "name": "SI_HEAD  H",
              "size": 598,
              "date": "1990-05-21",
              "time": "15:08"
            },
            {
              "name": "SY_DEFS  H",
              "size": 950,
              "date": "1990-05-21",
              "time": "15:08"
            },
            {
              "name": "SY_HEAD  H",
              "size": 1292,
              "date": "1990-05-21",
              "time": "15:08"
            },
            {
              "name": "TX_DEFS  H",
              "size": 1059,
              "date": "1990-05-21",
              "time": "15:08"
            },
            {
              "name": "TX_HEAD  H",
              "size": 1104,
              "date": "1990-05-21",
              "time": "15:08"
            },
            {
              "name": "UT_DEFS  H",
              "size": 1240,
              "date": "1990-05-21",
              "time": "15:08"
            },
            {
              "name": "UT_HEAD  H",
              "size": 1652,
              "date": "1990-05-21",
              "time": "15:08"
            },
            {
              "name": "BLACKSTR MAC",
              "size": 929,
              "date": "1990-05-17",
              "time": "11:21"
            }
          ]
        },
        {
          "path": "/SOURCE",
          "files": [
            {
              "name": "CLIB",
              "dir": true,
              "date": "1991-01-23",
              "time": "16:37"
            },
            {
              "name": "IBMLIB",
              "dir": true,
              "date": "1991-01-23",
              "time": "16:42"
            }
          ]
        },
        {
          "path": "/SOURCE/CLIB",
          "files": [
            {
              "name": "FL_FUNC  C",
              "size": 2150,
              "date": "1990-07-10",
              "time": "16:31"
            },
            {
              "name": "FL_PATHS C",
              "size": 2337,
              "date": "1990-07-10",
              "time": "16:31"
            },
            {
              "name": "GR_FILL  C",
              "size": 1711,
              "date": "1990-07-10",
              "time": "16:31"
            },
            {
              "name": "GR_SHAPE C",
              "size": 2754,
              "date": "1990-07-10",
              "time": "16:31"
            },
            {
              "name": "GR_WINDO C",
              "size": 2223,
              "date": "1990-07-10",
              "time": "16:31"
            },
            {
              "name": "KB_FIELD C",
              "size": 3916,
              "date": "1991-01-17",
              "time": "13:51"
            },
            {
              "name": "ME_ALPH  C",
              "size": 1295,
              "date": "1990-07-10",
              "time": "16:31"
            },
            {
              "name": "SC_BOX   C",
              "size": 1304,
              "date": "1990-07-10",
              "time": "16:31"
            },
            {
              "name": "SC_FIELD C",
              "size": 3515,
              "date": "1991-01-17",
              "time": "17:09"
            },
            {
              "name": "SC_WINDO C",
              "size": 953,
              "date": "1990-07-10",
              "time": "16:31"
            },
            {
              "name": "ST_ALPH  C",
              "size": 5005,
              "date": "1990-07-10",
              "time": "16:31"
            },
            {
              "name": "ST_CONV  C",
              "size": 2183,
              "date": "1991-01-16",
              "time": "10:42"
            },
            {
              "name": "ST_JUST  C",
              "size": 1242,
              "date": "1990-07-10",
              "time": "16:31"
            },
            {
              "name": "ST_SUB   C",
              "size": 1991,
              "date": "1990-07-10",
              "time": "16:31"
            },
            {
              "name": "TX_FIELD C",
              "size": 3272,
              "date": "1990-07-10",
              "time": "16:31"
            },
            {
              "name": "TX_MENU  C",
              "size": 2960,
              "date": "1990-07-10",
              "time": "16:31"
            },
            {
              "name": "UT_CRYPT C",
              "size": 599,
              "date": "1990-07-10",
              "time": "16:31"
            },
            {
              "name": "UT_DATE  C",
              "size": 4895,
              "date": "1990-07-10",
              "time": "16:31"
            },
            {
              "name": "UT_DAY   C",
              "size": 2500,
              "date": "1990-07-10",
              "time": "16:31"
            },
            {
              "name": "UT_DMEM  C",
              "size": 1373,
              "date": "1990-07-10",
              "time": "16:31"
            },
            {
              "name": "UT_DTADD C",
              "size": 6169,
              "date": "1991-01-18",
              "time": "10:33"
            },
            {
              "name": "UT_DTSTR C",
              "size": 2813,
              "date": "1990-07-10",
              "time": "16:31"
            },
            {
              "name": "UT_STACK C",
              "size": 858,
              "date": "1990-07-10",
              "time": "16:31"
            },
            {
              "name": "UT_XLATE C",
              "size": 1462,
              "date": "1990-07-10",
              "time": "16:31"
            },
            {
              "name": "MKCLIB   LBC",
              "size": 245,
              "date": "1990-07-10",
              "time": "17:13"
            },
            {
              "name": "MKCLIB   LNK",
              "size": 347,
              "date": "1990-07-10",
              "time": "16:35"
            },
            {
              "name": "DX86_O",
              "dir": true,
              "date": "1991-01-23",
              "time": "16:38"
            },
            {
              "name": "D386_O",
              "dir": true,
              "date": "1991-01-23",
              "time": "16:39"
            },
            {
              "name": "GD386_O",
              "dir": true,
              "date": "1991-01-23",
              "time": "16:40"
            }
          ]
        },
        {
          "path": "/SOURCE/CLIB/DX86_O",
          "files": [
            {
              "name": "COMP     BAT",
              "size": 1453,
              "date": "1991-01-18",
              "time": "11:27"
            },
            {
              "name": "RECOMP   BAT",
              "size": 2227,
              "date": "1991-01-16",
              "time": "14:15"
            }
          ]
        },
        {
          "path": "/SOURCE/CLIB/D386_O",
          "files": [
            {
              "name": "COMP     BAT",
              "size": 1245,
              "date": "1991-01-25",
              "time": "15:41"
            },
            {
              "name": "RECOMP   BAT",
              "size": 1894,
              "date": "1991-01-25",
              "time": "15:34"
            }
          ]
        },
        {
          "path": "/SOURCE/CLIB/GD386_O",
          "files": [
            {
              "name": "COMP     BAT",
              "size": 1367,
              "date": "1991-01-25",
              "time": "15:35"
            },
            {
              "name": "RECOMP   BAT",
              "size": 1965,
              "date": "1991-01-25",
              "time": "15:35"
            }
          ]
        },
        {
          "path": "/SOURCE/IBMLIB",
          "files": [
            {
              "name": "CO_DRIVE ASM",
              "size": 3247,
              "date": "1990-09-25",
              "time": "13:42"
            },
            {
              "name": "GR_DRIVE ASM",
              "size": 10435,
              "date": "1991-01-17",
              "time": "13:10"
            },
            {
              "name": "IN_DRIVE ASM",
              "size": 9732,
              "date": "1990-09-25",
              "time": "14:10"
            },
            {
              "name": "MS_DRIVE ASM",
              "size": 3084,
              "date": "1990-08-14",
              "time": "9:46"
            },
            {
              "name": "PR_DRIVE ASM",
              "size": 3864,
              "date": "1990-09-25",
              "time": "14:26"
            },
            {
              "name": "SC_DRIVE ASM",
              "size": 20264,
              "date": "1990-09-25",
              "time": "14:34"
            },
            {
              "name": "SY_DRIVE ASM",
              "size": 3988,
              "date": "1990-09-25",
              "time": "14:37"
            },
            {
              "name": "KB_DRIVE ASM",
              "size": 2679,
              "date": "1990-09-25",
              "time": "14:39"
            },
            {
              "name": "DV_DRIVE ASM",
              "size": 5991,
              "date": "1990-09-25",
              "time": "14:41"
            },
            {
              "name": "CO_HANDL C",
              "size": 4098,
              "date": "1990-07-10",
              "time": "16:32"
            },
            {
              "name": "GR_HANDL C",
              "size": 6563,
              "date": "1991-01-17",
              "time": "13:09"
            },
            {
              "name": "KB_HANDL C",
              "size": 3763,
              "date": "1990-07-10",
              "time": "16:32"
            },
            {
              "name": "MS_HANDL C",
              "size": 4681,
              "date": "1990-07-10",
              "time": "16:32"
            },
            {
              "name": "PR_HANDL C",
              "size": 4095,
              "date": "1990-07-10",
              "time": "16:32"
            },
            {
              "name": "SC_HANDL C",
              "size": 11001,
              "date": "1991-01-23",
              "time": "11:28"
            },
            {
              "name": "SI_HANDL C",
              "size": 2450,
              "date": "1990-07-10",
              "time": "16:32"
            },
            {
              "name": "SY_HANDL C",
              "size": 8248,
              "date": "1991-01-30",
              "time": "15:26"
            },
            {
              "name": "IN_HANDL C",
              "size": 1880,
              "date": "1990-07-10",
              "time": "16:32"
            },
            {
              "name": "MKIBMLIB LNK",
              "size": 246,
              "date": "1990-07-10",
              "time": "16:34"
            },
            {
              "name": "MKIBMLIB LBC",
              "size": 159,
              "date": "1990-07-13",
              "time": "11:27"
            },
            {
              "name": "GD386_O",
              "dir": true,
              "date": "1991-01-23",
              "time": "16:43"
            },
            {
              "name": "D386_O",
              "dir": true,
              "date": "1991-01-23",
              "time": "16:44"
            },
            {
              "name": "DX86_O",
              "dir": true,
              "date": "1991-01-23",
              "time": "16:45"
            }
          ]
        },
        {
          "path": "/SOURCE/IBMLIB/GD386_O",
          "files": [
            {
              "name": "COMP     BAT",
              "size": 1031,
              "date": "1991-01-25",
              "time": "15:36"
            },
            {
              "name": "MACROS",
              "size": 4347,
              "date": "1990-07-10",
              "time": "16:34"
            },
            {
              "name": "MODEL",
              "size": 1502,
              "date": "1990-07-10",
              "time": "16:34"
            },
            {
              "name": "RECOMP   BAT",
              "size": 1395,
              "date": "1991-01-25",
              "time": "15:36"
            }
          ]
        },
        {
          "path": "/SOURCE/IBMLIB/D386_O",
          "files": [
            {
              "name": "MODEL",
              "size": 1502,
              "date": "1990-07-10",
              "time": "16:34"
            },
            {
              "name": "MACROS",
              "size": 4347,
              "date": "1990-07-10",
              "time": "16:34"
            },
            {
              "name": "COMP     BAT",
              "size": 1016,
              "date": "1991-01-25",
              "time": "15:36"
            },
            {
              "name": "RECOMP   BAT",
              "size": 1380,
              "date": "1991-01-25",
              "time": "15:37"
            }
          ]
        },
        {
          "path": "/SOURCE/IBMLIB/DX86_O",
          "files": [
            {
              "name": "COMP     BAT",
              "size": 1097,
              "date": "1991-01-18",
              "time": "13:21"
            },
            {
              "name": "MODEL",
              "size": 1460,
              "date": "1990-05-01",
              "time": "11:52"
            },
            {
              "name": "MODEL    C",
              "size": 1460,
              "date": "1990-05-01",
              "time": "11:52"
            },
            {
              "name": "MODEL    M",
              "size": 1461,
              "date": "1990-05-01",
              "time": "11:53"
            },
            {
              "name": "MODEL    L",
              "size": 1461,
              "date": "1990-05-01",
              "time": "11:54"
            },
            {
              "name": "MODEL    B",
              "size": 1460,
              "date": "1990-05-01",
              "time": "11:53"
            },
            {
              "name": "MACROS",
              "size": 4289,
              "date": "1990-05-01",
              "time": "11:59"
            },
            {
              "name": "MODEL    S",
              "size": 1462,
              "date": "1990-05-01",
              "time": "11:51"
            },
            {
              "name": "RECOMP   BAT",
              "size": 1715,
              "date": "1991-01-16",
              "time": "15:49"
            }
          ]
        },
        {
          "path": "/UTILS",
          "files": [
            {
              "name": "CPRINT   C",
              "size": 4135,
              "date": "1990-05-24",
              "time": "17:26"
            },
            {
              "name": "DOCXTRAK C",
              "size": 2800,
              "date": "1990-05-24",
              "time": "19:37"
            },
            {
              "name": "GFIND    C",
              "size": 4476,
              "date": "1990-05-24",
              "time": "19:38"
            },
            {
              "name": "DX86_O",
              "dir": true,
              "date": "1991-01-23",
              "time": "16:47"
            },
            {
              "name": "D386_O",
              "dir": true,
              "date": "1991-01-23",
              "time": "16:47"
            },
            {
              "name": "GD386_O",
              "dir": true,
              "date": "1991-01-23",
              "time": "16:47"
            }
          ]
        },
        {
          "path": "/UTILS/DX86_O",
          "files": [
            {
              "name": "COMP     BAT",
              "size": 187,
              "date": "1991-01-18",
              "time": "15:51"
            },
            {
              "name": "RECOMP   BAT",
              "size": 260,
              "date": "1991-01-18",
              "time": "15:51"
            }
          ]
        },
        {
          "path": "/UTILS/D386_O",
          "files": [
            {
              "name": "COMP     BAT",
              "size": 232,
              "date": "1991-01-25",
              "time": "15:38"
            },
            {
              "name": "RECOMP   BAT",
              "size": 310,
              "date": "1991-01-25",
              "time": "15:38"
            }
          ]
        },
        {
          "path": "/UTILS/GD386_O",
          "files": [
            {
              "name": "COMP     BAT",
              "size": 250,
              "date": "1991-01-25",
              "time": "15:38"
            },
            {
              "name": "RECOMP   BAT",
              "size": 328,
              "date": "1991-01-25",
              "time": "15:39"
            }
          ]
        }
      ]
    }
  },
  "desc_file": "README",
  "desc_text": "       Copyright (C) 1991 MetaWare Incorporated.  All Rights Reserved.\r\n\r\n                         BlackStar C Function Library\r\n                                January 1991\r\n\r\nInstalling the Library\r\n----------------------\r\n\r\nTo install the BlackStar library files, make a subdirectory on the disk on\r\nwhich the library is to be installed, change to that directory, and with the\r\nBlackStar diskette in drive A type:\r\n\r\n   a:install\r\n\r\nFor example, if you are installing the library on hard drive C and the\r\nBlackStar diskette is in drive A, type the following sequence of commands:\r\n\r\n    c:\r\n    md blackstr\r\n    cd blackstr\r\n    a:install\r\n\r\nIf you are installing to a hard disk other than C or from a diskette drive\r\nother than A, the install batch file accepts explicit parameters for the\r\nsource drive and destination drive.  For example, to install from diskette\r\ndrive B to hard drive D:\r\n\r\n    d:\r\n    md blackstr\r\n    cd blackstr\r\n    b:install b: d:\r\n\r\n\r\nIntroduction\r\n------------\r\n\r\nThe complete source code for the BlackStar Library is included in this\r\ndistribution, in the following directories:\r\n\r\n   clib      - System-independent C source code.\r\n\r\n   ibmlib    - System-dependent C and assembly code.\r\n\r\nEach of these directories has three object subdirectories that contain files\r\nfor recompiling the libraries for use with different High C compilers:\r\n\r\n   dx86_o    - Version 1.6 locally optimizing compiler for MS-DOS 80x86.\r\n\r\n   d386_o    - Version 1.7 locally optimizing compiler for extended DOS\r\n               80386/486.\r\n\r\n   gd386_o   - Version 2.3 globally optimizing compiler for extended DOS\r\n               80386/486.\r\n\r\nIn each object subdirectory you will find the following batch files:\r\n\r\n   comp.bat  - Rebuild libraries.  Make the appropriate object directory (such\r\n               as d386_o) your current working directory, and type \"comp\".\r\n               comp invokes the compiler driver, setting the appropriate\r\n               macros for the given compiler.\r\n\r\n   recomp.bat - Remake only the object modules for which source modules have\r\n               changed.  If you modify a source file, change directory to the\r\n               appropriate object directory and delete the corresponding\r\n               object module.  Then type recomp and the batch file will\r\n               recompile or reassmeble the source files for which object files\r\n               are missing, and then rebuild the library.\r\n\r\nNOTE:  The batch files invoke some tools not supplied with High C.  The\r\n386/486 versions of the batch files use the Phar Lap tools 386asm and 386lib.\r\nThe 80x86 versions of the batch files use the Microsoft tools masm and lib to\r\nbuild the libraries.\r\n\r\nWARNING:  IF YOU ARE USING MICROSOFT'S LINK.EXE, the linker must be told to\r\nincrease the maximum number of segments allowed during the link.  This may be\r\naccomplished by setting the link environment variable with the following\r\ncommand (which may be included in your autoexec.bat file):\r\n\r\n   set link=/SE:400\r\n\r\n\r\nStructure of this distribution\r\n------------------------------\r\n\r\n\\source\\clib            -- Source code for the machine-independent\r\n                            portions of the BlackStar library.\r\n\\source\\clib\\dx86_o     -- Object modules for the 80x86 libraries.\r\n\\source\\clib\\d386_o     -- Object modules for the 80386/486 libraries.\r\n\\source\\clib\\gd386_o    -- Object modules for the 80386/486 for the\r\n                            globally optimizing compiler libraries.\r\n\\source\\ibmlib          -- Source code for the machine-dependent\r\n                            portions of the BlackStar library.\r\n\\source\\ibmlib\\dx86_o   -- Object modules for the 80x86 libraries.\r\n\\source\\ibmlib\\d386_o   -- Object modules for the 80386/486 libraries.\r\n\\source\\ibmlib\\gd386_o  -- Object modules for the 80386/486 for the\r\n                            globally optimizing compiler libraries.\r\n\\inc                    -- Header files for the BlackStar library.\r\n\\lib                    -- Libraries for each of the three High C compilers:\r\n     clibs,ibmlibs      -- Small-model libraries for 80x86.\r\n     clibs,ibmlibc      -- Compact-model libraries for 80x86.\r\n     clibs,ibmlibm      -- Medium-model libraries for 80x86.\r\n     clibs,ibmlibl      -- Large-model libraries for 80x86.\r\n     clibs,ibmlibb      -- Big-model libraries for 80x86.\r\n     clib3,ibmlib3      -- Small-model emulation libraries for 80386/486.\r\n     clibg3,ibmlibg3    -- Small-model emulation libraries for the\r\n                           globally optimizing 80386/486 compiler.\r\n\r\n\\demos                  -- Source code for programs demonstrating the use of\r\n                            some of the BlackStar functions.\r\n\\demos\\dx86_o           -- Executables created with the 80x86 compiler.\r\n\\demos\\d386_o           -- Executables created with the 80386/486 compiler.\r\n\\demos\\gd386_o          -- Executables created with the 80386/486 globally\r\n                            optimizing compiler libraries.\r\n\\utils                  -- Source code for three utility programs which use\r\n                            some of the BlackStar functions.\r\n\\utils\\dx86_o           -- Executables created with the 80x86 compiler.\r\n\\utils\\d386_o           -- Executables created with the 80386/486 compiler.\r\n\\utils\\gd386_o          -- Executables created with the 80386/486 globally\r\n                            optimizing compiler libraries.\r\n\r\n\r\nUsing the BlackStar C Function Library with High C\r\n--------------------------------------------------\r\n\r\nIf you want to link in the BlackStar libraries every time you link with the\r\nHigh C driver, set the USERLIB variable in your hcset.cnf or hc386set.cnf\r\ndriver configuration file.  If you want to specify the additional libraries\r\neach time you link, use the -l and -L driver options.\r\n\r\nIf you want the BlackStar include files included in the compiler include\r\nsearch path, set environment variable SPATH or use driver option -I or\r\n-Hipath.\r\n\r\nSee the High C Programmer's Guide for more information about these options.\r\n\r\n\r\nFloating-Point Instructions\r\n---------------------------\r\n\r\nThe libraries supplied with the distribution are compiled for floating-point\r\ninstruction emulation.  If you want to rebuild the libraries to support a\r\ncoprocessor, you must edit the files comp.bat and recomp.bat in the _o\r\ndirectories to add the appropriate command-line option(s) to generate\r\nfloating-point code.\r\n\r\nFor example, to cause the 80x86 compiler to generate 80287 floating-point\r\ncode, use command-line option -Hon=Floating_point.\r\n\r\nTo generate 80387 floating-point code with the 80386/486 compiler, change\r\ncommand-line option -fsoft in the batch files to -f387.  \r\n\r\nSee the Programmer's Guide for more information about floating-point code.\r\n\r\n\r\nNotes\r\n-----\r\n\r\nGRAPHICS    -- The gr_fill() function puts dots to the screen in the\r\n               background color, and is slow.  Use the sc_clr() function if\r\n               you want to clear the whole screen or if you can clear to\r\n               character boundaries (bytes).\r\n\r\nHEADERS     -- You should include your standard headers before blackstr.h.\r\n               The blackstr.h has #ifndefs for some macros, etc.\r\n\r\nINDOSF      -- The utility for indosf (DOS in critical section) is\r\n               undocumented and should be used with care.\r\n\r\nMOUSE       -- The mouse functions have not been implemented for the\r\n               80386/486.\r\n\r\nINTERRUPTS  -- The interrupt functions have not been implemented for the\r\n               80386/486.  This, also, affects the routine pr_signal() which\r\n               calls the unimplemented function sy_getintv() and\r\n               sy_setintv().\r\n\r\nMEMMODELS   -- The library is now distributed and supported for Small, Medium,\r\n               Large, Compact, and Big memory models for the 80x86, and Small\r\n               model for the 80386/486."
}