From 5b749e2d5c469f85ec7f77923829b5981c2a4ca6 Mon Sep 17 00:00:00 2001 From: Junegunn Choi Date: Tue, 31 Jan 2017 21:43:41 +0900 Subject: Update documentation --- BUILD.md | 56 +++----------------------------------------------------- 1 file changed, 3 insertions(+), 53 deletions(-) (limited to 'BUILD.md') diff --git a/BUILD.md b/BUILD.md index ca97e09c..5b04f674 100644 --- a/BUILD.md +++ b/BUILD.md @@ -25,65 +25,22 @@ make install # Build 32-bit and 64-bit executables and tarballs make release -# Build executables and tarballs for Linux using Docker -make linux +# Make release archives for all supported platforms +make release-all ``` ### Using `go get` Alternatively, you can build fzf directly with `go get` command without -cloning the repository. +manually cloning the repository. ```sh go get -u github.com/junegunn/fzf/src/fzf ``` -Build options -------------- - -### With ncurses 6 - -The official binaries of fzf are built with ncurses 5 because it's widely -supported by different platforms. However ncurses 5 is old and has a number of -limitations. - -1. Does not support more than 256 color pairs (See [357][357]) -2. Does not support italics -3. Does not support 24-bit color - -[357]: https://github.com/junegunn/fzf/issues/357 - -But you can manually build fzf with ncurses 6 to overcome some of these -limitations. ncurses 6 supports up to 32767 color pairs (1), and supports -italics (2). To build fzf with ncurses 6, you have to install it first. On -macOS, you can use Homebrew to install it. - -```sh -brew install homebrew/dupes/ncurses -LDFLAGS="-L/usr/local/opt/ncurses/lib" make install -``` - -### With tcell - -[tcell][tcell] is a portable alternative to ncurses and we currently use it to -build Windows binaries. tcell has many benefits but most importantly, it -supports 24-bit colors. To build fzf with tcell: - -```sh -TAGS=tcell make install -``` - -However, note that tcell has its own issues. - -- Poor rendering performance compared to ncurses -- Does not support bracketed-paste mode -- Does not support italics unlike ncurses 6 -- Some wide characters are not correctly displayed - Third-party libraries used -------------------------- -- [ncurses][ncurses] - [mattn/go-runewidth](https://github.com/mattn/go-runewidth) - Licensed under [MIT](http://mattn.mit-license.org) - [mattn/go-shellwords](https://github.com/mattn/go-shellwords) @@ -97,10 +54,3 @@ License ------- [MIT](LICENSE) - -[install]: https://github.com/junegunn/fzf#installation -[go]: https://golang.org/ -[gil]: http://en.wikipedia.org/wiki/Global_Interpreter_Lock -[ncurses]: https://www.gnu.org/software/ncurses/ -[req]: http://golang.org/doc/install -[tcell]: https://github.com/gdamore/tcell -- cgit v1.2.3