From c20f43983dfeb5c86dbd2ab0756404ff60fd3bc9 Mon Sep 17 00:00:00 2001 From: Anatoli Babenia Date: Wed, 25 Aug 2021 13:51:11 +0300 Subject: [PATCH] Add markdown README.md --- README.md | 41 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100755 README.md diff --git a/README.md b/README.md new file mode 100755 index 00000000..3038b61a --- /dev/null +++ b/README.md @@ -0,0 +1,41 @@ +The Newick Utilities are a suite of programs for working with Newick-formatted +phylogenetic trees. + +Documentation +============= + +See in [doc/](doc). + +Installing +========== + +Binaries +-------- + +If you have a binaries distribution (that is, with a name like +newick-utils-x.y.z-linux-x86-64.tar.gz), you do not have to compile. The +binaries are in ./src ; they all have names that start with nw_, so you can do + + $ sudo cp src/nw_* /usr/local/bin # or wherever you want + +You can test the programs by cd'ing to ./tests, and doing the following: + + $ ./test_binaries.sh + + +Source +------ + +If you have a source-only distribution, or if you want to build the binaries +yourself, it's the familiar + + $ autoreconf -fi + $ ./configure + $ make + $ make check # optional but recommended + $ sudo make install + +In addition to a C compiler (I use GCC), you need Flex and Bison (possibly +already on your system); optionally you can use LibXML, GNU Guile, and Lua. + +See [the manual](doc/nwutils_tutorial.pdf) for details.