Newcat format specifications
############################

version 0.1 (casetta 0.1.*) - writted by Florian Birée, 26 Jun 2006
This document is in the public domain

Orginial uri: http://filyb.info/prog/casio-doc/newcat.0.1.txt

Introduction:
*************

Newcat is a file format make for saving datas from casio graphical calculator, transfert them into differents computer, and editing them in any unix text editor.
You can use the tool casetta to convert others format in newcat.

Specifications:
***************

For the moment, newcat only support program as data type. The format is similary with the legacy cat format (used by FA-12* software) but with many improvement.

A newcat file is a ascii unix text file, ie a text file with return to the line by CR character, with others characters limited in ascii standard characters. All characters are coded on 8 bits.

A newcat file is the sum of many record. Each record correspond with a program. Each record have a header, witch contain metada such as the name of the program. Here is an example of record (line number are just for the followed explainations):

1  %Header Record
2  Format:TXT
3  Communication SW:0
4  Data Type:PG
5  Capacity:
6  File Name:MyPrgm
7  Group Name:
8  Password:
9  Option1:NL
10 Option2:
11 Option3:
12 Option4:
13 %Data Record
14 program content
15 %End

Record description:
-------------------

o Line 2 explain that data is in plain text
o Line 3, 5, 7, 9, 10, 11, 12, 13 are just for a cat compatibility, but may be used in the future
o Line 4 specify the record type. Only PG (program) is supported for the moment
o Line 5: you can write here your program size (in octet). Isn't an obligation.
o Line 6: here is your record name
o Line 8: the password is in plain text
o Line 14: here is the content of the program, as descrived below. He can take all lines you want.

Content:
--------
The content is in plain text. All special characters/commands used by casio calculators are replaced by a text equivalent, such as cat format. But newcat provide more equivalent than cat.

You can found python dictionaries into special characters and newcat equivalents in the attached file newcat-equiv.txt (original uri: http://filyb.info/prog/casio-doc/newcat-equiv.0.1.txt)