Read Me

$30.06.2008
$README.TXT


I. Notices to the copyright and author rights of the COMREG application.

1. The .NET Core Interface (Fusion Application Programming Interface)

Fusion.idl is the COM interface to portions of mscoree.dll (the .NET Core) and is property of Microsoft, although it can be obtained legally for no cost.
Furthermore Microsoft keeps the right to modify it, re-code or event obsolate it at any time it decides to do so.
Thus including the Fusion API in COMREG is made with no warranty for propper functioning under any .NET Framework published by Microsoft, nor
shall be the COMREG authors charged for any loss of profit or data, damage on other software or on the running machine, or any other losses or
damages caused by the COMREG application.

2. The DLL Registering Service for unmanaged executables

The class DllRegisterService has been assemblied from other open source code samples, most of them are not available on-line anymore.
Although the class has been adopted, bugfixed and improved, no originality is claimed at all for the whole class DllRegisterService.


II. Compilation and Installation

For compiling the COMREG sources a installation of MS VisualStudio .NET 2005 or MS VisialStudio .NET 2008 is needed. These
products are proprietary and my require additional licensing, payment and registration. These products are copyright by their
respective copyright owners (Microsoft Corp.).

For compiling the COMREG application, just open the appropriate solution (subfolder with the corresponding version name under the main program folder) and
make a build. For example to compile COMREG with MSVS 2005 open the solution under comreg\msvs2005 and then press F7 or click the
build button/choose the Build menu item under the Project menu.

COMREG does not need any satellite assemblies, nor needs any kind of installation. The sole requiremen to run properly is to have
the appropriate .NET runtime installed (.NET Framework 2.0.xxxx for MSVS 2005 and .NET Framework 3.5 for MSVS 2008).

Note for the porters of Microsoft .NET Frameworks to the open source runtimes like Mono or GNU.NET:
Due to usage of PInvoke, COMREG can not be compiled under Mono or GNU.NET. As long as these .NET ports does not
include fully functional PInvoke implementation, it will remain so - no support for Mono and GNU.NET


III. Commandline syntax

COMREG can run in two modes: command-line and GUI. In GUI mode the application display simple form with controls
to operate with .NET assemblies, COM Typelib containers or other ActiveX controls or executables.
In command-line mode, the application runs like a tool from the operating system and has command line syntax like bellow.


Syntax:	comreg.exe [$parameters]
Command line parameters and their description

  -silent or /silent				Do not output any information on the screen/console
  -r[egister] or /r[egister]		Register an assembly for COM interop, register a type library in the registry,
                                or register an unmanaged COM executable.
  -u[nregister] or /u[nregister]	Unregister an assembly for COM interop unregister a type library from the registry,
                                or unregister an unmanaged COM executable.
  -tlb or /tlb					Extract to file the Typelib information from a .NET Assembly or from an
                                unmanaged COM executable. If omited no type library will be extracted at all.
                                If present together with one of the /r or /u options, will force
                                the assembly's Typelib extraction & registration (with /r) or,
                                the assembly's Typelib unregistration and deletion (with /u). This option
                                is ignored with input files that are not .NET assemblies.
  -f[ile]=$path or /f[ile]=$path	The pathname to register or unregister. path can be enclosed in double quotation marks.
                                The pathname can be a .NET Assembly, a COM Typelib Container, an unmanaged
                                COM executable or a Listfile.
                                The Listfile is a normal text file whose first line contains the token <listfile> and
                                then each following line contains set of parameters describing the requested action.
                                These parameters must be among the ones listed here.
  -codebase or /codebase			Valid only for /r mode. Register a .NET Assembly with the CodeBase switch
  -gac or /gac					Register/Unregister a .NET Assembly in/from the Global Assembly Cache
  -nocon[sole], /nocon[sole]		If present on the command line this switch will hide the application's console
  -log[level]=N, /log[level]=N	Specifies the logging level. 0 - Off, 1 - Errors, 2 - Errors and Warnings,
                                3 - Errors, Warnings and Infos, 4 - Verbose. Default level is 0 (Off).
  -h[elp], /h[elp], -? or /?		Lists this information on the screen/console

IV. Known issues

None at the moment, but they will come for sure...


V. Providing feedback, receiving feedback for bugfixes and feature request and donating

1. Feedback addresses

Project page (SF):     http://sourceforge.net/projects/comreg
Project Web Page:      http//comreg.sourceforge.net (Under construction)
Admin1:                sbogus6 at users.sourceforge.net
Admin2:                info at manev.de

2. Donating

Although this product is open source and no payment is required to obtain, use, re-use, modify and distribute it,
significant amount of efforts have been put therein, so if you find COMREG useful please consider donating to the
project. The needed links and instructions you'll find under the link http://sourceforge.net/donate/index.php?group_id=227484


VI. That's all