[csw-devel] SF.net SVN: gar:[22109] csw/mgar/pkg/opencsw-manual/trunk/files

[pfelecan at users.sourceforge.net]

Revision: 22109
          http://gar.svn.sourceforge.net/gar/?rev=22109&view=rev
Author:   pfelecan
Date:     2013-10-03 11:53:52 +0000 (Thu, 03 Oct 2013)
Log Message:
-----------
opencsw-manual/trunk: corrections and clarifications

Modified Paths:
--------------
    csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/mirror-setup.rst
    csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/buildfarm-setup.rst

Property Changed:
----------------
    csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/mirror-setup.rst
    csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/buildfarm-setup.rst

Modified: csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/mirror-setup.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/mirror-setup.rst	2013-10-03 09:05:20 UTC (rev 22108)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/mirror-setup.rst	2013-10-03 11:53:52 UTC (rev 22109)
@@ -1,3 +1,5 @@
+.. $Id$
+
 ---------------------------
 Setting up a private mirror
 ---------------------------
@@ -26,7 +28,8 @@
 
 The directory ``opencsw-mirror`` can either be shared via HTTP or via NFS to the
 ``pkgutil`` clients.  Use ``http://myserver/opencsw-mirror/`` for HTTP and
-``file:///myserver/opencsw-mirror`` for NFS as mirror option in ``pkgutil``.
+``file:///myserver/opencsw-mirror`` for NFS as mirror option in
+``pkgutil``'s configuration file ``/etc/opt/csw/pkgutil.conf``.
 
 .. _our list of mirrors:
   http://www.opencsw.org/get-it/mirrors/


Property changes on: csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/mirror-setup.rst
___________________________________________________________________
Added: svn:keywords
   + Id

Modified: csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/buildfarm-setup.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/buildfarm-setup.rst	2013-10-03 09:05:20 UTC (rev 22108)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/buildfarm-setup.rst	2013-10-03 11:53:52 UTC (rev 22109)
@@ -1,3 +1,5 @@
+.. $Id$
+
 ---------------
 Buildfarm setup
 ---------------
@@ -42,7 +44,7 @@
 
 ::
 
-  sudo pkgutil -y -i vim gar_dev mgar gcc4core gcc4g++ sudo
+  pkgutil -y -i gar_dev mgar gcc4core gcc4g++ sudo
 
 Setup ``~/.garrc`` (required)
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -86,9 +88,11 @@
 Basic git configuration (required)
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Git will be installed as one of dependencies. It is used by GAR to make source
-patching easier. Provide basic configuration for git:
+Git is installed as one of dependencies of the base setup. It is used
+by GAR to make source patching easier.
 
+The required configuration for our usage of git is:
+
 ::
 
   git config --global user.email "you at example.com"
@@ -101,28 +105,43 @@
 ::
 
   sudo pkgutil -y -i vim
-  echo "export EDITOR=/opt/csw/bin/vim" >> ~/.bashrc
+  echo "export EDITOR=/opt/csw/bin/vim" >> ~/.bash_profile
 
 Of course, it can be your editor of choice.
 
 Initialize the source tree (required)
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-As regular user (do not use ``root`` for safety reasons) to be used for
-building init your local repository:
+As regular user, initialize your local repository. **For obvious
+security reasons, do not use** ``root``.
 
+To initialize de source tree, you execute:
+
 ::
 
-  mgar init [<path-for-build-recipes>] (defaults to ~/opencsw)
+  mgar init
 
+This will create, by default, in your home directory, the ``opencsw``
+entry. If you wish to use another place, please use a third argument,
+e.g.:
+
+::
+
+  mgar init /tank/opencsw
+
+or set the ``BUILDTREE`` parameter in the configuration file
+``~/.garrc``
+
 Please make yourself familiar with `mgar`_.
 
-Fetch all the build recipes:
+To fetch all the build recipes, you execute:
 
 ::
 
   mgar up --all
 
+Beware that this takes a lot of time an create hundreds of directories.
+
 checkpkg database (optional)
 ----------------------------
 


Property changes on: csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/buildfarm-setup.rst
___________________________________________________________________
Added: svn:keywords
   + Id

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.