--- a/Intro.dox
+++ b/Intro.dox
@@ -17,10 +17,13 @@
@section pxattr Pxattr
-The pxattr package aims at providing a single interface to extended
-attributes on all three systems. It consists in a single C++ module (one
-source and one include file), which is to be included in the application
-source code (being too trivial to justify a library).
+The pxattr package provides a portable programming interface for managing
+file extended attributes on all three systems. It consists in a single C++
+module (one source and one include file), which is to be included in the
+application source code (being too trivial to justify a library).
+
+Calls are provided to read, modify or delete extended attributes. Check the
+Namespaces above for more detail.
Linux note: on Linux, user attributes are distinguished by having a
"user." prefix in their name. On Mac OS X and FreeBSD, the user and
@@ -30,10 +33,10 @@
@par Command line program
-The C++ file can also be compiled to a command line program, which is both
-a test tool and a handy way to manage attributes from the command line.
+The C++ file can also be compiled into program which provides a handy way
+to manage attributes from the command line.
-Especially, the command line program can produce a dump of the extended
+Especially, the *pxattr* command can produce a dump of the extended
attributes for a directory tree. This dump can then be restored if the tree
has been copied elsewhere. This works across the three platforms and can
provide a workaround for the current lack of common extended attributes
@@ -53,12 +56,15 @@
paths (use sed or emacs), the dump format is line-oriented but as binary as
the extended attributes contents, with just a few escaped characters.
-@par license
-pxattr is free software, with an MIT-type license, use and redistribute
+@par License
+Pxattr is free software, with an MIT-type license, use and redistribute
freely.
@par Download pxattr
<a href="pxattr-2.1.0.tar.gz">pxattr-2.1.0.tar.gz</a>
+
+@par Source repository
+<a href="https://bitbucket.org/medoc/pxattr">On BitBucket</a>
@par Building the driver
You will need g++ and make (and nothing else as far as I know).