Editing Automatic Testing (section)

===1. Get an inventory===
<syntaxhighlight lang="bash">sfbooklist size=1024 public=y list=filter skipfile=admin/skiplist.txt book</syntaxhighlight>

This step is not really necessary, but I do it to get a quick list of all the examples and a list of the subset that will be tested.  I usually capture the output in a file and do a diff with the previous run.  That way I will notice when new examples have been added to book since the last time I ran the tests.

The filters <tt>size= public= skipfile=</tt> limit the collection of examples to be executed.  The '''size=''' filter skips any example that makes more than 1 GB of data.  '''public=y''' means it will run examples that download public data from the server (the default is <tt>public=n</tt>).  The default options for '''local=''' and '''private=''' are both <tt>n</tt>, so examples that use that kind of external data will be skipped.  '''skipfile=''' specifies a list of examples by name that will be skipped.  An example skipfile is [http://sourceforge.net/p/rsf/code/HEAD/tree/trunk/admin/skiplist.txt $RSFSRC/admin/skiplist.txt], it specifies examples I can't run because of stuff I haven't installed and others that take a long time to run on my laptop.  There is also a default filter to skip any example that does not yet have an .rsfproj file.

Running this step will tell you which examples pass these set of filters. The following options will run all examples:
<syntaxhighlight lang="bash">sfbooklist rsfproj=both public=y private=y local=y book</syntaxhighlight>