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

wahwah at users.sourceforge.net wahwah at users.sourceforge.net
Mon Jan 30 13:51:17 CET 2012


Revision: 16935
          http://gar.svn.sourceforge.net/gar/?rev=16935&view=rev
Author:   wahwah
Date:     2012-01-30 12:51:17 +0000 (Mon, 30 Jan 2012)
Log Message:
-----------
opencsw-manual: minor changes, glossary update

Modified Paths:
--------------
    csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/bootstrapping.rst
    csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/glossary.txt
    csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/index.rst
    csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/introduction.rst

Modified: csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/bootstrapping.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/bootstrapping.rst	2012-01-30 01:30:33 UTC (rev 16934)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/bootstrapping.rst	2012-01-30 12:51:17 UTC (rev 16935)
@@ -2,8 +2,8 @@
 Bootstrapping
 -------------
 
-OpenCSW uses a tool named pkgutil on top of the Solaris packaging utilities
-to automatically download, install and update packages. This has to be installed
+OpenCSW uses a tool named pkgutil on top of the Solaris packaging utilities to
+automatically download, install and update packages. It needs to be installed
 manually once, after that all maintenance is done via pkgutil.
 
 On a Solaris 10 system, you can use the capacity of pkgadd to download
@@ -11,28 +11,21 @@
 
   pkgadd -d http://get.opencsw.org/now
 
-On Solaris 8 and 9 you need to download the package manually e.g. using wget
+On Solaris 8 and 9 you need to download the package manually, e.g. using wget
 and then install it::
 
   wget http://mirror.opencsw.org/opencsw/pkgutil.pkg
-  pkgadd -d pkgutil.pkg
+  pkgadd -d pkgutil.pkg all
 
-Now is a good time to modify your profile to honour the OpenCSW programs.
-For a bourne shell add the following lines to your ``.profile``::
+For easy access to OpenCSW programs, put ``/opt/csw/bin`` in front of PATH,
+and ``/opt/csw/share/man`` in front of MANPATH.
 
-  PATH=$PATH:/opt/csw/bin
-  MANPATH=$MANPATH:/opt/csw/share/man
+You can now start installing packages. For a list of available packages use::
 
-Please source it or logout and login again to make sure the environment is adjusted.
-
-You can now start installing packages. For a list of available packages use
-::
-
   pkgutil -l
 
 As the list is quite long and you probably have an idea what you are looking for the
-list can be fuzzy-matched with
-::
+list can be fuzzy-matched with::
 
   root# pkgutil -a vim
   common               package              catalog                        size
@@ -55,12 +48,11 @@
 
 Now that you are about to install lots of stuff it may be a good time to select
 one of the mirrors from ``mirror.opencsw.org`` close to you. The official mirrors
-are listed at
-::
+are listed at::
 
   http://www.opencsw.org/get-it/mirrors/
 
-It is important to note that ``pkgutil`` has **two** configuration files:
+It is important to note that ``pkgutil`` can use **two** configuration files:
 
 - ``/etc/opt/csw/pkgutil.conf``
 - ``/opt/csw/etc/pkgutil.conf``
@@ -156,10 +148,10 @@
 the interoperability and we feel that in times of ever growing disks the
 flexibility is worth more than the saved bytes.
 
-Package dependencies are modeled in the OpenCSW `catalog`_s" to allow automatic
+Package dependencies are modeled in the OpenCSW `catalogs`_ to allow automatic
 dependency resolution via pkgutil. To view the current dependencies for a
-package you can use
-::
+package you can use::
+
   pkgutil --deptree <pkg>
 
 

Modified: csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/glossary.txt
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/glossary.txt	2012-01-30 01:30:33 UTC (rev 16934)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/glossary.txt	2012-01-30 12:51:17 UTC (rev 16935)
@@ -3,6 +3,15 @@
 --------
 
 catalog
+    A directory with packages and an index, for a specific architecture (SPARC
+    or Intel) and OS release (e.g. Solaris 9 or Solaris 10).  A catalog index
+    file contains a list of packages together with their catalog names,
+    version, checksum and a list of dependencies to other packages.
 
-A catalog contains a list of packages together with their catalog names, version, checksum
-and a list of dependencies to other packages.
+catalogname
+    A name of a package as it shows in the catalog index file, and in pkgutil
+    output.
+
+pkgname
+    A name of a package as it shows in the output of the ``pkginfo`` command.
+    Usually has the form of CSWfoo.

Modified: csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/index.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/index.rst	2012-01-30 01:30:33 UTC (rev 16934)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/index.rst	2012-01-30 12:51:17 UTC (rev 16935)
@@ -11,6 +11,7 @@
   bootstrapping
   configuring-services
   pkgutil-reference
+  glossary
 
 .. [#dagosscrapbook]
    `Dago's Scrapbook`_

Modified: csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/introduction.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/introduction.rst	2012-01-30 01:30:33 UTC (rev 16934)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/introduction.rst	2012-01-30 12:51:17 UTC (rev 16935)
@@ -6,9 +6,10 @@
 more and more programs with every release. However, the world of open source is
 big and there is always missing something. OpenCSW fills this gap by providing
 a large amount of precompiled software and open source build recipes.
-The p\xC3ackages can be installed comfortably with automatic dependency resolution
+The packages can be installed comfortably with automatic dependency resolution
 but require root access to the machine. If you really want to compile your
-own software the build recipes are available for all packages too.
+own software, the build recipes are available for all packages too.
 
-Solaris 10 is fully supported whereas Solaris 8 and 9 are best effort
-and only get sporadic updates.
+Solaris 10 is fully supported. Solaris 8 and 9 get best effort support level.
+As of January 2012, Solaris 8 catalogs do not get any updates, and Solaris
+9 catalogs get some amount of updates.

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



More information about the devel mailing list