Notes on how this package is tested.
────────────────────────────────────

This package can be tested by executing

    sh call-pymol-scripts /usr/share/pymol/examples "(multiclip_ray)|(xmlrpc01)|(sd_annotate)|(povray01)"

in order to confirm its integrity.

`call-pymol-scripts` searches for various pymol scripts (*.py or *.pml files)
in the directory of interest (that directory must be provided as a script 
parameter). It calls all scripts one by one from pymol with `-c` 
flag, and checks if the line "PyMOL: normal program termination." is present 
in stdout - this line indicates that pymol exited normally after the script 
was processed. It also checks if any errors appear in output (for now error is 
detected if word 'Traceback' or 'error' is present).

First parameter of `call-pymol-scripts` should be the directory of interest. 
Second parameter is optional - it is a pattern for `egrep` to detect files 
which must be skipped.

In the provided example several files are skipped - to run them, follow the 
instructions below.

/usr/share/pymol/examples/devel/sd_annotate.pml
-----------------------------------------------
This script must be executed from the directory it is located at:

  (cd /usr/share/pymol/examples/devel/; pymol -c sd_annotate.pml)
  
/usr/share/pymol/examples/devel/xmlrpc01.py
-------------------------------------------
To run this script, follow the instructions provided inside of it. 
Was not tested.

/usr/share/pymol/examples/cookbook/multiclip_ray.pml
----------------------------------------------------
This script can be run by executing
  
    pymol /usr/share/pymol/examples/cookbook/multiclip_ray.pml
  
Note that this requires display to be installed and can't be run with Xvfb-run,
because at final step it actually displays image, and this is blocking operation.
It also requires ImageMagick to be installed (which can be done by executing 
`sudo apt-get install imagemagick`).

----------------------------------
Many other useful scripts for PyMOL (according to information given on this 
page: http://www.pymolwiki.org/index.php/Git_intro) are available on Github:
https://github.com/Pymol-Scripts/Pymol-script-repo
