[Jifty-commit] r4626 - in Jifty-Book: .

[jifty-commit at lists.jifty.org]

Author: sterling
Date: Wed Dec  5 22:16:31 2007
New Revision: 4626

Modified:
   Jifty-Book/   (props changed)
   Jifty-Book/doc/Jifty/Book/Part-A/02-Installing_Jifty.pod

Log:
 r14403 at dynpc145:  andrew | 2007-12-05 21:16:00 -0600
 Cleaning up the section on the prebuilt packages contributed by Kenichi Ishigaki. (Thanks!)


Modified: Jifty-Book/doc/Jifty/Book/Part-A/02-Installing_Jifty.pod
==============================================================================
--- Jifty-Book/doc/Jifty/Book/Part-A/02-Installing_Jifty.pod	(original)
+++ Jifty-Book/doc/Jifty/Book/Part-A/02-Installing_Jifty.pod	Wed Dec  5 22:16:31 2007
@@ -30,50 +30,55 @@
 
 =head2 Prebuilt Package
 
-As of writing this, several prebuilt packages (or pre-configured ones, depending on the platforms) are known to be available, including Debian/Ubuntu, BSD ports, RPM, and Windows (ActivePerl PPM). Consult your package manager if there is one for your platform.
+As of writing this, several prebuilt packages (or pre-configured ones, depending on the platforms) are known to be available, including Debian and Ubuntu Linux, BSD ports, RPM, and Windows (via ActivePerl PPM). If you use another platform, you may try consulting your package manager if there is one for your platform.
 
-Debian package is directly maintained by the Jifty team and available from Jifty's official server.
+=head3 Debian Package
 
-=over 4
+The Debian package is directly maintained by the Jifty team and available from Jifty's official server. This package should work for Debian GNU/Linux as well as with Ubuntu. It will probably also work with other Debian-based Linux distributions as well.
 
-=item Add to your /etc/apt/sources.list
+To install Jifty using the Debian package, you will first add this line to your F</etc/apt/sources.list>:
 
   deb http://debian.jifty.org/debian etch jifty
 
-=item then
+Next, you will need to update your package repository and install the Jifty package. 
 
-  apt-get update
-  apt-get install jifty
+  % apt-get update
+  % apt-get install jifty
 
-=item or after a first install of jifty packages add jiftysvn repository for more recent jifty release
+This will install the latest release of Jifty.
+
+If you would like an even newer version, you can also use the Debian packages to install the latest version of Jifty from Subversion. After you've installed the version above, add this to F<sources.list>:
 
   deb http://debian.jifty.org/debian etch jifty jiftysvn
 
-=item then
+And then tell APT to upgrade the Jifty package to the latest version.
+
+  % apt-get update
+  % apt-get upgrade
 
-  apt-get update && apt-get upgrade
+=head2 ActivePerl Package
 
-=back
+For Windows ActivePerl users, a PPM repository is available (which is maintained by a Jifty committer). This will allow you to easily install Jifty and it's requirements from prebuilt packages.
 
-For Windows ActivePerl users, PPM repository is available (also maintained by a Jifty committer).
+=for XXX How does one "launch the GUI version of PPM"?
 
-=over 4
+=for XXX This needs to be cleaned up more. I haven't been through this GUI, so I'm not certain how correct or necessary this is. Some of these steps seem kind of arbitrarily difficult.
 
-=item Launch GUI version of PPM and register the repository
+First, launch the GUI version of PPM and register the repository. Go to the B<Preferences> menu and add U<http://ppm.tcool.org/archives/>. Next, you will need to disable the other repositories by clicking the yellow icons next to each. 
 
-  from the Preferences menu, register http://ppm.tcool.org/archives/
+To finish, search for Jifty, mark it, and install the package.
 
-=item (Temporarily) disable all the other registered repositories
+See L<http://ppm.tcool.org/> if you're using older versions of ActivePerl.
 
-  click yellow icons of other repositories to disable.
+=for XXX BSD ports look like maintained by the official teams; not sure for RPM and Gentoo
 
-=item then, search for Jifty, mark it, and let it install
+=begin TODO 
 
-=back
+I was thinking there was going to be an official One Package to Rule Them All download from BPS at some point. I even recall Jesse saying there was only about 2 days by 2 programs left to get it done, that would be what I really want to talk about here.
 
-See L<http://ppm.tcool.org/> if you're using older versions of ActivePerl.
+-- Sterling
 
-=for XXX: BSD ports look like maintained by the official teams; not sure for RPM and Gentoo
+=end TODO
 
 =head2 CPAN