diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000000000000000000000000000000000000..90ec22bee124705a9164f46a994cad1890bd92b5
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1 @@
+.svn
diff --git a/docs/sql.txt b/docs/sql.txt
old mode 100644
new mode 100755
index 5aab9e91d888f2310247fb9aefc0fcf3b173f34e..1ea80f6f378e836a37e4f05bbc4f2b4b6ed83134
--- a/docs/sql.txt
+++ b/docs/sql.txt
@@ -1,7 +1,11 @@
 `sqlauthBcrypt:SQL`
 =============
 
-This is an authentication module for authenticating a user against a SQL database. It uses bcrypt for validation of passwords against hashed passwords stored in the database. The implementation is based heavily on sqlauth:SQL.
+This is an authentication module for [SimpleSAMLphp](http://simplesamlphp.org) to authenticate a user against a SQL database table.
+
+It assumes password hashes and salts are calculated using [bcrypt](http://bcrypt.sourceforge.net/).
+
+The implementation is based heavily on the SimpleSAMLphp module `sqlauth:SQL`.
 
 
 Options
@@ -21,7 +25,7 @@ Options
 :   The SQL query which should be used to retrieve the user. The parameters :username and :password are available. If the username/password is incorrect, the query should return no rows. The name of the columns in resultset will be used as attribute names. If the query returns multiple rows, they will be merged into the attributes. Duplicate values and NULL values will be removed.
 
 `pepper`
-:   The pepper string appended to the password before generating the hash. If you are not using a pepper, set this to the empty string ('').
+:   The pepper string appended to passwords before generating the hash. If you are not using a pepper, set this to the empty string ('').
 
 `hash_column`
 :   The column storing password hashes.
diff --git a/readme.md b/readme.md
index b92964c0d80dc1e63ea6353a465091bb8b097a84..a4144e605d061e46b3d52a3b13c7f370b8c7adc6 120000
--- a/readme.md
+++ b/readme.md
@@ -1 +1 @@
-docs/sql.txt
\ No newline at end of file
+./docs/sql.txt
\ No newline at end of file