SF.net SVN: gar:[23414] csw/mgar/pkg/opencsw-manual/trunk/files
wahwah at users.sourceforge.net
wahwah at users.sourceforge.net
Sun Apr 13 22:39:53 CEST 2014
Revision: 23414
http://sourceforge.net/p/gar/code/23414
Author: wahwah
Date: 2014-04-13 20:39:52 +0000 (Sun, 13 Apr 2014)
Log Message:
-----------
/home/maciej/opencsw/opencsw-manual/trunk: Updates to getting started
Modified Paths:
--------------
csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/faq.rst
csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/getting-started.rst
csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/introduction.rst
csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/index.rst
Added Paths:
-----------
csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/catalog-releases.rst
Removed Paths:
-------------
csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/catalog-staging.rst
Modified: csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/faq.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/faq.rst 2014-04-13 20:35:49 UTC (rev 23413)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/faq.rst 2014-04-13 20:39:52 UTC (rev 23414)
@@ -57,8 +57,8 @@
version of libfoo.so.1 might be in SUNWfoo on Solaris 10 and SUNWfoox on
Solaris 9.
-Where are the Solaris 10 version of a package I'm looking at?
-=============================================================
+Where is the Solaris 10 version of a package I'm looking at?
+============================================================
As of April 2014 most packages are built for Solaris 10, but since it's
possible to install a Solaris 9 package on Solaris 10, we take advantage of
@@ -70,9 +70,12 @@
Are the binaries compiled for advanced Instruction Set Architectures?
=====================================================================
-Binaries are compiled for basic ISAs. In most cases, performance is not
-significantly improved by compiling for advanced ISAs. For those cases where
-it is, we usually provide cpu-optimized libraries.
+Binaries are compiled for basic ISAs. As of April 2014, it means pentium_pro on
+Intel and sparcv8+ on SPARC.
+In most cases, performance is not significantly improved by compiling for
+advanced ISAs. For those cases where it is, we usually provide cpu-optimized
+libraries.
+
If you know of a specific binary that would benefit from cpu-specific
optimizations, feel free to contact this package's maintainer and ask about it.
Modified: csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/getting-started.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/getting-started.rst 2014-04-13 20:35:49 UTC (rev 23413)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/getting-started.rst 2014-04-13 20:39:52 UTC (rev 23414)
@@ -36,12 +36,10 @@
Skip to :ref:`Step 2: installing packages <getting-started-installing-packages>`.
-Optional: Selecting your package source
-=======================================
+Optional: Selecting your mirror
+===============================
-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::
+For faster downloads, you can select a mirror geographically close to you.
http://www.opencsw.org/get-it/mirrors/
@@ -50,10 +48,17 @@
mirror=http://mirror.opencsw.org/opencsw/unstable
-By default, ``pkgutil`` is configured to use the ``testing`` catalog. You might
-change it to ``unstable`` on your development hosts to catch any issues before
-they hit the ``testing`` catalog.
+Optional: Selecting the catalog release
+=======================================
+
+By default, ``pkgutil`` is configured to use the ``testing`` catalog. See
+:ref:`catalog releases <catalog-releases>` for information on releases.
+
+You might want change it to ``unstable`` on your development hosts to catch any
+issues before they hit the ``testing`` catalog. Or you can switch it to
+``stable`` if you want no updates (except for new stable releases).
+
You can verify the setting with ``pkgutil -V`` ::
...
@@ -63,7 +68,8 @@
noncsw false (default: false)
...
-On the next catalog update with ``pkgutil -U`` the catalogs are pulled from the new mirror.
+On the next catalog update with ``pkgutil -U`` the catalogs indexes are
+downloaded from the new mirror.
Skip to :ref:`Step 2: installing packages <getting-started-installing-packages>`.
Modified: csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/introduction.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/introduction.rst 2014-04-13 20:35:49 UTC (rev 23413)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-administrators/introduction.rst 2014-04-13 20:39:52 UTC (rev 23414)
@@ -8,8 +8,8 @@
from the companion disc, or isn't up to date enough.
OpenCSW fills this gap by providing binary packages and the corresponding build
-recipes. Installing our packages is easy: you can install a package with all
-dependencies with a single command.
+recipes. Installing our packages is easy: you can install a package together
+with all dependencies with a single command.
If you want to build your own packages, build recipes for our package are
available in the `source code repository`_.
@@ -30,7 +30,7 @@
As of April 2014:
* Solaris 11 – can use OpenCSW packages thanks to the backward binary compatibility
-* Solaris 10 – is the main focus
+* **Solaris 10 – is the main focus**
* Solaris 9 – best effort, occasional updates
* Solaris 8 – no package updates at all
Copied: csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/catalog-releases.rst (from rev 23413, csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/catalog-staging.rst)
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/catalog-releases.rst (rev 0)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/catalog-releases.rst 2014-04-13 20:39:52 UTC (rev 23414)
@@ -0,0 +1,28 @@
+.. _catalog-releases:
+
+---------------
+Catalog staging
+---------------
+
+For releases and staging overview, see the releases and staging wiki page
+Releases and Staging [#releases-and-staging-wiki]_, written in 2009. You can
+also see the README file on the OpenCSW master mirror
+[#opencsw-master-mirror]_.
+
+* **unstable** is a working catalog where package maintainers make changes at
+ will. Updates to unstable are pushed every 10 minutes (April 2014).
+* **testing** is a symlink to a named release. It gets periodically updated
+ from the unstable catalog. As of March 2014, it is done infrequently, by a
+ human.
+* **stable** is a symlink to a named release. Once a stable release is made, it
+ is not updated unless there are important security updates to be pushed.
+
+References
+----------
+
+.. [#releases-and-staging-wiki] `Releases and staging wiki page`_
+.. _Releases and staging wiki page:
+ http://wiki.opencsw.org/releases-and-staging
+.. [#opencsw-master-mirror] `OpenCSW master mirror`_
+.. _OpenCSW master mirror:
+ http://mirror.opencsw.org/opencsw/
Deleted: csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/catalog-staging.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/catalog-staging.rst 2014-04-13 20:35:49 UTC (rev 23413)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/catalog-staging.rst 2014-04-13 20:39:52 UTC (rev 23414)
@@ -1,24 +0,0 @@
----------------
-Catalog staging
----------------
-
-For releases and staging overview, see the releases and staging wiki
-page[#releases-and-staging-wiki]_, written in 2009. You can also see the README
-file on the `OpenCSW master mirror`_.
-
-* unstable is a working catalog where package maintainers can make changes at
- will. It is regenerated every few hours.
-* testing is a symlink to a named release. It gets periodically updated from the
- unstable catalog. As of March 2014, it is done infrequently, by a human.
-* stable is a symlink to a named release. Once a stable release is made, it is
- not updated unless there are important security updates to be pushed.
-
-Footnotes
----------
-.. [#releases-and-staging-wiki]
- `Releases and staging wiki page`_
-.. _Releases and staging wiki page:
- http://sourceforge.net/apps/trac/gar/browser/csw/mgar/gar/v2/
- lib/python/sharedlib_utils_test.py#L13
-.. _OpenCSW master mirror:
- http://mirror.opencsw.org/opencsw/
Modified: csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/index.rst
===================================================================
--- csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/index.rst 2014-04-13 20:35:49 UTC (rev 23413)
+++ csw/mgar/pkg/opencsw-manual/trunk/files/for-maintainers/index.rst 2014-04-13 20:39:52 UTC (rev 23414)
@@ -17,4 +17,4 @@
package-naming
buildfarm-setup
32-bit-and-64-bit
- catalog-staging
+ catalog-releases
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