forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From gmcdon...@apache.org
Subject svn commit: r582711 - in /forrest/trunk/site-author/content/xdocs: docs_0_80/your-project.xml docs_0_90/your-project.xml
Date Mon, 08 Oct 2007 05:32:37 GMT
Author: gmcdonald
Date: Sun Oct  7 22:32:32 2007
New Revision: 582711

URL: http://svn.apache.org/viewvc?rev=582711&view=rev
Log:
Add Debian specific instructions, due to Steven Coco, fixes FOR-1047

Modified:
    forrest/trunk/site-author/content/xdocs/docs_0_80/your-project.xml
    forrest/trunk/site-author/content/xdocs/docs_0_90/your-project.xml

Modified: forrest/trunk/site-author/content/xdocs/docs_0_80/your-project.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/docs_0_80/your-project.xml?rev=582711&r1=582710&r2=582711&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs_0_80/your-project.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_80/your-project.xml Sun Oct  7 22:32:32
2007
@@ -78,7 +78,21 @@
       PATH=$PATH:$FORREST_HOME/bin
       export PATH
           </source>
-          </section>
+  </section>
+  <section>
+          <title>The Debian update-alternatives system</title>
+          <p>If your system uses the alternatives system to manage application binaries
and their locations, you may use that to link Forrest into your system's binary directory,
instead of explicitly exporting environment variables. To check if your system has the alternatives
system installed, execute this command: </p>
+          <p><code>update-alternatives --version </code></p>
+          <p>Update-alternatives will print its version if it is installed. If so,
you may then add an entry for Forrest. Installing an update-alternatives entry may need to
be run with root privileges. On some systems, that can be achieved with the "sudo" command,
which executes single commands as the super user: for example, Ubuntu's GNU/Linux system uses
this feature. Or you may need to contact a system administrator to install. </p>
+          <p>To install a Forrest entry, first, gather the path to Forrest's executable,
and also note its version. In this example, Forrest has been unpacked and placed into '/opt/Apache/apache-forrest-0.8'
(the executable is at bin/forrest). Then execute this command (here we use sudo to execute
update-alternatives with root privileges): </p>
+          <p><code>sudo update-alternatives --install /usr/bin/forrest forrest
'/opt/Apache/apache-forrest-0.8/bin/forrest' 800 </code></p>
+          <p>The arguments to this command include '/usr/bin/forrest' as the system's
location for the binary link, 'forrest' as the update-alternatives short name for this entry,
'/opt/Apache/apache-forrest-0.8/bin/forrest' as the actual binary's location, and '800' as
the priority. </p>
+          <p>Alternatives entries have a priority because you may install other versions
of Forrest, and switch among them using update-alternatives: the highest priority entry will
be selected as the default until you explicitly select another one to become active. Here,
we have chosen a number based on Forrest's version: version 0.8 is installed, and priority
800 leaves room for adding several other versions; for instance, 0.90 may use priority 900,
and 1.0 may be 1000. </p>
+          <p>Forrest should now be available on your command line. Execute: <code>forrest
--help</code></p>
+          <p>Forrest should print its help text. For more help with the alternatives
system, use:</p>
+
+          <p><code>update-alternatives --help</code> or <code>man
update-alternatives</code></p>
+  </section>
         </section>
         <section>
           <title>Windows 2000</title>

Modified: forrest/trunk/site-author/content/xdocs/docs_0_90/your-project.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/docs_0_90/your-project.xml?rev=582711&r1=582710&r2=582711&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs_0_90/your-project.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_90/your-project.xml Sun Oct  7 22:32:32
2007
@@ -78,7 +78,21 @@
       PATH=$PATH:$FORREST_HOME/bin
       export PATH
           </source>
-          </section>
+  </section>
+  <section>
+          <title>The Debian update-alternatives system</title>
+          <p>If your system uses the alternatives system to manage application binaries
and their locations, you may use that to link Forrest into your system's binary directory,
instead of explicitly exporting environment variables. To check if your system has the alternatives
system installed, execute this command: </p>
+          <p><code>update-alternatives --version </code></p>
+          <p>Update-alternatives will print its version if it is installed. If so,
you may then add an entry for Forrest. Installing an update-alternatives entry may need to
be run with root privileges. On some systems, that can be achieved with the "sudo" command,
which executes single commands as the super user: for example, Ubuntu's GNU/Linux system uses
this feature. Or you may need to contact a system administrator to install. </p>
+          <p>To install a Forrest entry, first, gather the path to Forrest's executable,
and also note its version. In this example, Forrest has been unpacked and placed into '/opt/Apache/apache-forrest-0.8'
(the executable is at bin/forrest). Then execute this command (here we use sudo to execute
update-alternatives with root privileges): </p>
+          <p><code>sudo update-alternatives --install /usr/bin/forrest forrest
'/opt/Apache/apache-forrest-0.8/bin/forrest' 800 </code></p>
+          <p>The arguments to this command include '/usr/bin/forrest' as the system's
location for the binary link, 'forrest' as the update-alternatives short name for this entry,
'/opt/Apache/apache-forrest-0.8/bin/forrest' as the actual binary's location, and '800' as
the priority. </p>
+          <p>Alternatives entries have a priority because you may install other versions
of Forrest, and switch among them using update-alternatives: the highest priority entry will
be selected as the default until you explicitly select another one to become active. Here,
we have chosen a number based on Forrest's version: version 0.8 is installed, and priority
800 leaves room for adding several other versions; for instance, 0.90 may use priority 900,
and 1.0 may be 1000. </p>
+          <p>Forrest should now be available on your command line. Execute: <code>forrest
--help</code></p>
+          <p>Forrest should print its help text. For more help with the alternatives
system, use:</p>
+
+          <p><code>update-alternatives --help</code> or <code>man
update-alternatives</code></p>
+  </section>
         </section>
         <section>
           <title>Windows 2000</title>



Mime
View raw message