Documentation update

pkg/README.md

@@ -5,6 +5,8 @@ This directory contains stuff to install and run diaspora.
 - ubuntu-setup.bash: script which installs all of Diasporas
   dependencies and starts the server.
 
+- bootstrap-fedora-diaspora.sh. does the same for Fedora.
+
 - source: stuff to package Diaspora into traditional tarballs
   which can be installed.
 

pkg/bootstrap-fedora-diaspora.sh

@@ -4,11 +4,15 @@
 #
 #  Usage: pkg/bootstrap-fedora-diaspora.sh [external hostname]
 #
-#  Synopsis:
+#  Synopsis, install:
-#
 #      $ git clone git@github.com:diaspora/diaspora.git
 #      $ cd diaspora
-#      $ sudo pkg/bootstrap-rffedora-diaspora.sh
+#      $ sudo pkg/bootstrap-fedora-diaspora.sh
+#
+#  New start:
+#      $ sudo su - diaspora
+#      $ cd diaspora
+#      $ script/server
 #
 #  Unless already existing, the diaspora user is created.
 #  The directory the scripts is invoked from is copied to
@@ -17,7 +21,6 @@
 #
 #  Script is designed not to make any changes in invoking
 #  caller's environment.
-#  user.
 #
 #  Must run as root
 

pkg/fedora/README.md

@@ -27,7 +27,7 @@ Bootstrap the distribution from git:
 
 Create and install the diaspora bundle and application in
 diaspora/pkg/source according to
-[source README](http://github.com/diaspora/diaspora/blob/master/source/fedora/README.md)
+[source README](http://github.com/diaspora/diaspora/tree/master/pkg/source/)
 
 Setup links from  tarballs to RPM source directory and create spec files:
     % ./prepare-rpm.sh
@@ -54,54 +54,17 @@ apache/passenger setup. After configuration, start with:
     /sbin/service diaspora-wsd start
     /sbin/service httpd restart
 
-<<<<<<< HEAD
 prepare-rpm.sh prepare creates links  also for all files listed in SOURCES.
 Typically, this is  secondary sources. *make-dist.sh source*
 
-#### Generic source synopsis
-
-Generate source tarball:
-    % ./make-dist.sh source
-    Using repo:          http://github.com/diaspora/diaspora.git
-    Commit id:           1010092232_b313272
-    Source:              dist/diaspora-0.0-1010092232_b313272.tar.gz
-    Required bundle:     1010081636_d1a4ee0
-    %
-
-The source tarball could be used as-is, by unpacking add making a
-*bundle install*. An alternative is to generate a canned bundle like:
-    % ./make-dist.sh bundle
-          [ lot's of output...]
-    Bundle: dist/diaspora-bundle-0.0-1010081636_d1a4ee0.tar.gz
-    %
-
-This file can be installed anywhere. To use it, add a symlink from vendor/bundle
-to the bundle's bundle directory.  Reasonable defaults are to install
-diaspora in /usr/share/diaspora and bundle in /usr/lib/diaspora-bundle. With these,
-the link is
-    % rm -rf /usr/share/diaspora/master/vendor/bundle
-    % ln -sf /usr/lib/diaspora-bundle/vendor/bundle  \
-    >          /usr/share/diaspora/master/vendor
-    %
-
-The directories tmp, log, and public/uploads needs to be writable. If using
-apache passenger, read the docs on uid used and file ownership.
-
-Note that the bundle version required is printed each time a new source
-is generated.
-
 #### Notes
 
 prepare-rpm.sh prepare creates links  also for all files listed in SOURCES.
-Typically, this is  secondary sources. *make-dist.sh source*
+Typically, this is  secondary sources.
-applies all patches named *.patch in this directory after checking out
-source from git.
 
 The spec-files in dist/ are patched by *./prepare-rpm.sh to reference
-correct versions of diaspora and diaspora-bundle. The diaspora-bundle
+correct versions of diaspora and diaspora-bundle.  Editing spec files should be
-is only updated if Gemfile is updated, upgrading diaspora doesn't
+done in this directory, changes in dist/ are lost when doing *./prepare-rpm.sh *.
-always require a new diaspora-bundle. Editing spec files should be done
-in this directory, changes in dist/ are lost when doing *./prepare-rpm.sh *.
 
 The topmost comment's version is patched to reflect the complete version
 of current specfile .  Write the comment in this directory, copy-paste
@@ -129,6 +92,9 @@ diaspora app.  This is more or less as mandated by LSB and Fedora packaging rule
 
 #### Discussion
 
+The 1.8.7 rebuild is a pain. However, in Fedora 14 1.8.7 is the default
+ruby version.
+
 For better or worse, this installation differs from the procedure outlined
 in the original README.md:
 

pkg/ubuntu/README.md

@@ -12,7 +12,7 @@ Bootstrap the distribution from git:
 
 Create and install the diaspora bundle and application in
 diaspora/pkg/source according to
-[source README](http://github.com/diaspora/diaspora/blob/master/source/fedora/README.md)
+[source README](http://github.com/diaspora/diaspora/tree/master/pkg/source/)
 
 Install the dependencies (a good time for a coffe break):
     % sudo ./diaspora-install-deps