Contents | Parent Topic | Previous Topic | Next Topic
Home | Catalog
If SDF is not yet installed, you will need to fetch it and install it. The latest version of SDF can be fetched from the SDF download page, http://www.mincom.com/mtr/sdf/download.html.
If Perl is not installed, you will also need to fetch and install it. Various ports of Perl can be obtained from the Perl Home Page (http://www.perl.com/index/).
SDF installation details are provided below for:
Some general Installation Notes are also provided.
Use the
gunzip sdf-2.000.tar.gz tar xvf sdf-2.000.tar
Build, test and install the software like this:
perl Makefile.PL make make test make install
Unpack the distribution using a program which understands long file names (e.g. WinZip).
Within the Control Panel, go to the System properties, select the Environment tab and edit the variables as follows:
Test the software. To do this:
If anything fails, sdftest will leave the failed .out and .log files in the relevant directories.
Unpack the distribution using a program which understands long file names (e.g. WinZip).
Update the PATH to include the bin\dos directory where SDF is installed. For example, if SDF is installed in c:\sdf, then the command is:
set PATH=%PATH%;c:\sdf\bin\dos
Edit (or add) the PERL5LIB system variable to include the Perl libraries used by SDF. For example, if SDF is installed in c:\sdf, then the command is:
set PERL5LIB=%PERL5LIB%;c:\sdf\perllib
Set the SDFBIN variable to point to the directory containing SDF's scripts, including the trailing \. For example, if SDF is installed in c:\sdf, then the command is:
set SDFBIN=c:\sdf\bin\
Test the software. To do this:
If anything fails, sdftest will leave the failed .out and .log files in the relevant directories.
Use
pkunzip -d sdf.zip
Update the PATH to include the bin\dos directory where SDF is installed. For example, if SDF is installed in c:\sdf, then the command is:
set PATH=%PATH%;c:\sdf\bin\dos
Edit (or add) the PERL5LIB system variable to include the Perl libraries used by SDF. For example, if SDF is installed in c:\sdf, then the command is:
set PERL5LIB=%PERL5LIB%;c:\sdf\perllib
Set the SDFBIN variable to point to the directory containing SDF's scripts, including the trailing \. For example, if SDF is installed in c:\sdf, then the command is:
set SDFBIN=c:\sdf\bin\
Test the software. To do this:
If anything fails, sdftest will leave the failed .out and .log files in the relevant directories.
The tar.gz and zip distributions should both contain the same set of files. Therefore, it shouldn't matter which distribution you obtain provided you have the necessary software to unpack it.
The sdf.ini configuration file (in the sdf/home directory on Perl's library path) contains several sets of configuration parameters which you may want to edit after SDF is installed. Refer to the comments in the file for further details.
SDF has been briefly tested with:
Both seem to work ok, although running sdftest with the 5.004_02 port leaves zero length .out and .log files for the tests which work (when they should be deleted).
This environment variable is only used by the Windows/DOS wrapper batch files within bin/dos to find the real scripts. Therefore, if you wish to wrap the scripts in some other way, then there is no need to set this variable.
Unlike earlier versions, the 2.000 release includes support for Macintosh filename handling. Installation instructions for the Macintosh will be made available soon.
When the sdf command is run without arguments, the output should be something like:
usage : sdf [+alias] [-h[help]] [-o[out_ext]] [-l[log_ext]] [-2 format] [-D var iable,..] [-n split_level] [-f flag,..] [-I include_path,..] [-p prefilter] [-a parameters] [-P[plang]] [-N[line_numbers]] [-r report] [-L locale] [-k look] [-s style] [-S page_size] [-c config] [-u uses,..] [-H head_level] [-d driver] [-y post_filter] [-z post_process,..] [-t target] [-v[verbose]] [-w width] sdf_file ... purpose: convert an sdf file to another format version: 2.000 (SDF 2.000)
If this fails, check the following:
SDF is supplied with a regression testing system. To run the tests, change to the t directory within the SDF distribution and execute sdftest like this:
sdftest
This command can be used at anytime to verify your installation of SDF.
The SDF Sample Showcase contains SDF source code and matching outputs. If you wish to conduct further tests, these samples can be used.
Contents | Parent Topic | Previous Topic | Next Topic
Home | Catalog