package readmes for bundle, config, and core

Author: ericsink

Directory.Build.props

@@ -4,9 +4,9 @@
     <Copyright>Copyright 2014-2025 SourceGear, LLC</Copyright>
     <Company>SourceGear</Company>
     <Authors>Eric Sink</Authors>
-    <Version>3.0.0-pre20250722133057</Version>
-    <AssemblyVersion>3.0.0.2759</AssemblyVersion>
-    <FileVersion>3.0.0.2759</FileVersion>
+    <Version>3.0.0-pre20250724144103</Version>
+    <AssemblyVersion>3.0.0.2761</AssemblyVersion>
+    <FileVersion>3.0.0.2761</FileVersion>
     <Description>SQLitePCLRaw is a Portable Class Library (PCL) for low-level (raw) access to SQLite</Description>
     <ProviderLangVersion>10.0</ProviderLangVersion>
     <GenerateAssemblyProductAttribute>false</GenerateAssemblyProductAttribute>

README.md

@@ -32,7 +32,7 @@ as part of this project.  It contains builds of the native SQLite code library
 for server platforms and with the most commonly used features enabled.
 I update this package from time to time.
 
-My company (SourceGear) operates a paid service at nuget.sourcegear.com
+SourceGear operates a paid service at nuget.sourcegear.com
 which provides various native SQLite builds which are
 updated immediately after each SQLite release.  These include regular
 SQLite builds, or various options with encryption support.  We can also provide

src/SQLitePCLRaw.bundle_e_sqlite3/SQLitePCLRaw.bundle_e_sqlite3.csproj

@@ -4,9 +4,14 @@
     <IncludeBuildOutput>false</IncludeBuildOutput>
     <TargetFrameworks>netstandard2.0</TargetFrameworks>
 	<PackageId>SQLitePCLRaw.bundle_e_sqlite3</PackageId>
-    <PackageDescription>This 'batteries-included' bundle brings in SQLitePCLRaw.core and the necessary stuff for certain common use cases.  Call SQLitePCL.Batteries.Init().  Policy of this bundle: e_sqlite3 included</PackageDescription>
+    <PackageDescription>This 'batteries-included' bundle brings in SQLitePCLRaw.core and the necessary stuff for certain common use cases.  Call SQLitePCL.Batteries.Init().</PackageDescription>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
+  <ItemGroup>
+    <None Include="..\common\README.md" Pack="True" PackagePath="README.md" />
+  </ItemGroup>
+
   <ItemGroup>
 	<ProjectReference Include="..\SQLitePCLRaw.config.e_sqlite3\SQLitePCLRaw.config.e_sqlite3.csproj" />
   </ItemGroup>

src/SQLitePCLRaw.config.e_sqlite3/SQLitePCLRaw.config.e_sqlite3.csproj

@@ -8,12 +8,17 @@
     <AssemblyOriginatorKeyFile>..\..\sn\SQLitePCLRaw.batteries_v2.snk</AssemblyOriginatorKeyFile>
     <EnableDefaultCompileItems>false</EnableDefaultCompileItems>
     <PackageDescription>This package sets the configuration for using e_sqlite3 but does not bring in that native library itself.  It's like bundle_e_sqlite3, except it's hollow.</PackageDescription>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
   <ItemGroup>
     <Compile Include="..\..\src\common\batteries_v2.cs" />
   </ItemGroup>
 
+  <ItemGroup>
+    <None Include="..\common\README.md" Pack="True" PackagePath="README.md" />
+  </ItemGroup>
+
   <Import Condition=" '$(TargetFramework)' == 'netstandard2.0' " Project="..\msbuild_bundle_fragments\e_sqlite3_dllimport.xml" />
   <Import Condition=" '$(TargetFramework)' == '$(tfm_net)' " Project="..\msbuild_bundle_fragments\e_sqlite3_dllimport.xml" />
   <Import Condition=" '$(TargetFramework)' == '$(tfm_ios)' " Project="..\msbuild_bundle_fragments\e_sqlite3_internal.xml" />

src/SQLitePCLRaw.core/SQLitePCLRaw.core.csproj

@@ -8,6 +8,7 @@
     <SignAssembly>true</SignAssembly>
     <AssemblyOriginatorKeyFile>..\..\sn\SQLitePCLRaw.core.snk</AssemblyOriginatorKeyFile>
     <PackageDescription>SQLitePCLRaw is a Portable Class Library (PCL) for low-level (raw) access to SQLite.  This package does not provide an API which is friendly to app developers.  Rather, it provides an API which handles platform and configuration issues, upon which a friendlier API can be built.  In order to use this package, you will need to also add one of the SQLitePCLRaw.provider.* packages and call raw.SetProvider().</PackageDescription>
+    <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
 
     <ItemGroup>
@@ -17,6 +18,10 @@
         </EmbeddedResource>
     </ItemGroup>
 
+  <ItemGroup>
+    <None Include="..\common\README.md" Pack="True" PackagePath="README.md" />
+  </ItemGroup>
+
   <ItemGroup>
     <Compile Include="raw.cs" />
     <Compile Include="handles.cs" />

src/common/README.md

@@ -0,0 +1,48 @@
+
+# SQLitePCLRaw
+
+SQLitePCLRaw is a .NET Portable Class Library (PCL) for low-level (raw)
+access to SQLite.
+
+This library is open source (Apache License v2) and has been downloaded
+hundreds of millions of times on nuget.org.
+
+My name is Eric Sink.  I am:
+
+- the maintainer of this library
+- the founder of SourceGear, a small software company in Illinois
+- part of the SQLite core team
+
+You can email me at either eric@sourcegear.com or eric@sqlite.org.
+Please contact me if you are interested in any of the following
+related services available from SourceGear:
+
+## Technical Support
+
+SourceGear offers technical support agreements at various price levels.
+
+## SQLite builds
+
+SourceGear operates a paid service at nuget.sourcegear.com
+which provides various native SQLite builds which are
+updated immediately after each SQLite release.  These include regular
+SQLite builds, or various options with encryption support.  We can also provide
+custom configurations.
+
+## Encryption support
+
+I no longer publish encryption-enabled SQLite builds without cost.
+
+My recommended solution for encryption support is the SQLite Encryption Extension (SEE), which is the official implementation from the SQLite team:
+
+https://sqlite.org/com/see.html
+
+The SEE is not open source -- a paid license is required.  SourceGear's SQLite build service
+provides SEE builds in the form of nuget packages.
+
+## Custom software development
+
+SourceGear offers custom software devlopment or maintenance services
+on a time-and-materials basis.
+
+