CMakeLists.txt: update man install location.

[rrq/fuse_xattrs.git] / README.md

diff --git a/README.md b/README.md
index d57d794959e6515033a2367517ba13652db8182f..98866e3b3fd3769ca14ac662cf0d43ec5b028cb7 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,2 +1,50 @@
-# fuse_xattrs
-add xattrs support using sidecar files.
+[![Build Status](https://travis-ci.org/fbarriga/fuse_xattrs.svg?branch=master)](https://travis-ci.org/fbarriga/fuse_xattrs)
+
+## Abstract
+
+This filesystem provides xattr support using sidecar files.
+
+## Latest version
+
+The latest version and more information can be found on
+http://github.com/fbarriga/fuse_xattrs
+
+
+## How to mount a filesystem
+
+Once fuse_xattrs is installed (see next section) running it is very simple:
+
+    fuse_xattrs source_directory mountpoint
+
+To unmount the filesystem:
+
+    fusermount -u mountpoint
+
+
+## Building
+
+First you need to download FUSE 2.9 or later from
+http://github.com/libfuse/libfuse.
+
+    mkdir build && cd build
+    cmake ..
+    make
+
+## Code Coverage
+
+    mkdir build && cd build
+    cmake -DENABLE_CODECOVERAGE=1 -DCMAKE_C_COMPILER=/usr/bin/gcc -DCMAKE_BUILD_TYPE=Debug ..
+    make
+    make fuse_xattrs_coverage
+
+## Installing
+
+    make install
+
+## Links
+
+- http://man7.org/linux/man-pages/man2/setxattr.2.html
+- http://man7.org/linux/man-pages/man2/listxattr.2.html
+- http://man7.org/linux/man-pages/man2/getxattr.2.html
+- http://man7.org/linux/man-pages/man3/errno.3.html
+- https://www.freedesktop.org/wiki/CommonExtendedAttributes/