This repository has been archived by the owner. It is now read-only.
convert between plaintext files and tokenised files for the TI8x series of calculators
C Makefile
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
doc
src
test
.gitmodules
LICENSE
Makefile
README.md

README.md

CURRENTLY INCOMPLETE

and not being worked on. interest == lost since not using those calculators any more. poke me if you want to take over or something; otherwise it'll just be sitting here

tok8x

NAME

tok8x - convert between plaintext files and tokenised files for the TI8x series of calculators

SYNOPSIS

tok8x [OPTION]... [FILE]...
tok8x -i [-p] [-t=token set] TOKEN...

DESCRIPTION

tok8x is a utility for two-way conversion between human-readable text files and TI's .8xp file format for storing TI-BASIC calculator programs. This format is also used by several user-created calculator languages, so support for some of them (currently Axe and Grammer) is included as well.

By default, input is read for the designated files, or stdin if no file names are provided, converted based on the type of the input data (if input is in 8xp format, output will be plain textl if input is plaintext, output will be 8xp), and written to the designated output file, or stdout if none is provided. If options are passed which do not apply to the current input and output formats, they will be ignored.

If the -i option is designated, arguments should be representations of tokens provided either as their string names (i.e. ">DMS", "Asm(") or their hexadecimal values (i.e. "01", "BB6A").

OPTIONS

  • -h, --help: display help dialogue

  • -i, --info: rather than converting files, return information on one or more tokens provided either as their string names (i.e. ">DMS", "Asm(") or their hexadecimal values (i.e. "01", "BB6A").

  • -t, --token_set=(axe|basic|grammer): define token set to be used

  • -o, --output=FILE: define file to be written (defaults to stdout)

  • -n, --name=NAME: define on-calc name (defaults to 'A'. affects only 8xp output)

  • -a, --archived: generate archived program (affects only 8xp output)

  • -p, --pretty: use "pretty" output, i.e. unicode approximations that more closely resemble the true appearances (affects plaintext output or printing information with -i)

  • -s, --safe: when outputting to plain text, insert backslashes before single-character strings which could be misconstrued as the beginning of a token name to ensure they will remain distinct tokens if converted back to 8xp (affects only plaintext output)

  • -c, --condense: strip excess whitespace to reduce on-calc size (affects only 8xp output)

  • -e, --expand: insert whitespace to make output more easily human readable (affects only plaintext output)

BUGS

Please report any bugs to https://github.com/shmibs/tok8x/issues

AUTHOR

Katherine Martin shmibs@shmibbles.me