third_party/lcov/contrib/galaxy/README

   1 -------------------------------------------------
   2 - README file for the LCOV galaxy mapping tool  -
   3 - Last changes: 2003-09-04                      -
   4 -------------------------------------------------
   5
   6 Description
   7 -----------
   8
   9 Further README contents
  10 -----------------------
  11   1. Included files
  12   2. Installing
  13   3. Notes and Comments
  14
  15
  16
  17 1. Important files
  18 ------------------
  19   README                       - This README file
  20   CHANGES                      - List of changes between releases
  21   conglomerate_functions.pl    - Replacement file - Generates shading
  22   genflat.pl                   - Generates info for shading from .info files
  23   gen_makefile.sh              - Replacement file - updates to postscript
  24   posterize.pl                 - Replacement file - generates a final ps file
  25
  26 2. Installing
  27 -------------
  28      This install requires fcgp, which means the target kernel src must be on
  29 the system creating the map.
  30
  31      Download and copy the new files into the fcgp directory, (Note: its always
  32 a good idea to have backups).
  33
  34      Run genflat.pl against your kernel info files
  35         ./genflat.pl kernel.info kernel2.info > coverage.dat
  36
  37      Run the make command for the fcgp (Note: this can take a while)
  38         make KERNEL_DIR=/usr/src/linux
  39
  40      Update posterize.pl as needed, normally page size, margins, titles.
  41 Most of these settings will be broken out as command line options in the future.
  42
  43      Run posterize.pl this will generate the file poster.ps.
  44
  45 3. Notes and Comments
  46 ---------------------
  47      This is a quick and dirty implementation suited for my needs. It does not
  48 perform any of the tiling the original did.