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

[wahwah at users.sourceforge.net]

Revision: 17776
          http://gar.svn.sourceforge.net/gar/?rev=17776&view=rev
Author:   wahwah
Date:     2012-04-19 12:09:48 +0000 (Thu, 19 Apr 2012)
Log Message:
-----------
opencsw-manual/trunk: Add a section about building a catalog

Modified Paths:
--------------
    csw/mgar/pkg/opencsw-manual/trunk/Makefile
    csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/index.rst

Added Paths:
-----------
    csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/building-a-catalog.rst

Modified: csw/mgar/pkg/opencsw-manual/trunk/Makefile
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/Makefile	2012-04-19 11:58:22 UTC (rev 17775)
+++ csw/mgar/pkg/opencsw-manual/trunk/Makefile	2012-04-19 12:09:48 UTC (rev 17776)
@@ -21,11 +21,12 @@
 MASTER_SITES = http://www.gnu.org/licenses/
 DISTFILES  = fdl-1.3.txt
 CONFIGURE_SCRIPTS =
-BUILD_SCRIPTS = policy
-INSTALL_SCRIPTS = policy
+BUILD_SCRIPTS = manual
+INSTALL_SCRIPTS = manual
 TEST_SCRIPTS =
 ARCHALL_CSWopencsw-manual = 1
-CATALOGNAME_CSWopencsw-manual = opencsw_policy
+# This line is necessary for copy-to-web to work.
+CATALOGNAME_CSWopencsw-manual = opencsw_manual
 LICENSE = fdl-1.3.txt
 
 BUILD_DEP_PKGS += CSWpy-sphinx
@@ -38,10 +39,11 @@
 	rsync -r $(FILEDIR)/ $(WORKSRC)
 	@$(MAKECOOKIE)
 
-build-policy:
+build-manual:
 	(cd $(WORKSRC); gmake html)
+	@$(MAKECOOKIE)
 
-install-policy:
+install-manual:
 	ginstall -m 755 -d $(PKGROOT)$(docdir)/$(CATALOGNAME_CSWopencsw-manual)
 	rsync -rv $(WORKSRC)/_build/html/ $(PKGROOT)$(docdir)/$(CATALOGNAME_CSWopencsw-manual)
 	@$(MAKECOOKIE)

Added: csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/building-a-catalog.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/building-a-catalog.rst	                        (rev 0)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/building-a-catalog.rst	2012-04-19 12:09:48 UTC (rev 17776)
@@ -0,0 +1,25 @@
+--------------------------
+Building a package catalog
+--------------------------
+
+If you have built a package (or a set of them), you might want to test them.
+You could just gunzip the packages and run pkgadd, but if you wanted to test
+your package on a couple of systems, it's better to build a catalog.
+
+Make sure you've installed the ``pkgutilplus`` package. It contains the
+``bldcat`` utility. You can use it to create a local catalog with your
+package::
+
+  catalog_root=${HOME}/opencsw-catalog
+  catalog_path=${catalog_root}/$(uname -p)/$(uname -r)
+  cp /path/to/your_package.pkg ${catalog_path}
+  bldcat ${catalog_path}
+
+Once this is done, you can instruct pkgutil to install packages from it. You
+can either serve the root catalog directory over HTTP, or you can refer to
+a local filesystem path::
+
+  sudo pkgutil -t file://${catalog_path} -y -i your_package
+
+If you create a persistent local catalog, you can add the path or URL to
+``/opt/csw/etc/pkgutil.conf``.

Modified: csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/index.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/index.rst	2012-04-19 11:58:22 UTC (rev 17775)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/index.rst	2012-04-19 12:09:48 UTC (rev 17776)
@@ -9,4 +9,5 @@
   :maxdepth: 2
 
   filesystem-layout
+  building-a-catalog
   shared-libraries

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