From 27f63875b51a6f6af741ab35a7c219ccf5c82d97 Mon Sep 17 00:00:00 2001
From: Manuel Rego Casasnovas <rego@igalia.com>
Date: Thu, 15 Dec 2011 12:29:02 +0100
Subject: [PATCH] [doc] Add warning about printing issues in Debian Squeeze

Review format of info added in INSTALL file and add warning in specific sections

FEA: ItEr75S03CommunityMaterial
---
 INSTALL | 39 ++++++++++++++++++++++++++-------------
 1 file changed, 26 insertions(+), 13 deletions(-)

diff --git a/INSTALL b/INSTALL
index 0a2a41562..865ef74aa 100644
--- a/INSTALL
+++ b/INSTALL
@@ -45,6 +45,11 @@ Instructions:
 
     # apt-get install -f
 
+.. WARNING::
+
+  If you have problems with printing support review the last section `Fix
+  printing in Debian Squeeze`_.
+
 
 LibrePlan manual installation
 -----------------------------
@@ -128,6 +133,11 @@ Debian/Ubuntu
 
 * Go to http://localhost:8080/libreplan/
 
+.. WARNING::
+
+  If you have problems with printing support review the last section `Fix
+  printing in Debian Squeeze`_.
+
 
 openSUSE
 ~~~~~~~~
@@ -220,25 +230,28 @@ folder under ``/var/log/tomcat6/`` with ``.war`` name. For example:
 Inside this new directory there will be two files (``libreplan.log`` and
 ``libreplan-error.log``) that will be rotated every day.
 
-What to do if printing support is not working in Debian Squeeze
----------------------------------------------------------------
 
-Basically, you have to get a newer version of Cutycapt and Webkit dependencies
-from testing. This is how to do it:
+Fix printing in Debian Squeeze
+------------------------------
 
-1) Gain root privileges
-2) Make sure stable remains the default distribution to pull packages from:
+Since LibrePlan 1.2 printing support is not working properly in Debian Squeeze.
+To fix this issue, basically, you have to get a newer version of CutyCapt and
+WebKit dependencies from Debian testing.
 
-  echo 'APT::Default-Release "stable";' >> /etc/apt/apt.conf
+Instructions:
 
-3) Add a new repository to make testing packages available to apt-get:
+* Make sure stable remains the default distribution to pull packages from::
 
-  echo "deb http://ftp.debian.org/debian testing main" >> /etc/apt/sources.list
+  # echo 'APT::Default-Release "stable";' >> /etc/apt/apt.conf
 
-3) Refresh package index:
+* Add a new repository to make testing packages available to ``apt-get``::
 
-  apt-get update
+  # echo "deb http://ftp.debian.org/debian testing main" >> /etc/apt/sources.list
 
-4) Fetch and install cutycapt (and its dependencies) from testing:
+* Refresh package index::
 
-  apt-get -t testing install cutycapt
+  # apt-get update
+
+* Fetch and install ``cutycapt`` (and its dependencies) from testing::
+
+  # apt-get -t testing install cutycapt