src/Tools/8bit/README
changeset 1826 2a2c0dbeb4ac
child 4175 06774cd43054
equal deleted inserted replaced
1825:88d4c33d7947 1826:2a2c0dbeb4ac
       
     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 gmake (the gnu version of make) on the Makefile there
       
    30 
       
    31 for adaptions of the configuration (in directory config/):
       
    32 	- configure the files: conv-tables.inp key-table.inp
       
    33 	- run gmake to generate isa2latex, editor support, and documentation
       
    34 
       
    35 for adapting the conversion table of a2isa (in directory c-sources/a2isa/):
       
    36 	- configure the file: lex.x
       
    37 	- run gmake there
       
    38 
       
    39 
       
    40 CONTENTS of the 8bit package distribution:
       
    41 ==========================================
       
    42 
       
    43 directory axe/
       
    44 
       
    45 the files concerning isaaxe
       
    46 
       
    47 
       
    48 directory bin/
       
    49 
       
    50 available user commands concerning isabelle's graphical 8bit font:
       
    51 isa_xemacs	- replaces xemacs
       
    52 isa_gnu_emacs	- replaces emacs
       
    53 isaaxe		- replaces axe
       
    54 isavim		- replaces vim
       
    55 
       
    56 isaterm		- replaces xterm
       
    57 isapal		- shows the palette of available graphical characters
       
    58 codetable	- prints a the codes of all 8bit characters
       
    59 isa_xmosaic	- replaces xmosaic
       
    60 
       
    61 isa2latex	- converts a file with 8bit characters into a LaTeX source
       
    62 a2isa		- converts isabelle files, from ASCII to graphical characters
       
    63 
       
    64 gen-*		- for administration
       
    65 patcher		- for administration
       
    66 
       
    67 
       
    68 directory c-sources/a2isa/
       
    69 
       
    70 files concerning a2isa
       
    71 change lex.x to adapt its conversion table.
       
    72 
       
    73 
       
    74 directory c-sources/isa2latex/
       
    75 
       
    76 files concerning isa2latex
       
    77 change config/conv-tables.inp to adapt its conversion table.
       
    78 
       
    79 
       
    80 directory config/
       
    81 
       
    82 configuration files for keyboard input and the conversion table of isa2latex
       
    83 
       
    84 
       
    85 directory doc/
       
    86 
       
    87 manual.dvi	- manual of the 8bit package
       
    88 fontindex.dvi	- table of the 8bit characters, indexed by code
       
    89 keyindex.dvi	- table of the 8bit characters, indexed by input keystrokes
       
    90 fkmatrix.dvi	- table of the 8bit characters mapped to function keys
       
    91 
       
    92 directory fonts/
       
    93 font definitions for the Isabelle and Spectrum 8bit fonts
       
    94 install		- install the 8bit font
       
    95 
       
    96 directory keyboard/
       
    97 install		- set the keyboard modifiers
       
    98 subdirectories Solaris/ and Linux/ 
       
    99 		contain sample versions of useful .Xmodmap files
       
   100 
       
   101 directory gnu_emacs/
       
   102 
       
   103 files concerning isa_gnu_emacs
       
   104 
       
   105 
       
   106 directory isa-patches/ and subdirectories
       
   107 
       
   108 
       
   109 
       
   110 
       
   111 directory latex/
       
   112 
       
   113 isa2latex.sty	- Isabelle file style used by isa2latex
       
   114 
       
   115 directory man/man1/
       
   116 
       
   117 manual pages of some executables
       
   118 
       
   119 
       
   120 directory perl/
       
   121 
       
   122 simple perl scripts
       
   123 
       
   124 
       
   125 directory perl/generators/
       
   126 
       
   127 perl scripts for the configuration of many executables
       
   128 
       
   129 
       
   130 directory term/
       
   131 
       
   132 files concerning isaterm
       
   133 
       
   134 
       
   135 directory vim/
       
   136 
       
   137 files concerning isavim
       
   138 
       
   139 
       
   140 directory xemacs/
       
   141 
       
   142 files concerning isa_xemacs
       
   143 
       
   144 
       
   145 directory xmosaic/
       
   146 
       
   147 files concerning isa_xmosaic