Return to README.win32 CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / gpl / axl

Annotation of gpl/axl/README.win32, revision 1.1.1.1

1.1       misho       1:              
                      2:             -= Compiling LibAxl under Microsoft Windows =-
                      3: 
                      4: 1. Intro
                      5: ~~~~~~~~
                      6: 
                      7:   There are two know ways to compile LibAxl under windows: using gcc
                      8: tools, provided by the mingw project [1] or using one of the Microsoft
                      9: C compilers. 
                     10: 
                     11:   In any case, you must take into consideration these basic steps for
                     12: both:
                     13: 
                     14:   1) You must create an axl_config.h file, using the
                     15:      axl_config_win32.h file provided. Just rename it. 
                     16: 
                     17:   2) If you are using Microsoft C compilers, you must ensure you can
                     18:      have access to the _vscprintf function or not. If you can, which
                     19:      is the recomended, you must define a preprocessor as follows:
                     20:   
                     21:         HAVE_VSCPRINTF
                     22: 
                     23:      See axl_stream_vprintf_len function inside the axl_stream.c
                     24:      module to get a more accurate idea.
                     25: 
                     26:      If you can't get access to such function (which is relatively
                     27:      recent), just do nothing. This will make Axl Library to use
                     28:      default implementation for the axl_stream_strdup* family of
                     29:      functions to be limited to 8192 bytes. 
                     30: 
                     31:      In many cases this isn't a problem, but you are adviced.
                     32: 
                     33: 2. GCC and Mingw
                     34: ~~~~~~~~~~~~~~~~
                     35: 
                     36:   This is default platform we are using to get LibAxl working under
                     37: windows. It is showed to get really good results and good performance,
                     38: however there is a problem. Gcc tools do not produce a debug
                     39: information format that could be used by Microsoft tools. 
                     40: 
                     41:   Obviously, if this is not a problem for you, then you don't have any
                     42: problem, and, under this situation we recomend to use gcc as default
                     43: compilation tool.
                     44: 
                     45:   You can use files provided inside the src, ns and test directory to
                     46: compile Axl: Makefile.win
                     47: 
                     48: 3. Microsoft compilers
                     49: 
                     50:   Axl library is tested to compile and run properly using Visual C 6.0,
                     51: Visual Studio 2005 and its express edition.
                     52: 
                     53:   With the source code are provided visual studio project files to
                     54: make it easy to compile LibAxl. See libaxl.sln under the top source
                     55: directory.
                     56: 
                     57: 4. Testing build done
                     58: 
                     59:   Whatever you compiler is, you must execute the test_01 regression
                     60: test, found inside the test directory to ensure your build will
                     61: provide a proper function. All tests must be passed.
                     62: 
                     63: 5. Futher information and resources
                     64: 
                     65:   Remember you can get more information at [1], [2], [3] and [4]. 
                     66: 
                     67:   If you want commercial support, contact us directly at: info@aspl.es
                     68: (either Spanish or English). 
                     69: 
                     70:   A limited community support, according to the colaboration received,
                     71: is also provided at the mailing list [4].
                     72: 
                     73: 6. Resources
                     74: 
                     75:   [1] [Mingw project]         http://www.mingw.org
                     76:   [2] [Axl library project]   http://xml.aspl.es
                     77:   [3] [ASPL homwpage]         http://www.aspl.es
                     78:   [3] [ASPL mailing list]     http://lists.aspl.es
                     79: 
                     80: --
                     81: Francis Brosnan Blázquez
                     82: francis@aspl.es