home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / nasmos2.zip / readme.os2 < prev   
Text File  |  1997-08-24  |  3KB  |  76 lines
  1.            THIS IS AN UNOFFICIAL COMPILE AS OF TIME OF WRITING
  2.  
  3. This version of NASM was compiled for OS/2 by elizium@psychonaut.demon.co.uk
  4.  
  5. USE IT AT YOUR OWN RISK - I ACCEPT NO RESPONSIBILITY FOR ANY ADVERSE EFFECTS
  6. CAUSED BY USING THIS SOFTWARE - READ THE LICENCE FILE FOR MORE INFORMATION
  7.  
  8. Thats the disclaimer...
  9.  
  10. Modifications
  11.  
  12. Only modifications are:
  13.  - The addition of a small timing routine for the purposes of benchmarking. 
  14.    I don't have any large files to test this on so I can't really comment. 
  15.    It is accurate to about 1/100s but only really relevent on larger files.
  16.  - a.out is now default in os/2 version
  17.  - banner messages
  18.  
  19. Compilation
  20.  
  21. Now - this was compiled by me with relative ease - it was compiled using the
  22. following extra compiler options in EMX gcc:
  23.  
  24.           -O2 -m486 -fomit-frame-pointer -funroll-loops -Zomf -Zsys
  25.  
  26. -O2 : normal optimisation
  27. -m486 : 486 instruction optimisation (will not affect 386 machines)
  28. -fomit-frame-pointer : no idea but it makes stuff quicker :)
  29. -funroll-loops : unrolls loops - lots of speedup normally but bigger output
  30. -Zomf -Zomf : use 32bit OS/2 .obj files rather than OS/2 - slightly quicker
  31.  
  32. Please note - this options only affect the speed of the assembler NOT the
  33. speed of assembled sources (although it would be nice if it did! :)
  34.  
  35. Long Filenames
  36.  
  37. The program should have no problems with long filenames - EMX gcc handles
  38. these in a similar way to Linux gcc. Because it uses EMX you will need the
  39. EMX.DLL file which is found in lots of places all over the internet - a 
  40. good place to look is http://hobbes.nmsu.com - you will also need EMXOMF from
  41. the same place if you want to make .obj files
  42.  
  43. Making .obj Files
  44.  
  45. If you run the program with the -h option you will see that the compiler has
  46. the default of a.out - this is the EMX gcc default file format (same as linux)
  47. if you require a 32bit .obj file then use the EMXOMF program which is found
  48. in the EMX distribution archive.
  49.  
  50. To do this simply type EMXOMF filename.obj
  51.  
  52. Information/Bugs
  53.  
  54. If you want any other information please contact me by email. I don't know
  55. whether I will compile future versions as yet, this is because I just compiled
  56. this so I didn't have to use the dos version of Nasm to compile my assembly
  57. code. Bugs with this OS/2 version which don't correspond to the same DOS
  58. version should be reported to me. Other bugs should probably go to the author
  59. but only if they're reproduceable in the DOS version (ie not my fault! :)
  60.  
  61. Speed
  62.  
  63. As for speed of assembly - I have not been able to test this yet because I
  64. have not got any large assembly sources which I can use as benchmark files.
  65. I would presume that it is much faster than DOS (as is the usual case).
  66.  
  67. Compression
  68.  
  69. The executables in this distribution have been compressed using lxlite - this
  70. is similar to pklite but is for os/2 - you can compress .EXE,.DLL and various
  71. other 32bit OS/2 file formats with it. It also removes unnecessary debug 
  72. information from files and which in most cases means that compression does not
  73. affect archive size or makes it smaller. Decompression is at runtime with no
  74. real loss in speed. In this case, it made the zipfile about 40k smaller and
  75. you'll save 320k drivespace when its on your HD. Good enough for you?
  76.