1This is the README file for GNU Teseq. 2 3GNU Teseq is a tool for analyzing files that contain control characters 4and terminal control sequences. It is intended to be useful for diagnosing 5terminal emulators, and programs that make heavy use of terminal 6features (such as those based on the Curses library). 7 8 Copyright (C) 2008,2013 Micah Cowan 9 10 Copying and distribution of this file, with or without modification, 11 are permitted in any medium without royalty provided the copyright 12 notice and this notice are preserved. 13 14The latest version of this program is always available at 15http://ftp.gnu.org/gnu/teseq/. 16 17 18GNU Teseq takes raw terminal data as input, like: 19 20 ^[[1mHi^[[m there, world^H^H^H^H^Hearth 21 22And spits out something like: 23 24 : Esc [ 1 m 25 & SGR: SELECT GRAPHIC RENDITION 26 " Set bold text. 27 |Hi| 28 : Esc [ 0 m 29 & SGR: SELECT GRAPHIC RENDITION 30 " Clear graphic rendition to defaults. 31 | there, world| 32 . BS/^H BS/^H BS/^H BS/^H BS/^H 33 |earth|. 34 35The accompanying program `reseq' may then be used to reverse this 36translated output back into its original form, if desired. 37 38 39See the INSTALL file for information on how to build and install this 40program. 41 42Please report all bugs to bug-teseq@gnu.org. 43 44Teseq has no requirements beyond a normal Unix build environment. 45 46Teseq ships with a companion program, Reseq, which translates the 47output from Teseq back into its original source form. Reseq is written 48in the Perl programming language, and so requires perl in order to 49run. 50 51Teseq also ships with a suite of regression tests. Some of these are 52written in relatively portable POSIX sh; some others require the Check 53test library, available at http://check.sourceforge.net/. 54 55If changes are made to the Check-based test suite sources (*.cm files), 56the Checkmk processor, available at 57http://micah.cowan.name/projects/checkmk/, will be required to generate 58the tests. At some point in the near future, Checkmk will be shipped as 59part of Check, and will not need to be obtained separately. 60 61GNU Teseq is free software. See the file COPYING for copying conditions. 62