os2/README.OS2

   1 lclint 3.0.0.16 for OS/2\r
   2 ========================\r
   3 \r
   4 This file is originally part of the binary distribution of lclint for OS/2.\r
   5 \r
   6 Contents:\r
   7 ---------\r
   8 \r
   9  Differences to the Unix versions\r
  10  Installation\r
  11  Bugs and known problems\r
  12  Where to get\r
  13  History\r
  14  Afterword\r
  15 \r
  16 \r
  17 Differences to the Unix versions:\r
  18 ---------------------------------\r
  19 \r
  20 1. lclint searches for the initialization file in the current directory \r
  21    and additionally in the directory pointed to by the environment \r
  22    variable "HOME" if set. \r
  23 \r
  24 2. For path specifications "\" can be used instead of "/". In most\r
  25    cases any of both, even in combination are fine.\r
  26 \r
  27 3. lclint/2 will use the value of the environment variable TMP (if not set\r
  28    TEMP) for creating and reading temporary files if possible. Else the\r
  29    current directory is used.\r
  30 \r
  31 \r
  32 Installation:\r
  33 -------------\r
  34 \r
  35 For installing lclint there are four steps necessary:\r
  36 \r
  37 1. Place the executable file lclint.exe in some directory in your PATH.\r
  38 2. Install all that's in the "imports" and "lib" subdirectories somewhere\r
  39    you like it. You will need a HPFS drive to install these files.\r
  40 3. Set the environment variable LARCH_PATH to the `lib' subdir in the \r
  41    main LCLint directory, like:\r
  42      set LARCH_PATH=d:\software\lclint-3.0.0.16\lib\r
  43    Then set LCLIMPORTDIR to the `imports' subdir in the main LCLint\r
  44    directory, like:\r
  45      set LCLIMPORTDIR=d:\software\lclint-3.0.0.16\imports\r
  46    You may want to add these statements to your your config.sys file \r
  47    as soon as you've got the software working. \r
  48 4. If you want to use some standard settings different from what's built\r
  49    in edit and place the configuration file `.lclintrc' somewhere lclint \r
  50    can find it. This is the directory pointed to by the HOME environment\r
  51    variable if set or else the directory containing the executable file.\r
  52    It seems a good idea to put all global stuff into that file and all\r
  53    project dependent information into another `.lclintrc' in the directory\r
  54    containing the sources to be checked by lclint. lclint will first\r
  55    read the global and then the local `.lclintrc'.\r
  56 \r
  57 For building lclint you will need the complete sources package. Untar that\r
  58 file. You need HPFS to compile the package because there are plenty of \r
  59 files with long filenames. Refer to the file BUILD.OS2 for further \r
  60 instructions. \r
  61 \r
  62 \r
  63 Bugs and known problems:\r
  64 ------------------------\r
  65 \r
  66 There are a few things that still do not work properly. As lclint was\r
  67 originally developed on and for Unix systems e.g. path names differ.\r
  68 Currently all paths specified in the command line have to contain\r
  69 backslashes rather than slashes which will be quite normal for people\r
  70 with no Unix background anyway. Also not all tests work well yet, at\r
  71 the moment only the "quicktest" with a few changes is available.\r
  72 \r
  73 \r
  74 Where to get:\r
  75 -------------\r
  76 \r
  77 In any case future versions of lclint for OS/2 will be available from the\r
  78 lclint homepage at:\r
  79  - http://lclint.cs.virginia.edu/\r
  80 \r
  81 I will try to upload the file to at least the following sites (the file \r
  82 should be located somewhere in the OS2/DEVELOP areas):\r
  83  - ftp.cdrom.com\r
  84  - ftp.hobbes.nmsu.edu\r
  85  - ftp.leo.org\r
  86 I always put any fixes (even unofficial ones) to my private ftp directory\r
  87 at:\r
  88  - ftp.fh-wedel.de/pub/fh-wedel/staff/herbert/lclint\r
  89 \r
  90 \r
  91 History:\r
  92 --------\r
  93 \r
  94 The following things specific to the OS/2 version of lclint have changed / \r
  95 fixed since the first official release:\r
  96 \r
  97 version 3.0.0.16:\r
  98 - Bugfixes.\r
  99 \r
 100 version 3.0.0.14:\r
 101 - first OS/2 version of the current alpha.\r
 102 - changed the name of the initialization file to `.lclintrc'.\r
 103 \r
 104 version 2.5m:\r
 105 - only some fixes mostly derived from the Win32 port.\r
 106 \r
 107 version 2.4b:\r
 108 - First official OS/2 release.\r
 109 - Switched from IBM's CSet++ 2.01 to VisualAge C++ 3.0.\r
 110 \r
 111 version 2.3i:\r
 112 - Due to my mistake the "HOME" environment variable was ignored even if it \r
 113   was set.\r
 114 \r
 115 version 2.3h:\r
 116 - IBM's CSet++ is now used as default compiler instead of emx/gcc.\r
 117 - lclint compiled as a.out binary using emx/gcc now runs fine under DOS.\r
 118 - In the previous release some temporary files did not get removed properly.\r
 119 - Sometimes lclint delivered the names of temporary files rather than the\r
 120   original source files when reporting errors.\r
 121 - Sometimes include files were not found.\r
 122 \r
 123 \r
 124 Due to the differences between Unix and OS/2 (file-I/O, standard directory\r
 125 structures etc.) there are still some more to expect!\r
 126 \r
 127 \r
 128 Afterword:\r
 129 ----------\r
 130 \r
 131 I have not yet fully ported Makfiles / scripts for a full-featured test\r
 132 suite. The simple Makefile.os2 in the test/ directory allows checking\r
 133 the C sources belonging to the suite and looking at the output (or \r
 134 directing it to a file using "make -f Makefile.os2 >test.log 2>&1" or\r
 135 something similar. \r
 136 \r
 137 After having used lclint/2 on a few projects now I may say it has got \r
 138 more reliable. Still I do not know enough about it yet to be able to do  \r
 139 more sophisticated testing than just using it for my sources or running\r
 140 the (simplified) test suite. If you run across any OS/2-specific problems \r
 141 write me an email -- I will *try* to fix it. But, please, do not forget \r
 142 that I am *not* the author of lclint!\r
 143 \r
 144 You can reach me via Email or fido-netmail:\r
 145 \r
 146 Email: herbert@paulina.shnet.org (at home)\r
 147        herbert@fh-wedel.de (at work)\r
 148 Fido:  2:240/5216.18\r
 149 \r
 150 Have fun!\r
 151 \r
 152 Martin "Herbert" Dietze\r