﻿Кросс ассемблер Turbo8 для БК0010-БК0011М
(с) 2014-2017 gid

Использование:
BKTurbo8 -? (--help)
  Вывод этой справки.

Имеется два режима работы. Режим компиляции, с созданием объектных модулей
и исполняемого файла. И режим линковки объектных модулей.

1. Режим компиляции.
BKTurbo8 [-i<c>][-v][-r][-l[name]][-o[name]][-s<0addr>] <cmd> <file_1 *[ file_n]>
  -i<c> (--input <c>) - задать кодировку исходного файла.
      Возможные кодировки:
        a - автоопределение (по умолчанию)
        k - KOI8-R
        o - OEM CP866
        w - ANSI CP1251
        8 - UTF8
        u - UNICODE UTF16LE
  Если автоопределение определило кодировку некорректно, необходимо задать
верную кодировку данным ключом.
  -v (--verbose) - вывод большего количества информации на экран.
      На данный момент дополнительно выводится таблица меток программы.

  -r (--raw) - создавать просто бинарный массив, не использовать формат .bin.

  -l[name] (--listing [name]) - генерировать lst Файл.
      Если имя файла задано, то используется оно для генерации листинга, если
      нет - то берётся имя файла исходного текста.

  -o[name] (--object [name]) - генерировать объектный файл.
      Если имя файла задано, то используется оно для генерации листинга, если
      нет - то берётся имя файла исходного текста.

  -t[name] (--table [name]) - создавать особый объектный файл, в котором
      содержатся только глобальные метки. (См. документацию)

  -s<0addr> (--address <0addr>) - задать начальный адрес компиляции.
      Адрес задаётся в восьмеричном виде.

  <cmd> - команда компиляции:
      CO - полная компиляция. В результате при отсутствии ошибок создаётся
           бинарный исполняемый файл и опционально создаются объектные файлы,
           заданные соответствующими ключами.
      CL - компиляция в объектный файл для дальнейшей линковки с другими
           объектными файлами. В результате при отсутствии ошибок всегда
           создаётся объектный файл. Бинарный файл не создаётся.
      Файл листинга создаётся в любом случае. При наличии ошибок код ошибки
      и его текстовое пояснение помещаются перед строкой листинга, вызвавшей
      ошибку.
      В конец файла листинга записывается таблица глобальных меток, а также
      список ссылок на неопределённые метки, если они есть.

  <file_1 *[ file_n]> - список исходных файлов, перечисленных через пробел.
      Допускаются маски файлов.

2. Режим линковки.
BKTurbo8 [-v][-r][-l[name]][-o[name]][-s<0addr>] LI <outfile> <file_1 *[ file_n]>
  Ключ -i не используется.

  Ключи -v, -r, -l, -o, -t и -s имеют тот же смысл, что и в режиме компиляции.

  Команда линковки - LI, за командой следует обязательное имя выходного файла
  <outfile>, маска файла не допускается. А затем список файлов объектных
  модулей.
  Листинг при этом не создаётся, потому что не из чего, но если задан ключ -l,
  в файл листинга сохраняется список меток, а так же список ссылок на 
  неопределённые метки, если они есть.

  <file_1 *[ file_n]> - список файлов объектных модулей, перечисленных через
      пробел. Допускаются маски файлов.


-------------------------------------------------------------------------------


Конвертер бинарных объектов в объектные модули кросс ассемблера Turbo8.
(с) 2014-2017 gid

Использование:
BKbin2obj -? (--help)
  Вывод этой справки.

BKbin2obj [-s<source>][-e[0bound]][-c][-t][-l<label_name>] <input_file_name> [output_file_name]
  -s<source> (--source <source>) - тип входного объекта.
    Возможные типы:
    bin - просто бинарный массив;
    img - картинка в формате BMP, GIF, JPEG, PNG и TIFF.

  -e[0bound] (--even [0bound]) - выравнивание массива данных по границе блока.
    Если параметр не задан - делается выравнивание по границе слова.
    Параметр - число в восьмеричном виде. Предполагается, что число - степень
    двойки. Если задать произвольное число, результат будет совсем не тем, что
    ожидался.

  -l<label_name> (--label <label_name>) - задать имя метки. Если имя метки не
    задано, оно формируется из имени входного файла.

  Ключи, действующие только при выборе типа img:
  -c (--color) - обрабатывать картинку как цветное изображение, иначе - чёрно-
    белое.

  -t (--transparency) - использование прозрачности.
    Алгоритмы преобразования взяты из проекта pdp11asm vinxru, один к одному,
    я даже не разбирался как они работают.

  input_file_name - входной файл.
  output_file_name - необязательное имя выходного файла, если нужно задать
  объектному файлу имя, отличное от входного.


