7.5.5. Building Interscript

If you are keen, you can try to rebuild interscript.

YOU HAVE TO BE REALLY KEEN!

Whew. Now I've done my duty and tried to disuade you ..

The whole of the source is in "interscript/src". I recommend you create a development directory separate from the initial (pre-built) installation. Copy the sources into this directory and invoke the pre-built interscript command line tool 'iscr' on the file 'iscr.pak' like this:

  iscr iscr.pak

This should build a directory 'interscript' in the current directory. You may notice some 'errors'. Don't worry! Most of these are normal. Errors occur 'normally' when interscript tries to read files that don't exist yet, but get created later in the run.

Now issue the command

  iscr --test "--weavers='all'" --passes=4 iscr.pak

This should rebuild interscript, this time using the package built by the previous run, and also generating the documentation. If you have problems, try using the "-v" switch:

  iscr --test -v "--weavers='all'" --passes=4 iscr.pak

To capture the output, use the logfile option:

  iscr --test --logfile=iscr.log -v "--weavers='all'" --passes=4 iscr.pak

Note that the "--test" switch must come first, it is a command line tool option, not an interscript option. This option adds the current directory to the python path before trying to import the interscript module. If your build of interscript fails, you can edit the sources and rebuild without the "--test" option. You can't build with it (unless the build failed utterly-- or you delete the interscript directory or interscript.pth file first).

To install your new version of interscript, copy the interscript directory to your standard installation point. Don't do this unless you're sure it works! (If it doesn't, you may not be able to rebuild interscript without re-installing from the tar ball .. because you need a working copy of interscript to build interscript).

You can rebuild any code file by just running interscript on the ".ipk" file defining it. This won't rebuild the documentation correctly! But it is very much faster than rebuilding the whole package.