Directory overview:

===================

As writing portable assembler sources supporting different operating

systems, compilers and assemblers has proven to be extremely painful,

the assembler sources have been converted into a more portable 'db'

format. Use these whenever possible.

  src_gas       sources converted for portable gcc/gas syntax

  src_masm      sources converted for portable masm/tasm/wasm syntax

  src_nasm      sources converted for portable nasm syntax

  src           assembler sources (you need the OpenSource nasm assembler)

  obj           pre-assembled object files

Also look 'src_XXX/all/asm_all.asm' which contains all assembler

functions conveniently arranged into a single file.

Notes:

======

- The assembler sources are designed for a flat 32-bit memory model

  running in protected mode - they should work with all i386

  32-bit compilers around.

- All functions expect a 'cdecl' (C stack based) calling convention.

  The function return value will be placed into 'eax'.

  All other registers are preserved.

- Prototypes for the assembler functions can be found in <lzo/lzo_asm.h>.

- For reasons of speed all fast assembler decompressors (having '_fast'

  in their name) can access (write to) up to 3 bytes past the end of

  the decompressed (output) block. Data past the end of the compressed

  (input) block is never accessed (read from).

  [ technical note: because data is transferred in 32-bit units ]

- Finally you should test if the assembler versions are actually faster

  than the C version on your machine - some compilers can do a very good

  optimization job, and they also can optimize the code for a specific

  processor type.