:orphan:

============
skool2ctl.py
============

SYNOPSIS
========
``skool2ctl.py`` [options] FILE

DESCRIPTION
===========
``skool2ctl.py`` converts a skool file into a control file. The control file is
written to stdout. When FILE is '-', ``skool2ctl.py`` reads from standard
input.

OPTIONS
=======
-a, --no-asm-dirs
  Do not write ASM directives.

-b, --preserve-base
  Preserve the base of decimal and hexadecimal values in DEFB, DEFM, DEFS and
  DEFW statements. (By default, only binary values are preserved.)

-h, --hex
  Write addresses in hexadecimal format.

-V, --version
  Show the SkoolKit version number and exit.

-w, --write `X`
  Write only these elements, where `X` is one or more of:

  |
  |   ``b`` = block types and addresses
  |   ``t`` = block titles
  |   ``d`` = block descriptions
  |   ``r`` = registers
  |   ``m`` = mid-block comments and block end comments
  |   ``s`` = sub-block types and addresses
  |   ``c`` = instruction-level comments

  The default is to write all of these elements.

EXAMPLES
========
1. Convert ``game.skool`` into a control file named ``game.ctl``:

   |
   |   ``skool2ctl.py game.skool > game.ctl``

2. Convert ``game.skool`` into a control file containing only block types,
   addresses and titles:

   |
   |   ``skool2ctl.py -w bt -a game.skool > game.ctl``
