Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
MYTOOL(1)			LINUX COMMANDS			     MYTOOL(1)

NAME
       mytool -	manipulate map files for yudit,	uniconv	and uniprint

SYNOPSIS
       mytool  [  -info	 ]  [  -test ] [ -showkeys ] [ -decode ] [ -encode ] [
       -strip ]	[ -benchmark ] [ -name new-name	] [ -comment new-comment  ]  [
       -type  new-type	] [ -write output-file ] [ -my input-file ] [ -mys in-
       put-file	] [ -rmys input-file ] [ -kmap input-file ]  [	-rkmap	input-
       file  ] [ -uni:l,u input-file [ -8 ] [ -high ] [	-low ] [ -runi:l,u in-
       put-file	[ -8 ] [ -high ] [ -low	] ] [ -convert out-file-format ]

DESCRIPTION
       mytool is a my map file manipulation program in the yudit distribution.
       It can generates	so-called binary nbit (	my ) map file that can map any
       sequences of bytes into any sequences  of  bytes.  These	 sequences  of
       bytes  can be grouped into 1,2,4	and 8 bytes long words.	 The input se-
       quence length may be different from the matched sequence	length.	 'i  /
       'n  ->  'b specifies that the word 'in' produces	'b' but	only the 'i is
       consumed	from the input buffer.

       It can also generate a so-called	binary umap file, that maps  8	or  16
       bit  single  words into 16 bit single words and it contains the reverse
       map too.

       It can also disassemble the input map and produce a mys source file.

       The input can be	a binary umap file, a my file, mys file	a  uni	and  a
       kmap  file for yudit. It	is recommended that all	kmap files use the new
       mys format because it gives more	freedom	to define the mapping.

       The yudit distribution has a simple document  yudit/doc/my.doc  on  the
       binary  map formats, and	a source file example file yudit/mytool/my/ex-
       ample.mys please	refer to this for more details.

OPTIONS
       -info  prints out a small information on	the current map.

       -test  lets you test the	map interactively.

       -showkeys
	      show all the keys	in the map file.

       -encode
	      builds a state machine in	the encoding part of the map file. The
	      resulting	map file can be	written	to disk	with the -write	option
	      The resulting my files can contain state	machines  to  speed-up
	      conversion.  A  state machine based my file can manifest 10%-70%
	      performance improvement, so it may  be  desirable	 for  encoding
	      fontmaps.	  For fontmaps the bumap format	might be better	suited
	      where only one character and not a sequence of  characters  need
	      to be mapped.

       -decode
	      builds a state machine in	the decoding part of the map file.

       -strip strips  off  the	state machines from the	map files.  The	-write
	      option can be used to save the new map file.

       -benchmark
	      option performs a	simple benchmark test on the map file, to com-
	      pare speed of simple, state machine based	and binary  map	 based
	      map files.

       -nocomment
	      option  strips  all comments from	an input source	file of	format
	      mys kmap uni.  It	does not strip comments	from a binary file.

       -name new-name
	      assigns a	name to	the map	file.

       -comment	new-comment
	      assigns a	comment	to the map file.

       -type new-type
	      assigns a	map file a distinctive	type,  that  can  be  kmap  or
	      fontmap  but  it	is  only  informative.	Keymaps	can be used as
	      fontmaps and vice	versa.

       -write output-file
	      writes the data into an output file.  mytool never modifies  the
	      original file. All modifications should be explicitly saved with
	      the this option.	Never specify the same file for	input and out-
	      put.

       -my input-file
	      load  a  binary  map file. Only one of this option can be	speci-
	      fied.

       -mys input-source-file
	      load a source file.

       -rmys input-source-file
	      load a source file and reverse it	- make encoding	 from	decod-
	      ing and vice versa.

       -kmap input-source-file
	      load a source file in kmap format.

       -rkmap input-source-file
	      load  a source file and reverse it - make	encoding  from	decod-
	      ing and vice versa.

       -uni:l,u	input-source-file
	      load a source file in Unicode Consortium format. This format has
	      the local	code in	column l, and unicode in column	u. The number-
	      ing of columns start from	0.

       -runi:l,u input-source-file
	      load a source file in Unicode Consortium format and reverses it.
	      Make encoding from decoding and vice versa.

       -8     option can be used with the -uni or -runi	options. It  specifies
	      that the input is	8 bit and not 16 bit.

       -high  option  can be used with the -uni	or -runi options. It specifies
	      that the key should be or'ed with	0x8080.

       -low   option can be used with the -uni or -runi	options. It  specifies
	      that the key should be and'ed with 0x7f7f.

       -convert	output-file-format
	      converts	the  map file to a format. It is useful	only when com-
	      bined with -write	option.	 The possible formats are my  -binary,
	      mys  -source,  myc -my-c-source, umap -umap-c-source, bumap -bi-
	      nary-umap	formats.  For maps where only a	single 8 or 16 bit lo-
	      cal code	should be converted  into  16  bit  unicode  and  vice
	      versa,  the  umap	 file  formats	are recommended.  The c-source
	      files are	provided so that you can inlucde a full	map into the c
	      program.

DIAGNOSTICS
       mytool prints out an error message and exits with a non-zero status  on
       error.  If there	is no error the	exit status is zero.

SEE ALSO
       uniconv

AUTHOR
       This program  was written by gsinai@iname.com (Gaspar Sinai).

       Tokyo, 03 January, 2000.

LINUX COMMANDS			  Jan 03 2000			     MYTOOL(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mytool&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help