lucenenet-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From nightowl...@apache.org
Subject [10/10] lucenenet git commit: Updated README.md
Date Tue, 16 May 2017 14:28:30 GMT
Updated README.md


Project: http://git-wip-us.apache.org/repos/asf/lucenenet/repo
Commit: http://git-wip-us.apache.org/repos/asf/lucenenet/commit/aa609e3b
Tree: http://git-wip-us.apache.org/repos/asf/lucenenet/tree/aa609e3b
Diff: http://git-wip-us.apache.org/repos/asf/lucenenet/diff/aa609e3b

Branch: refs/heads/master
Commit: aa609e3b2b4aed057ee915a31d637825d320638e
Parents: fbd4ad5
Author: Shad Storhaug <shad@shadstorhaug.com>
Authored: Tue May 16 21:07:11 2017 +0700
Committer: Shad Storhaug <shad@shadstorhaug.com>
Committed: Tue May 16 21:19:12 2017 +0700

----------------------------------------------------------------------
 README.md | 91 +++++++++++++++++++++++++++++++++++++++++++++++++++++-----
 1 file changed, 84 insertions(+), 7 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/lucenenet/blob/aa609e3b/README.md
----------------------------------------------------------------------
diff --git a/README.md b/README.md
index 6fc49e9..34ab64f 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
 # Apache Lucene.Net
 
-Apache Lucene.Net is a C# full-text search engine, a C# port of the popular Apache Lucene
project.  Apache Lucene.Net is not a complete application, but rather a code library and API
that can easily be used to add search capabilities to applications.
+Apache Lucene.Net is a .NET full-text search engine, a C# port of the popular Apache Lucene
project.  Apache Lucene.Net is not a complete application, but rather a code library and API
that can easily be used to add search capabilities to applications.
 
 The Apache Lucene.Net web site is at:
   http://lucenenet.apache.org
@@ -31,13 +31,13 @@ Working toward Lucene.Net 4.8.0 (currently in BETA)
 PM> Install-Package Lucene.Net
 ```
 
-Lucene.Net is now divided into several sub-packages. See the [complete list of Lucene.Net
sub-packages on NuGet.org](https://www.nuget.org/packages?q=lucene.net)
+As of 4.8.0, Lucene.Net is now divided into several NuGet sub-packages. See the [complete
list of Lucene.Net sub-packages on NuGet.org](https://www.nuget.org/packages?q=lucene.net)
 
 ## Documentation
 
 [Lucene.Net WIKI](https://cwiki.apache.org/confluence/display/LUCENENET/Lucene.Net)
 
-We don't yet have API documentation for Lucene.Net 4.8.0 (contributions welcome), but the
API is similar to [Lucene 4.8.0](https://lucene.apache.org/core/4_8_0/).
+We don't yet have API documentation for Lucene.Net 4.8.0, but the API is similar to [Lucene
4.8.0](https://lucene.apache.org/core/4_8_0/).
 
 ### Legacy Versions
 
@@ -78,15 +78,63 @@ Before you start working on a pull request, please read our [Contributing](https
 
 If you plan to submit multiple pull requests, please submit an [Individual Contributor License](https://cwiki.apache.org/confluence/display/LUCENENET/Individual+Contributor+License),
or for individual pull requests, just submit the request and in the description state that
the code is your original work and you license it under the [Apache License v2](http://www.apache.org/licenses/LICENSE-2.0).
 
-## Build
+## Building and Testing
 
-To build the source, clone or download the repository. From the repository root, execute:
+### Command Line
+
+Building on the Command Line is only supported on Windows.
+
+##### Prerequisites
+
+1. [Powershell](https://msdn.microsoft.com/en-us/powershell/scripting/setup/installing-windows-powershell)
3.0 or higher (see [this question](http://stackoverflow.com/questions/1825585/determine-installed-powershell-version)
to check your Powershell version)
+2. [.NET Framework 4.5.1 Developer Pack](https://www.microsoft.com/en-us/download/details.aspx?id=40772)
(Under Programs & Features, check whether you have the .NET Framework 4.5.1 SDK)
+
+##### Execution
+
+To build the source, clone or download and unzip the repository. From the repository root,
execute:
 
 ```
-> build -pv:4.8.0.1000
+> build [options]
 ```
 
-This will build, version, and create NuGet `.nupkg` packages in the directory `/src/release/NuGetPackages/`.
You can setup Visual Studio to read these packages like any NuGet feed by following these
steps:
+##### Build Options
+
+<table>
+	<tr>
+		<th>Short</th>
+		<th>Long</th>
+		<th>Description</th>
+		<th>Example</th>
+	</tr>
+	<tr>
+		<td>&#8209;config</td>
+		<td>&#8209;&#8209;Configuration</td>
+		<td>The build configuration ("Release" or "Debug").</td>
+		<td>build&nbsp;&#8209;&#8209;Configuration:Debug</td>
+	</tr>
+	<tr>
+		<td>&#8209;pv</td>
+		<td>&#8209;&#8209;PackageVersion</td>
+		<td>The NuGet package version. If not supplied, will use the version from the Version.proj
file.</td>
+		<td>build&nbsp;&#8209;pv:4.8.0&#8209;beta00001</td>
+	</tr>
+	<tr>
+		<td>&#8209;t</td>
+		<td>&#8209;&#8209;Test</td>
+		<td>Runs the tests after building. Note that testing typically takes upwards of 2
hours.</td>
+		<td>build&nbsp;&#8209;t</td>
+	</tr>
+	<tr>
+		<td>&#8209;v</td>
+		<td>&#8209;&#8209;Version</td>
+		<td>The assembly file version. If not supplied, will use the PackageVersion (excluding
any pre-release tag).</td>
+		<td>build&nbsp;&#8209;pv:4.8.0&#8209;beta00001&nbsp;&#8209;v:4.8.0</td>
+	</tr>
+</table>
+
+NuGet packages are output by the build to the `/release/NuGetPackages/` directory. Test results
(if applicable) are output to the `/release/TestResults/` directory.
+
+You can setup Visual Studio to read the NuGet packages like any NuGet feed by following these
steps:
 
 1. In Visual Studio, right-click the solution in Solution Explorer, and choose "Manage NuGet
Packages for Solution"
 2. Click the gear icon next to the Package sources dropdown.
@@ -96,3 +144,32 @@ This will build, version, and create NuGet `.nupkg` packages in the directory
`/
 6. Click Ok
 
 Then all you need to do is choose the `Lucene.Net Local Packages` feed from the dropdown
(in the NuGet Package Manager) and you can search for, install, and update the NuGet packages
just as you can with any Internet-based feed.
+
+### Visual Studio
+
+#### .NET Framework
+
+##### Prerequisites
+
+1. Visual Studio 2012+
+2. [.NET Framework 4.5.1 Developer Pack](https://www.microsoft.com/en-us/download/details.aspx?id=40772)
(Under Programs & Features, check whether you have the .NET Framework 4.5.1 SDK)
+3. [NUnit3 Test Adapter](https://marketplace.visualstudio.com/items?itemName=NUnitDevelopers.NUnit3TestAdapter)
+
+##### Execution
+
+Open `Lucene.Net.sln` to compile/test in .NET Framework 4.5.1
+
+
+#### .NET Core
+
+##### Prerequisites
+
+1. [Visual Studio 2015 Update 3](http://stackoverflow.com/a/40068343) (NOTE: Other Visual
Studio versions, including 2017 are not supported)
+2. [1.1 with SDK Preview 2.1 build 3177](https://github.com/dotnet/core/blob/master/release-notes/download-archive.md)
+3. [NUnit3 Test Adapter](https://marketplace.visualstudio.com/items?itemName=NUnitDevelopers.NUnit3TestAdapter)
+
+##### Execution
+
+Open `Lucene.Net.Portable.sln` to compile under .NET Standard and test under .NET Core
+
+> NOTE: You may need to run `dotnet restore` from the command line prior to opening the
solution in order to successfully compile.


Mime
View raw message