!SOSLIF.DEF [100] - SOSLIB developer-customization definitions !VEDIT=100 ![100] April 8, 2013 10:30 AM Edited by Jack ! Created (and included in ASHINC:ASHELL.DEF) !------------------------------------------------------------------- !Notes: ! ! SOSLIB routines that might be subject to compile-time or run-time ! customization by individual sites or developers should include ! this module and customize it with suitable definitions. In the ! standard SOSLIB release, this module is empty, and it is not ! included in updates, so once modified at a site, it stays that ! way. The idea is to promote wider contributions and sharing of ! SOSLIB routines by making it easier for developers to customize ! their compilation or runtime behavior without interfering with ! others' standard usage. ! ! For example, if you have a function that would be useful to ! others, except that it includes a link to your own custom error ! handling routine, you could use conditional compilation to ! exclude that custom code from the standard version. Conversely, ! if you want to use a routine from the SOSLIB, but need to ! customize it in a way that would interfere with the standard ! behavior, you can introduce your own custom compilation symbols ! into your own SOSLIB.DEF file, and the post your updated version ! back to the library, allowing others to potentially debug/improve ! it further. !------------------------------------------------------------------- ++message Standard (null) SOSLIB.DEF !recommendation to developers: define a single symbol for your own !conditional compilations, e.g. ! ! define COMPIL_MICROSABIO = 1 ! !then use it in soslib modules as follows: ! ! ++ifdef COMPIL_MICROSABIO ! ! ++elifdef COMPIL_YOURCOMPANY ! ! ++else ! ! ++endif ! !or perhaps ! ! ++ifdef COMPIL_YOURCOMPANY ! ! +endif