From ae521afeea34aba7685b442a34188dd04e1ecf5e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ren=C3=A9=20=27Necoro=27=20Neumann?= <necoro@necoro.net>
Date: Sun, 11 Apr 2010 13:03:11 +0200
Subject: Enhance translating and development guide

---
 templates/pages/development.mako | 43 ++++++++++++++++++++++++++++++++++++++++
 templates/pages/translating.mako |  8 ++++----
 2 files changed, 47 insertions(+), 4 deletions(-)

diff --git a/templates/pages/development.mako b/templates/pages/development.mako
index e1fae3f..d069848 100644
--- a/templates/pages/development.mako
+++ b/templates/pages/development.mako
@@ -37,6 +37,49 @@ git checkout -t origin/0.13
     For further information have a look at the <a href="http://www.git-scm.com/documentation">Git documentation</a> or search the webs. There are plenty of sources and guides out there.
 </p>
 
+<%self:h2>Making portato run locally</%self:h2>
+
+<h4>The current dependencies</h4>
+<p>All of the following <em>needs</em> to be installed:</p>
+<ul>
+    <li><strong>dev-lang/python</strong> Versions 2.6 or 2.7 and having "sqlite" and "threads" enabled</li>
+    <li><strong>>=dev-python/cython-0.11.2</strong></li>
+    <li><strong>>=dev-python/pygtk-2.14.0</strong></li>
+    <li><strong>dev-python/pygtksourceview-2.*</strong></li>
+    <li><strong>x11-libs/vte</strong> "python" needs to be enabled</li>
+    <li><strong>dev-python/notify-python</strong></li>
+    <li><strong>>=sys-apps/portage-2.1.7.17</strong></li>
+    <li><strong>app-portage/portage-utils</strong></li>
+    <li><strong>>=app-portage/eix-0.15.4</strong></li>
+    <li><strong>virtual/libintl</strong></li>
+    <li><strong>sys-devel/gettext</strong></li>
+</ul>
+
+<h4>Preparing the sources</h4>
+<p>
+    As portato makes use of extension modules and of native language support, you need to run the following commands to get you started:
+</p>
+<%self:hl lang="bash">
+# compile extensions
+./extensions.sh
+
+# compile language support (optional!)
+./pocompile.sh
+</%self:hl>
+
+<h4>Running it</h4>
+<p>
+    If you made sure, that you have done everything noted above, you can use one of the following commands:
+</p>
+<%self:hl lang="bash">
+# normal startup - will prompt for the root password
+./portato.py
+
+# run as current user. saves you entering the root password
+# won't allow you to do emerges
+./portato.py -F
+</%self:hl>
+
 <%self:h2>Filing a bug</%self:h2>
 <p>
     You can do this in the <a href=${"/r/bugs" | url}>bugtracker</a>.
diff --git a/templates/pages/translating.mako b/templates/pages/translating.mako
index 8abe9a5..6e98ae4 100644
--- a/templates/pages/translating.mako
+++ b/templates/pages/translating.mako
@@ -26,7 +26,7 @@
 
 <%self:h2>Getting the sources</%self:h2>
 <p>
-    You do need the sources to make translations, as the installed program is not sufficient. Please see <a href=${"/development" | url}>the development page</a> for how to get them.
+    You do need the sources to make translations, as the installed program is not sufficient. Please see <a href=${"/development" | url}>the development page</a> for how to get them and what is needed to run portato locally.
 </p>
 
 <%self:h2>Updating an incomplete translation</%self:h2>
@@ -65,14 +65,14 @@
 ./pocompile.sh
 </%self:hl>
 
-<p>Now you can run the local portato version in your language:</p>
+<p>Now you can run the local portato version in your language (the <code>-F</code> makes portato run as the current user and thus saves you having to enter your root-password over and over again):</p>
 <%self:hl lang="bash">
-./portato.py
+./portato.py -F
 </%self:hl>
 
 <p>If you are not seeing your language, make sure the environment variable "LANG" is set to your language code. For example, to run portato using the German translation:</p>
 <%self:hl lang="bash">
-LANG="de_DE" ./portato.py
+LANG="de_DE" ./portato.py -F
 </%self:hl>
 
 <%self:h2>Submit your translation</%self:h2>
-- 
cgit v1.2.3