development/keystest/README

   1 --- LyXtest ---
   2
   3 This is a program to spam LyX with millions of randomly generated key
   4 presses, and collect the crash results.
   5
   6 Since the code involves spamming random keypresses, I'd recommend
   7 running it in a VM, well away from your main X windows session.
   8
   9 In short, to use this, move this directory LT into your LyX source directory
  10 (e.g. lyx-1.6.x, but not lyx-1.6.x/src). Then run LT/lyx_make.sh
  11
  12 It requires the following packages to run
  13   xvkbd wmctrl
  14 the following are also useful:
  15    lyx libqt4-dbg subversion automake
  16
  17 It is run by running ./autolyx in one xterm, and ./test.py in another.
  18 I wrote lyx_make.sh as a easy way of updating lyx and running these two
  19 programs together.
  20
  21 CONTENTS:
  22
  23 README: this readme file
  24 report.sh: A quick way of generating bug reports and an overview from the logs.
  25 autolyx: A script to continually restart lyx and collect the bug reports
  26 lyx_make.sh: should updates, compiles, and everything needed to generated logs.
  27 maketar.sh: Makes this tar file :)
  28 test.py: Sends LT100 randomly generated keypresses per second to the LyX window.
  29 killtest: stop the testing
  30 stock_text: The stock test to add to each bug report.
  31
  32 OUTPUTS:
  33
  34 autolyx: Outputs out/GDB, a log of all output, including backtraces.
  35 test.py: Outputs out/KEYCODES, a list of all keycodes sent to LyX
  36
  37 reports.sh: Outputs
  38   out/overview: an overview of all the frequency of each error
  39   out/overview_sort: as above but sorted
  40   out/report_*: A collection of autogenerated bug reports.