
		PLM2C - a translator from PL/M to C
        -----------------------------------

 Plm2C is a translator from  the PL/M  language  to  the  C  language.
 Since the two languages are different, a lot of effort was made to produce 
 a translation that will be clear and readable to the original  software
 programmer.  Another objective is to keep  the  translation, as far as 
 possible, in the  C  language programming style.
 This version handles the following versions of PL/M: 86, 286, & 51.

 The demo version of PLM2C retains the full functionality of the
 product except that the source PL/M file length is limited to
 100 lines and the number of INCLUDE files is limited to one. 

 The demo version can be activated to a fully functional version
 when you send your site code to Alternative Solutions. 
 Please refer to the file "License.txt" or "License.doc" (a Word 6 document)
 or "License.pdf" in this directory.

 This version includes the following directories:

 1. BIN - contains the Plm2c executable.

 2. CONFIG - contains examples of the needed configuration files.

 3. REGISTER - contains the "Register" and its help file. Please see
    the section "REGISTERING" below.

 4. DOC - has three documents:

		plm2c.doc - A user manual and configuration files guide.
			    It includes also the description of the Plm2c
			    translator features. This is an MS WORD 6 file.

		plm2c.txt - Same as plm2c.doc but in ASCII text.

		spec.txt -  Short description of Plm2c specifications 
		  	and limitations. (It is recommended to refer
			first to the detailed DOC files and the EXAMPLES 
			directory).


 5. EXAMPLES -  Contains two additional sub directories:

		PLM - with PL/M short programs illustrating the non trivial
		      translations discussed in the documentation mentioned 
		      above, and some additional examples.
		      This directory contains also examples of the 
		      configuration files "plm2c.dat", "plm2c.bf" and 
		      "plm2c.inc", and a batch file that automates the 
		      translation of the PL/M files.

		C -  a subdirectory which contains the corresponding 
		     translated files. 
	
  It is highly recommended that you have a look at the 'EXAMPLES' 
  sub directory to see the translation examples right after installation.
  It will help you get an immediate appreciation of the state of the art 
  of this translator.


 INSTALLATION

  Copy the plm2c directory to your hard drive. The sub directories include 
  the executables, examples and documentation.
  Set the search PATH to include the PLM2C\bin directory.  To  see  some 
  examples go to the  PLM2C\EXAMPLES\PLM  sub  directory  and  call  the 
  "trnslt.bat" batch file to automate the translation of all the PL/M 
  example files in this directory.
  Once translated, look at the translated files in the "C" sub directory.
  Experiment with your own files and your own examples.

  PLM2C should be used in a DOS/cmd windows under Windows NT, 2000, XP or Vista.
    
  

  Files for installing PLM2C in Windows NT, 2000, XP and Vista:
  ============================================================
  a. SetupEx.EXE - Is the stealth NT install program.
  b. CKS.EXE - is a self-extracting zipfile of the 6 required setup files  - DO 
     NOT EXTRACT THESE - SetupEx.EXE expects to see this file as is!!
  
  Both files are in the PLM2C\bin directory.

  Install Instructions
  ====================
  Go the PLM2C\bin directory and run the SetupEx.EXE program.
  This will install the needed NT drivers for running PLM2C under Windows NT, 2000, XP or Vista. If encountering
  any difficulty during installation switch to using admin privileges.


  Uninstall Instructions
  ======================
  Verify that the SetupEx.EXE and CKS.EXE files are in the PLM2C\bin directory and run SetupEx.EXE /D
  This will uninstall PLM2C NT drivers. If encountering any difficulty in uninstall switch to using admin 
  privileges.



 GETTING STARTED
	
  - Put PLM2C directory in a directory on your computer. An example is C:\ 
  - Create another directory where you want to put all the files to trsnslate. For exmple, C:\PLMfiles
  - Make sure that in the above directory (C:\PLMfiles) you have the following files: 
	plm2c.dat, plm2c.inc and plm2c.bf
  
    These are configuration files that are needed and you can find an example of each under the "Config" 
    sub-directory of PLM2C. You need to update these files as explained in the doc.
  - Create another directory where you want to put all translated files (for example C:\Cfiles)
  - Indicate in the plm2c.dat file that this is the destination directory.
  - Go to the directory where you put all the PLM files and invoke plm2c on each of the PLM files. 
    According to the above examples it should be similar to the following commnad: 

	C:\plm2c\bin\plm2c test.plm



 DISTRIBUTION

  You may distribute the DEMO version to other people as long as it serves
  for demo purposes only. In this case you should distribute all the package
  together, including this file. 
  You may not, however, change or add anything in the documentation or 
  program itself.


 REGISTERING ONLINE

  You you may purchase a license online through a secured server in the following Web site:

	http://www.plm2c.com

  and then click on the "Order" link.


 LICENSE

  Please read the files "License.doc" (Word document), or "License.pdf", or "License.txt" for 
  detailed information on how to activate PLM2C on your computer after buying a license.

  If you purchase the version that is limited by the number of lines of PL/M source
  code you can use it on any number of translation projects.

  If You purchase an UNLIMITED version of PLM2C then it is valid for the purchased period and will expire when it ends.


 COPYRIGHT

  The SOFTWARE is owned by ILAN MAHALAL and is protected by copyright 
  laws and international treaty provisions.  
  Therefore, you must treat the SOFTWARE like any other copyrighted 
  material, except that you may make one copy of the SOFTWARE solely 
  for backup or archival purposes. 
  In any case you may not pass this SOFTWARE to others, rent it or lease it.

 DISCLAIMER

  This software is provided "as is" without warranty of any kind either expressed
  implied or statutory, including but not limited to the implied warranties of
  merchantability and fitness for a particular purpose. The risk for any caused 
  damage is entirely with you.

  
  For more information or questions please consult our Web site 

	http://www.plm2c.com






 
