X-Git-Url: https://git.quassel-irc.org/?p=quassel.git;a=blobdiff_plain;f=INSTALL;h=5c822d6c9ef0d1e5ffbc62104bf49ab46a7334f0;hp=ad114913922dc1665fa98f9d01d68c6dc76710ac;hb=ba1cff451371eda2cb27a4cc7de2196e68fcc8f7;hpb=b9d814b020bbcf24100d79a7a6a2fcf37ebec2db

diff --git a/INSTALL b/INSTALL
index ad114913..5c822d6c 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,24 +1,37 @@
-These are preliminary instructions, until we get the config more polished.
+Quassel IRC - Installation Notes
+================================
 
-To build Quassel IRC, cd to build/ and run qmake && make. This builds all three
-versions of Quassel. You may choose individual targets by setting qmakes BUILD
-variable:
+These are preliminary instructions, until we get the config more
+polished.
+
+Quassel IRC provides three binaries: quasselcore, quasselclient, and
+quassel. While quasselcore and quasselclient obviously provide the
+separated core and client functionality, the latter one (quassel) is a
+monolithic version containing both of them for convenience.
+
+To build Quassel IRC, cd to build/ and run qmake && make. This
+builds all three versions of Quassel. You may choose individual
+targets by setting qmakes BUILD variable:
 
 qmake BUILD=<foo>
 
-where <foo> is any combination of qtclient, core, mono or all. Note that in order
-to change this later, you will have to make distclean, otherwise the BUILD setting
-seems to be ignored by qmake.
+where <foo> is any combination of qtclient, core, mono or all. Note
+that in order to change this later, you will have to make distclean,
+otherwise the BUILD setting seems to be ignored by qmake.
 
 After running make, you will find the binaries in build/targets.
 
-NOTE: As of now, quassel needs the directory $HOME/.quassel to exist prior to first
-      run, otherwise it cannot create its database! This will be changed soon, but
-      for now, you will just need to create this directory.
-
-The core-side database will be created automatically. A user named 'Default' with
-the password 'password' will be created, so in order to connect to the core, you
-need to enter this information. The core listens on port 4242 for incoming connections.
+make install will probably do something, but it has never been tried
+and may destroy your system or kill a kitten. It's not necessary
+anyway, since there are no installable files other than the
+binaries. Though this might change in later releases.
+
+On first run of the Quassel core, it will wait for a client to connect
+and present a (preliminary) first-run wizard. This will allow you to
+create the database and one admin user for the core-side storage. Note
+that Quassel does not support the administration of user accounts yet,
+this includes adding more users, changing passwords and so on. This is
+high on our TODO list, of course.
 
 Please also do read the README file.