Skip to content

Commit

Permalink
VSEARCH 2.27.1
Browse files Browse the repository at this point in the history
  • Loading branch information
torognes committed Apr 6, 2024
1 parent 0833c91 commit 8586fae
Show file tree
Hide file tree
Showing 3 changed files with 29 additions and 21 deletions.
38 changes: 19 additions & 19 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ Most of the nucleotide based commands and options in USEARCH version 7 are suppo

## Getting Help

If you can't find an answer in the [VSEARCH documentation](https://github.com/torognes/vsearch/releases/download/v2.27.0/vsearch_manual.pdf), please visit the [VSEARCH Web Forum](https://groups.google.com/forum/#!forum/vsearch-forum) to post a question or start a discussion.
If you can't find an answer in the [VSEARCH documentation](https://github.com/torognes/vsearch/releases/download/v2.27.1/vsearch_manual.pdf), please visit the [VSEARCH Web Forum](https://groups.google.com/forum/#!forum/vsearch-forum) to post a question or start a discussion.

## Example

Expand All @@ -50,9 +50,9 @@ In the example below, VSEARCH will identify sequences in the file database.fsa t
**Source distribution** To download the source distribution from a [release](https://github.com/torognes/vsearch/releases) and build the executable and the documentation, use the following commands:

```
wget https://github.com/torognes/vsearch/archive/v2.27.0.tar.gz
tar xzf v2.27.0.tar.gz
cd vsearch-2.27.0
wget https://github.com/torognes/vsearch/archive/v2.27.1.tar.gz
tar xzf v2.27.1.tar.gz
cd vsearch-2.27.1
./autogen.sh
./configure CFLAGS="-O3" CXXFLAGS="-O3"
make
Expand Down Expand Up @@ -81,48 +81,48 @@ Binary distributions are provided for x86-64 systems running GNU/Linux, macOS (v
Download the appropriate executable for your system using the following commands if you are using a Linux x86_64 system:

```sh
wget https://github.com/torognes/vsearch/releases/download/v2.27.0/vsearch-2.27.0-linux-x86_64.tar.gz
tar xzf vsearch-2.27.0-linux-x86_64.tar.gz
wget https://github.com/torognes/vsearch/releases/download/v2.27.1/vsearch-2.27.1-linux-x86_64.tar.gz
tar xzf vsearch-2.27.1-linux-x86_64.tar.gz
```

Or these commands if you are using a Linux ppc64le system:

```sh
wget https://github.com/torognes/vsearch/releases/download/v2.27.0/vsearch-2.27.0-linux-ppc64le.tar.gz
tar xzf vsearch-2.27.0-linux-ppc64le.tar.gz
wget https://github.com/torognes/vsearch/releases/download/v2.27.1/vsearch-2.27.1-linux-ppc64le.tar.gz
tar xzf vsearch-2.27.1-linux-ppc64le.tar.gz
```

Or these commands if you are using a Linux aarch64 (arm64) system:

```sh
wget https://github.com/torognes/vsearch/releases/download/v2.27.0/vsearch-2.27.0-linux-aarch64.tar.gz
tar xzf vsearch-2.27.0-linux-aarch64.tar.gz
wget https://github.com/torognes/vsearch/releases/download/v2.27.1/vsearch-2.27.1-linux-aarch64.tar.gz
tar xzf vsearch-2.27.1-linux-aarch64.tar.gz
```

Or these commands if you are using a Mac with an Apple Silicon CPU:

```sh
wget https://github.com/torognes/vsearch/releases/download/v2.27.0/vsearch-2.27.0-macos-aarch64.tar.gz
tar xzf vsearch-2.27.0-macos-aarch64.tar.gz
wget https://github.com/torognes/vsearch/releases/download/v2.27.1/vsearch-2.27.1-macos-aarch64.tar.gz
tar xzf vsearch-2.27.1-macos-aarch64.tar.gz
```

Or these commands if you are using a Mac with an Intel CPU:

```sh
wget https://github.com/torognes/vsearch/releases/download/v2.27.0/vsearch-2.27.0-macos-x86_64.tar.gz
tar xzf vsearch-2.27.0-macos-x86_64.tar.gz
wget https://github.com/torognes/vsearch/releases/download/v2.27.1/vsearch-2.27.1-macos-x86_64.tar.gz
tar xzf vsearch-2.27.1-macos-x86_64.tar.gz
```

Or if you are using Windows, download and extract (unzip) the contents of this file:

```
https://github.com/torognes/vsearch/releases/download/v2.27.0/vsearch-2.27.0-win-x86_64.zip
https://github.com/torognes/vsearch/releases/download/v2.27.1/vsearch-2.27.1-win-x86_64.zip
```

Linux and Mac: You will now have the binary distribution in a folder called `vsearch-2.27.0-linux-x86_64` or `vsearch-2.27.0-macos-x86_64` in which you will find three subfolders `bin`, `man` and `doc`. We recommend making a copy or a symbolic link to the vsearch binary `bin/vsearch` in a folder included in your `$PATH`, and a copy or a symbolic link to the vsearch man page `man/vsearch.1` in a folder included in your `$MANPATH`. The PDF version of the manual is available in `doc/vsearch_manual.pdf`. Versions with statically compiled libraries are available for Linux systems. These have "-static" in their name, and could be used on systems that do not have all the necessary libraries installed.
Linux and Mac: You will now have the binary distribution in a folder called `vsearch-2.27.1-linux-x86_64` or `vsearch-2.27.1-macos-x86_64` in which you will find three subfolders `bin`, `man` and `doc`. We recommend making a copy or a symbolic link to the vsearch binary `bin/vsearch` in a folder included in your `$PATH`, and a copy or a symbolic link to the vsearch man page `man/vsearch.1` in a folder included in your `$MANPATH`. The PDF version of the manual is available in `doc/vsearch_manual.pdf`. Versions with statically compiled libraries are available for Linux systems. These have "-static" in their name, and could be used on systems that do not have all the necessary libraries installed.

**Windows**: You will now have the binary distribution in a folder
called `vsearch-2.27.0-win-x86_64`. The vsearch executable is called
called `vsearch-2.27.1-win-x86_64`. The vsearch executable is called
`vsearch.exe`. The manual in PDF format is called
`vsearch_manual.pdf`. If you want to be able to call `vsearch.exe`
from any command prompt window, you can put the vsearch executable in
Expand All @@ -135,7 +135,7 @@ and `zlib1.dll` files required for reading compressed input
files. These DLL's have been obtained for mingw-w64 from the MSYS2
platform.

**Documentation** The VSEARCH user's manual is available in the `man` folder in the form of a [man page](https://github.com/torognes/vsearch/blob/master/man/vsearch.1). A pdf version ([vsearch_manual.pdf](https://github.com/torognes/vsearch/releases/download/v2.27.0/vsearch_manual.pdf)) will be generated by `make`. To install the manpage manually, copy the `vsearch.1` file or a create a symbolic link to `vsearch.1` in a folder included in your `$MANPATH`. The manual in both formats is also available with the binary distribution. The manual in PDF form ([vsearch_manual.pdf](https://github.com/torognes/vsearch/releases/download/v2.27.0/vsearch_manual.pdf)) is also attached to the latest [release](https://github.com/torognes/vsearch/releases).
**Documentation** The VSEARCH user's manual is available in the `man` folder in the form of a [man page](https://github.com/torognes/vsearch/blob/master/man/vsearch.1). A pdf version ([vsearch_manual.pdf](https://github.com/torognes/vsearch/releases/download/v2.27.1/vsearch_manual.pdf)) will be generated by `make`. To install the manpage manually, copy the `vsearch.1` file or a create a symbolic link to `vsearch.1` in a folder included in your `$MANPATH`. The manual in both formats is also available with the binary distribution. The manual in PDF form ([vsearch_manual.pdf](https://github.com/torognes/vsearch/releases/download/v2.27.1/vsearch_manual.pdf)) is also attached to the latest [release](https://github.com/torognes/vsearch/releases).


## Packages, plugins, and wrappers
Expand Down Expand Up @@ -179,7 +179,7 @@ When compiling VSEARCH the header files for the following two optional libraries

VSEARCH will automatically check whether these libraries are available and load them dynamically.

On Windows these libraries are called zlib1.dll and libbz2.dll. These DLL's are included with the released distribution of vsearch 2.27.0 and later.
On Windows these libraries are called zlib1.dll and libbz2.dll. These DLL's are included with the released distribution of vsearch 2.27.1 and later.

To create the PDF file with the manual the ps2pdf tool is required. It is part of the ghostscript package.

Expand Down
2 changes: 1 addition & 1 deletion configure.ac
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
# Process this file with autoconf to produce a configure script.

AC_PREREQ([2.63])
AC_INIT([vsearch], [2.27.0], [[email protected]], [vsearch], [https://github.com/torognes/vsearch])
AC_INIT([vsearch], [2.27.1], [[email protected]], [vsearch], [https://github.com/torognes/vsearch])
AC_CANONICAL_TARGET
AM_INIT_AUTOMAKE([subdir-objects])
AC_LANG([C++])
Expand Down
10 changes: 9 additions & 1 deletion man/vsearch.1
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
.\" import www macros (URL, TAG, MTO)
.mso www.tmac
.\" ============================================================================
.TH vsearch 1 "January 19, 2024" "version 2.27.0" "USER COMMANDS"
.TH vsearch 1 "April 6, 2024" "version 2.27.1" "USER COMMANDS"
.\" ============================================================================
.SH NAME
vsearch \(em a versatile open-source tool for microbiome analysis,
Expand Down Expand Up @@ -4872,6 +4872,14 @@ refactored. Generic Dockerfiles for major Linux distributions have
been included. Some warnings from compilers and other tools have been
eliminated. The release for Windows will also include DLL's for the
two compression libraries.
.TP
.BR v2.27.1\~ "released April 6th, 2024"
This version fixes the weak_id option and makes searches report weak
hits in some cases. It also updates the names of the compression
libraries to libz.so.1 and libbz2.so.1 on Linux to make them work on
common Linux distributions without installing additional packages.
README.md has been updated with information about compression
libraries on Windows.
.LP
.\" ============================================================================
.\" TODO:
Expand Down

0 comments on commit 8586fae

Please sign in to comment.