summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2014-07-17 14:36:36 +0200
committerLudovic Courtès <ludo@gnu.org>2014-07-17 14:36:36 +0200
commit8aaaae38a37f806a62284c6bce116586d8b66b87 (patch)
treeede53f2d7b07598ced85a86b97e2d2fd476a9202
parent6a1912743a48dbc11b702508e13107592b9b9816 (diff)
doc: List noteworthy limitations.
* doc/guix.texi (Limitations): New subsection.
-rw-r--r--doc/guix.texi46
1 files changed, 41 insertions, 5 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index cbef829f7b..8da9ad639c 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -2631,11 +2631,47 @@ link that follows: @ref{Help,,, info, Info: An Introduction}. Hit
@kbd{l} afterwards to come back here.
@end ifinfo
-@emph{This section documents work-in-progress. The system lacks
-features and may be buggy. You've been warned. But more than a
-disclaimer, this is an invitation to report issues (and success
-stories!), and join us in improving it. @xref{Contributing}, for more
-info.}
+@subsection Limitations
+
+As of version @value{VERSION}, GNU@tie{}Guix and the GNU system
+distribution are alpha software. It may contain bugs and lack important
+features. Thus, if you are looking for a stable production system that
+respects your freedom as a computer user, a good solution at this point
+is to consider @url{http://www.gnu.org/distros/free-distros.html, one of
+more established GNU/Linux distributions}. We hope you can soon switch
+to the GNU system without fear, of course. In the meantime, you can
+also keep using your distribution and try out the package manager on top
+of it (@pxref{Installation}).
+
+Before you proceed with the installation, be aware of the following
+noteworthy limitations applicable to version @value{VERSION}:
+
+@itemize
+@item
+The installation process does not include a graphical user interface and
+requires familiarity with GNU/Linux (see the following subsections to
+get a feel of what that means.)
+
+@item
+The system does not yet provide graphical desktop environments such as
+GNOME and KDE.
+
+@item
+Support for encrypted disks, the Logical Volume Manager (LVM), and swap
+devices are missing.
+
+@item
+Few system services are currently supported out-of-the-box
+(@pxref{Services}).
+
+@item
+On the order of 1,000 packages are available, which means that you may
+occasionally find that a useful package is missing.
+@end itemize
+
+You've been warned. But more than a disclaimer, this is an invitation
+to report issues (and success stories!), and join us in improving it.
+@xref{Contributing}, for more info.
@subsection USB Stick Installation