diff --git a/README b/README
deleted file mode 100644
index ea05f9f..0000000
--- a/README
+++ /dev/null
@@ -1,33 +0,0 @@
-The Manned.org Source Code
---------------------------
-
- This repository holds the source code of Manned.org. For a description of the
- site, check out http://manned.org/info/about.
-
- Ironically, documentation about how things work is completely lacking.
-
-
-
-Requirements
-
- General:
- perl: A somewhat recent version (no idea which, due to my XS usage)
- postgresql: Also a somewhat recent version
- rust + cargo (1.13+)
-
- www/ & lib/ & webs/: (Website)
- DBI
- DBD::Pg
- TUWF
- JSON::XS
- AnyEvent
-
- util/ & indexer/: (DB updating and package synchronisation stuff)
- curl
- psql
-
-
-Contact
-
- contact@manned.org
-
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..99d3164
--- /dev/null
+++ b/README.md
@@ -0,0 +1,34 @@
+# The Manned.org Source Code
+
+This repository holds the source code of Manned.org. For a description of the
+site, check out [https://manned.org/info/about](https://manned.org/info/about).
+
+Ironically, documentation about how things work is completely lacking.
+
+## Requirements
+
+- perl: A somewhat recent version (no idea which, due to my XS usage)
+- postgresql: Also a somewhat recent version
+- rust + cargo (1.13+)
+
+### Web front-end
+
+- DBI
+- DBD::Pg
+- TUWF
+- JSON::XS
+- AnyEvent
+
+### Man page indexer
+
+- curl
+- psql
+
+## File structure
+
+- **indexer/** -> The Rust program that scans package repositories for updates, fetches new packages and extracts the man pages.
+- **lib/ManUtils/** -> Perl/XS helper module to format man pages into HTML (uses **web/**).
+- **sql/** -> Database schema & updates.
+- **util/** -> Cron job and scripts to run **indexer/** on the right repositories.
+- **web/** -> Badly named Rust library to convert man pages into HTML.
+- **www/** -> The web front-end.
diff --git a/www/index.pl b/www/index.pl
index ce3bd5a..58a594e 100755
--- a/www/index.pl
+++ b/www/index.pl
@@ -181,10 +181,10 @@ sub about {
passed through groff to
render them in (mostly) the same way as they are displayed in your terminal.
- This website is open source
- (MIT licensed) and written in a combination of Perl and Rust. The entire
- PostgreSQL database is available for download (see "Database download"
- below).
+ This website is open
+ source (MIT licensed) and written in a combination of Perl and Rust. The
+ entire PostgreSQL database is available for download (see "Database
+ download" below).
_
end;
@@ -317,10 +317,10 @@ sub about {
wget's -c or curl's -C.
The database schema is "documented" at schema.sql in
- the git repo. Note that these dumps don't constitute a stable API and, while
- this won't happen frequently, incompatible schema changes or Postgres major
- version bumps may occur.
+ href="https://code.blicky.net/yorhel/manned/src/branch/master/sql/schema.sql">schema.sql
+ in the git repo. Note that these dumps don't constitute a stable API and,
+ while this won't happen frequently, incompatible schema changes or Postgres
+ major version bumps may occur.
_
end;
@@ -885,7 +885,7 @@ sub htmlFooter {
lit 'All manual pages are copyrighted by their respective authors.
| About manned.org
| Contact
- | Source';
+ | Source';
end;
script type => 'text/javascript', src => '/man.js', '';
end;