Updates & adds missing files

Update Readme.md and add missing files, also add build info.

CardFileKPPlugin.sln

@@ -0,0 +1,22 @@
+
+Microsoft Visual Studio Solution File, Format Version 12.00
+# Visual Studio 14
+VisualStudioVersion = 14.0.25420.1
+MinimumVisualStudioVersion = 10.0.40219.1
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "CardFileKPPlugin", "CardFileKPPlugin\CardFileKPPlugin.csproj", "{AC950680-C2CF-4522-A092-10099FAC486A}"
+EndProject
+Global
+	GlobalSection(SolutionConfigurationPlatforms) = preSolution
+		Debug|Any CPU = Debug|Any CPU
+		Release|Any CPU = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{AC950680-C2CF-4522-A092-10099FAC486A}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{AC950680-C2CF-4522-A092-10099FAC486A}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{AC950680-C2CF-4522-A092-10099FAC486A}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{AC950680-C2CF-4522-A092-10099FAC486A}.Release|Any CPU.Build.0 = Release|Any CPU
+	EndGlobalSection
+	GlobalSection(SolutionProperties) = preSolution
+		HideSolutionNode = FALSE
+	EndGlobalSection
+EndGlobal

Defs.cs

@@ -0,0 +1,28 @@
+// CardFileKPPlugin - Copyright © 2016 John Oliver
+// This program is free software: you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free Software
+// Foundation, either version 3 of the License, or (at your option) any later
+// version.
+// This program is distributed in the hope that it will be useful, but WITHOUT
+// ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+// FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
+// details.
+// You should have received a copy of the GNU General Public License
+// along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+
+namespace CardFileKPPlugin {
+
+	/// <summary>
+	/// Definitions for the plugin
+	/// </summary>
+	public static class Defs {
+
+		// Version file URL
+		internal const string  sUpdateUrl = "https://raw.githubusercontent.com/antboy/CardFileKPPlugin/6c9d70dbdb0923e389af6d8811e2d2fe980618a4/J11KPPluginVer.txt_signed";
+
+		// RSA 4096 bit Public Key in XML format
+		internal const string  RSAPublicKeyXml = "your public key goes in here";
+	}//c
+
+}//n

README.md

@@ -1,17 +1,45 @@
 # CardFileKPPlugin
-## Summary: A plugin for Keepass.  It enables importing a Microsoft Cardfile.
+##
+## Summary: A plugin for Keepass.  It imports a Microsoft Cardfile.
 
 The plugin adheres to the Keepass 2.x interface and was written in C# v6.
 
-The MS Cardfile ([Cardfile](http://wikivisually.com/wiki/Cardfile)) is an old app from Windows NT and previous times which is however still in use today in a few cases.  The app was bundled in with the OS, and provided a simple GUI and 'database' in the manner of a manual indexed card file.  For those few using it, one approach was to use it to store login details and keep the resulting file inside an encrypted wrapper of some sort.  The MS app did not provide a means of exporting the data captured within it.  This plugin provides a means of importing the Cardfile data into Keepass.
+The MS Cardfile ([Cardfile](http://wikivisually.com/wiki/Cardfile)) is an old app from Windows NT and previous times which is however still in use today in a few cases.  The app was bundled in with the OS, and provided a simple GUI and 'database' in the manner of a manual indexed card file.  One approach to using it as a password managers was to store login details and keep the cardfile inside an encrypted wrapper of some sort.  The MS app did not provide a means of exporting the data held within it.  This plugin provides a means of importing the Cardfile data into [Keepass](https://keepass.info/).
 
 At each import, the plugin creates a new Keepass group, whose name (ImpCardFile-<date/time>) includes the date and time, and puts all data read into the group, with each Card index text appearing as a an Entry Title, and the card contents appearing as an Entry Note.
 
-This plugin uses the CardFileRdr.dll assembly, which does the actual reading of the MS Cardfile.  A related app is CardFileExporter which enables the Cardfile to be exported to XML instead, and which also uses that .dll.
+This plugin uses the CardFileRdr.dll assembly from [CardFileRdr](http://github.com/antboy/CardFileRdr), which does the actual reading of the MS Cardfile.
 
 A limitation of the CardFileRdr.dll is that it ignores contained OLEs and graphic objects such as bitmaps, which are theoretically allowed, so reads only the text contents, but it will process Unicode correctly.
 
-The plugin uses Keepass's update check with an RSA public-key, providing notification of when new versions are available.  A SHA256 hash of the plugin is made available, and CardFileRdr.dll is signed with a self-signed X.509 certificate and has a similar hash provided too.
+The plugin adheres to Keepass's update checking facility that provides notification of new version availability.  A signed version file is held in the repository and the URL passed to Keepass by the plugin at run-time.  The signature consists of a SHA-512 hash of the file which is encrypted by a private key, converted to a Base64 string and then added to the version file.  The plugin .plgx file contains the public key with which to decrypt the hash for verification, but this key is not given in the source code as anyone building from it will wish to substitute their own.
 
 ## Installation
-The plugin is made available as a Keepass .plgx file (CardFileKPPlugin.plgx) and is installed by simply copying it to the Keepass plugins directory.
+The plugin is made available as a Keepass .plgx file (CardFileKPPlugin.plgx) and is installed by simply downloading it from the repository Release, then copying it to the Keepass plugins directory (e.g. C:\Program Files (x86)\KeePass Password Safe 2\Plugins).
+
+The SHA-256 hash of the plugin is:
+7dd11d56813e01d6002eea7c04870a9d06a7f41200d22ded40a91b3cba325d39
+
+
+
+##
+## How to Use
+From Keepass' File menu, select Import...
+
+![Image of selection of Import menu item](doc/imp-sc.png)
+
+which causes the display of the *Import File/Data* dialogue...
+
+![Image of Import dialogue](doc/impmgr.png)
+
+Scroll down the list of *Password Managers* until you see the entry for *Microsoft Cardfile*, and select it ...
+
+----------
+
+![Image of Import dialogue](doc/impcrd.png)
+
+and in the *Files to be imported* box, enter (e.g. using the browse button to the right of it) the path & name of the file containing the cardfile to be imported, and press the OK button.
+
+When the import is complete, you will see in your Keepass database a new group whose name ImpCardFile-<> includes the date and time of creation.  Clicking on the group will cause Keepass to display the list of new entries created inside it.  Don't forget to click Save!
+
+![Image of Import dialogue](doc/impgrp.png)

doc/Build.md

@@ -0,0 +1,5 @@
+## Building CardFileKPPlugin
+
+If you wish your plugin to use a signed version file so that Keepass knows when a new version is available, firstly, add your public RSA public key in XML form to the Defs.cs C# sharp.  Also sign the version file with your private key (see [Keepass plugin update checking](http://keepass.info/help/v2_dev/plg_index.html#upd)) and add the location of the signed version file to Defs.cs.
+
+Copy CardFileRdr.dll from [CardFileRdr](http://github.com/antboy/CardFileRdr) to the local build directory.  If using, for example, Visual Studio 2015, add the .dll as a reference to your project, otherwise link it in in the appropriate way for your build environment.  Follow the [Keepass plugin build directions](http://keepass.info/help/v2_dev/plg_index.html#plgx).