Look up index-names as "index.<name>" in the qualifier configuration
[yaz-moved-to-github.git] / windows.txt
1 YAZ Compilation guidelines for winNT/95.
2   $Id: windows.txt,v 1.5 2000-12-05 19:14:12 adam Exp $
3
4 This distribution of YAZ includes makefiles that works with Visual
5 C++ version 5 and 6. The makefile is located in sub directory 'win'.
6
7 If you wish to make modifications to the make process you should
8 edit makefile before proceeding. For example, a DEBUG version of YAZ
9 can be build by modifying the line 'DEBUG=0' to 'DEBUG=1' in the
10 makefile.
11
12 Run nmake in that directory (in a Command prompt for example). Eg:
13     >CD \YAZ\WIN
14     >NMAKE
15
16 Make sure that the environment variables PATH, LIB and INCLUDE are
17 set properly. They *should* be set by the Visual C++ installation.
18 Programs cl.exe, link.exe and others must be found in the PATH. The
19 standard includes files, standard libraries must be found in INCLUDE
20 and LIB respectively.
21
22 The following components are build by the nmake process:
23
24 yaz.dll - This DLL is made of the source in all sub directories except
25          for 'client' and 'ztest'. To export public functions
26          the header files contain the modifier YAZ_EXPORT which is
27          defined in yconfig.h. The value of this modifier,
28          __declspec(dllexport), is probably specific to Visual C++. 
29
30 yaz-client.exe - A Z39.50 client console application. It is linked with
31          the import library yaz.lib. This application searches for yaz.dll
32          during runtime.
33
34 yaz-ztest.exe - The Z39.50 test server as a console application. It is
35          linked with the import library yaz.lib. When running yaz-ztest
36          make sure it is able to find the record test files dummy-records,
37          dummy-grs, and dummy-words in the current directory. 
38
39          As an option ztest may be installed as an NT service
40          (not Windows 95). Use 'ztest -install <otherargs>' to install
41          it and 'ztest -remove <otherargs>' to remove it again. Example:
42
43             yaz-ztest -install -l ztest.out tcp:@:210
44
45          which specifies a log file to be written. The server listens
46          on port 210.
47
48 After successful compilation all executables and DLL's are located
49 in sub YAZ\BIN. Libraries are located in YAZ\LIB.