src/Tools/8bit/README
changeset 11390 735bf767833a
parent 11389 55e2aef8909b
child 11391 e8638d07fdee
equal deleted inserted replaced
11389:55e2aef8909b 11390:735bf767833a
     1 See doc/manual.dvi for a full description of the 8bit package.
       
     2 
       
     3 
       
     4 USAGE of 8bit package:
       
     5 ======================
       
     6 
       
     7 Configure or set the following environment variables:
       
     8 
       
     9 ISABELLE8BIT: set the directory of the isabelle 8bit package
       
    10 	e.g.:   /usr/proj/isabelle/src/Tools/8bit
       
    11 
       
    12 PATH: add the absolute path of the executables
       
    13 	e.g.:   $ISABELLE8BIT/bin
       
    14 
       
    15 MANPATH: add the absolute path of the manual pages
       
    16 	e.g.:   $ISABELLE8BIT/man
       
    17 
       
    18 TEXINPUTS: add the absolute path of special LaTeX style files used by the 8bit
       
    19            package (if necessary)
       
    20 	e.g.:   $ISABELLE8BIT/latex: 
       
    21 
       
    22 
       
    23 
       
    24 INSTALLATION of 8bit package:
       
    25 ==============================
       
    26 
       
    27 to install,
       
    28 	- change directory to $ISABELLE8BIT
       
    29 	- run mk
       
    30 (after further changes, if may be sufficient to call gmake)
       
    31 
       
    32 for adaptions of the configuration (in directory config/):
       
    33 	- configure the files: conv-tables.inp key-table.inp
       
    34 	- run gmake to generate isa2latex, editor support, and documentation
       
    35 
       
    36 for adapting the conversion table of a2isa (in directory c-sources/a2isa/):
       
    37 	- configure the file: lex.x
       
    38 	- run gmake there
       
    39 
       
    40 
       
    41 CONTENTS of the 8bit package distribution:
       
    42 ==========================================
       
    43 
       
    44 directory axe/
       
    45 
       
    46 the files concerning isaaxe
       
    47 
       
    48 
       
    49 directory bin/
       
    50 
       
    51 available user commands concerning isabelle's graphical 8bit font:
       
    52 isa_xemacs	- replaces xemacs
       
    53 isa_gnu_emacs	- replaces emacs
       
    54 isaaxe		- replaces axe
       
    55 isavim		- replaces vim
       
    56 
       
    57 isaterm		- replaces xterm
       
    58 isapal		- shows the palette of available graphical characters
       
    59 codetable	- prints a the codes of all 8bit characters
       
    60 isa_xmosaic	- replaces xmosaic
       
    61 
       
    62 isa2latex	- converts a file with 8bit characters into a LaTeX source
       
    63 a2isa		- converts isabelle files, from ASCII to graphical characters
       
    64 
       
    65 gen-*		- for administration
       
    66 patcher		- for administration
       
    67 
       
    68 
       
    69 directory c-sources/a2isa/
       
    70 
       
    71 files concerning a2isa
       
    72 change lex.x to adapt its conversion table.
       
    73 
       
    74 
       
    75 directory c-sources/isa2latex/
       
    76 
       
    77 files concerning isa2latex
       
    78 change config/conv-tables.inp to adapt its conversion table.
       
    79 
       
    80 
       
    81 directory config/
       
    82 
       
    83 configuration files for keyboard input and the conversion table of isa2latex
       
    84 
       
    85 
       
    86 directory doc/
       
    87 
       
    88 manual.dvi	- manual of the 8bit package
       
    89 fontindex.dvi	- table of the 8bit characters, indexed by code
       
    90 keyindex.dvi	- table of the 8bit characters, indexed by input keystrokes
       
    91 fkmatrix.dvi	- table of the 8bit characters mapped to function keys
       
    92 
       
    93 directory fonts/
       
    94 font definitions for the Isabelle and Spectrum 8bit fonts
       
    95 install		- install the 8bit font
       
    96 
       
    97 directory keyboard/
       
    98 install		- set the keyboard modifiers
       
    99 subdirectories Solaris/ and Linux/ 
       
   100 		contain sample versions of useful .Xmodmap files
       
   101 
       
   102 directory gnu_emacs/
       
   103 
       
   104 files concerning isa_gnu_emacs
       
   105 
       
   106 
       
   107 directory isa-patches/ and subdirectories
       
   108 
       
   109 
       
   110 
       
   111 
       
   112 directory latex/
       
   113 
       
   114 isa2latex.sty	- Isabelle file style used by isa2latex
       
   115 
       
   116 directory man/man1/
       
   117 
       
   118 manual pages of some executables
       
   119 
       
   120 
       
   121 directory perl/
       
   122 
       
   123 simple perl scripts
       
   124 
       
   125 
       
   126 directory perl/generators/
       
   127 
       
   128 perl scripts for the configuration of many executables
       
   129 
       
   130 
       
   131 directory term/
       
   132 
       
   133 files concerning isaterm
       
   134 
       
   135 
       
   136 directory vim/
       
   137 
       
   138 files concerning isavim
       
   139 
       
   140 
       
   141 directory xemacs/
       
   142 
       
   143 files concerning isa_xemacs
       
   144 
       
   145 
       
   146 directory xmosaic/
       
   147 
       
   148 files concerning isa_xmosaic