Hello community,
here is the log from the commit of package yast2-pkg-bindings
checked in at Mon Jun 5 18:39:07 CEST 2006.
--------
--- yast2-pkg-bindings/yast2-pkg-bindings.changes 2006-06-01 11:53:57.000000000 +0200
+++ yast2-pkg-bindings/yast2-pkg-bindings.changes 2006-06-05 16:08:31.000000000 +0200
@@ -1,0 +2,7 @@
+Mon Jun 5 15:33:17 CEST 2006 - lslezak@suse.cz
+
+- updated documentation - descriptions of the functions,
+ added obsoleted/don't use notes
+- 2.13.82
+
+-------------------------------------------------------------------
Old:
----
yast2-pkg-bindings-2.13.81.tar.bz2
New:
----
yast2-pkg-bindings-2.13.82.tar.bz2
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Other differences:
------------------
++++++ yast2-pkg-bindings.spec ++++++
--- /var/tmp/diff_new_pack.QOsdQU/_old 2006-06-05 18:38:55.000000000 +0200
+++ /var/tmp/diff_new_pack.QOsdQU/_new 2006-06-05 18:38:55.000000000 +0200
@@ -1,5 +1,5 @@
#
-# spec file for package yast2-pkg-bindings (Version 2.13.81)
+# spec file for package yast2-pkg-bindings (Version 2.13.82)
#
# Copyright (c) 2006 SUSE LINUX Products GmbH, Nuernberg, Germany.
# This file and all modifications and additions to the pristine
@@ -11,12 +11,12 @@
# norootforbuild
Name: yast2-pkg-bindings
-Version: 2.13.81
+Version: 2.13.82
Release: 1
License: GPL
Group: System/YaST
BuildRoot: %{_tmppath}/%{name}-%{version}-build
-Source0: yast2-pkg-bindings-2.13.81.tar.bz2
+Source0: yast2-pkg-bindings-2.13.82.tar.bz2
prefix: /usr
BuildRequires: blocxx-devel boost boost-devel dbus-1-devel docbook-xsl-stylesheets doxygen gcc-c++ hal-devel libgcrypt-devel libxcrypt-devel libxslt libzypp libzypp-devel perl-XML-Writer rpm-devel sgml-skel yast2-core-devel yast2-devtools
Summary: YaST2 Package Manager Access
@@ -36,7 +36,7 @@
Stanislav Visnovsky
%prep
-%setup -n yast2-pkg-bindings-2.13.81
+%setup -n yast2-pkg-bindings-2.13.82
%build
%{prefix}/bin/y2tool y2autoconf
@@ -67,6 +67,10 @@
%doc %{prefix}/share/doc/packages/yast2-pkg-bindings
%changelog -n yast2-pkg-bindings
+* Mon Jun 05 2006 - lslezak@suse.cz
+- updated documentation - descriptions of the functions,
+ added obsoleted/don't use notes
+- 2.13.82
* Thu Jun 01 2006 - lslezak@suse.cz
- get source ID by numericId() call (do not search in all available
sources) (#179410, #163609)
++++++ yast2-pkg-bindings-2.13.81.tar.bz2 -> yast2-pkg-bindings-2.13.82.tar.bz2 ++++++
diff -urN --exclude=CVS --exclude=.cvsignore --exclude=.svn --exclude=.svnignore old/yast2-pkg-bindings-2.13.81/VERSION new/yast2-pkg-bindings-2.13.82/VERSION
--- old/yast2-pkg-bindings-2.13.81/VERSION 2006-06-01 09:44:34.000000000 +0200
+++ new/yast2-pkg-bindings-2.13.82/VERSION 2006-06-05 15:33:14.000000000 +0200
@@ -1 +1 @@
-2.13.81
+2.13.82
diff -urN --exclude=CVS --exclude=.cvsignore --exclude=.svn --exclude=.svnignore old/yast2-pkg-bindings-2.13.81/configure new/yast2-pkg-bindings-2.13.82/configure
--- old/yast2-pkg-bindings-2.13.81/configure 2006-06-01 11:49:41.000000000 +0200
+++ new/yast2-pkg-bindings-2.13.82/configure 2006-06-05 15:47:42.000000000 +0200
@@ -1,6 +1,6 @@
#! /bin/sh
# Guess values for system-dependent variables and create Makefiles.
-# Generated by GNU Autoconf 2.59 for yast2-pkg-bindings 2.13.81.
+# Generated by GNU Autoconf 2.59 for yast2-pkg-bindings 2.13.82.
#
# Report bugs to http://bugs.opensuse.org/.
#
@@ -423,8 +423,8 @@
# Identity of this package.
PACKAGE_NAME='yast2-pkg-bindings'
PACKAGE_TARNAME='yast2-pkg-bindings'
-PACKAGE_VERSION='2.13.81'
-PACKAGE_STRING='yast2-pkg-bindings 2.13.81'
+PACKAGE_VERSION='2.13.82'
+PACKAGE_STRING='yast2-pkg-bindings 2.13.82'
PACKAGE_BUGREPORT='http://bugs.opensuse.org/'
ac_unique_file="RPMNAME"
@@ -971,7 +971,7 @@
# Omit some internal or obsolete options to make the list less imposing.
# This message is too long to be a string in the A/UX 3.1 sh.
cat <<_ACEOF
-\`configure' configures yast2-pkg-bindings 2.13.81 to adapt to many kinds of systems.
+\`configure' configures yast2-pkg-bindings 2.13.82 to adapt to many kinds of systems.
Usage: $0 [OPTION]... [VAR=VALUE]...
@@ -1038,7 +1038,7 @@
if test -n "$ac_init_help"; then
case $ac_init_help in
- short | recursive ) echo "Configuration of yast2-pkg-bindings 2.13.81:";;
+ short | recursive ) echo "Configuration of yast2-pkg-bindings 2.13.82:";;
esac
cat <<\_ACEOF
@@ -1184,7 +1184,7 @@
test -n "$ac_init_help" && exit 0
if $ac_init_version; then
cat <<\_ACEOF
-yast2-pkg-bindings configure 2.13.81
+yast2-pkg-bindings configure 2.13.82
generated by GNU Autoconf 2.59
Copyright (C) 2003 Free Software Foundation, Inc.
@@ -1198,7 +1198,7 @@
This file contains any messages produced by compilers while
running configure, to aid debugging if configure makes a mistake.
-It was created by yast2-pkg-bindings $as_me 2.13.81, which was
+It was created by yast2-pkg-bindings $as_me 2.13.82, which was
generated by GNU Autoconf 2.59. Invocation command line was
$ $0 $@
@@ -1928,7 +1928,7 @@
# Define the identity of the package.
PACKAGE='yast2-pkg-bindings'
- VERSION='2.13.81'
+ VERSION='2.13.82'
cat >>confdefs.h <<_ACEOF
@@ -2139,7 +2139,7 @@
-VERSION="2.13.81"
+VERSION="2.13.82"
RPMNAME="yast2-pkg-bindings"
MAINTAINER="Michael Andres "
@@ -20273,7 +20273,7 @@
} >&5
cat >&5 <<_CSEOF
-This file was extended by yast2-pkg-bindings $as_me 2.13.81, which was
+This file was extended by yast2-pkg-bindings $as_me 2.13.82, which was
generated by GNU Autoconf 2.59. Invocation command line was
CONFIG_FILES = $CONFIG_FILES
@@ -20336,7 +20336,7 @@
cat >>$CONFIG_STATUS <<_ACEOF
ac_cs_version="\\
-yast2-pkg-bindings config.status 2.13.81
+yast2-pkg-bindings config.status 2.13.82
configured by $0, generated by GNU Autoconf 2.59,
with options \\"`echo "$ac_configure_args" | sed 's/[\\""\`\$]/\\\\&/g'`\\"
diff -urN --exclude=CVS --exclude=.cvsignore --exclude=.svn --exclude=.svnignore old/yast2-pkg-bindings-2.13.81/configure.in new/yast2-pkg-bindings-2.13.82/configure.in
--- old/yast2-pkg-bindings-2.13.81/configure.in 2006-06-01 11:49:24.000000000 +0200
+++ new/yast2-pkg-bindings-2.13.82/configure.in 2006-06-05 15:47:29.000000000 +0200
@@ -1,9 +1,9 @@
dnl configure.in for yast2-pkg-bindings
dnl
-dnl -- This file is generated by y2autoconf 2.13.18 - DO NOT EDIT! --
+dnl -- This file is generated by y2autoconf 2.13.16 - DO NOT EDIT! --
dnl (edit configure.in.in instead)
-AC_INIT(yast2-pkg-bindings, 2.13.81, http://bugs.opensuse.org/, yast2-pkg-bindings)
+AC_INIT(yast2-pkg-bindings, 2.13.82, http://bugs.opensuse.org/, yast2-pkg-bindings)
dnl Check for presence of file 'RPMNAME'
AC_CONFIG_SRCDIR([RPMNAME])
@@ -17,7 +17,7 @@
AM_INIT_AUTOMAKE(tar-ustar) dnl searches for some needed programs
dnl Important YaST2 variables
-VERSION="2.13.81"
+VERSION="2.13.82"
RPMNAME="yast2-pkg-bindings"
MAINTAINER="Michael Andres "
diff -urN --exclude=CVS --exclude=.cvsignore --exclude=.svn --exclude=.svnignore old/yast2-pkg-bindings-2.13.81/src/Package.cc new/yast2-pkg-bindings-2.13.82/src/Package.cc
--- old/yast2-pkg-bindings-2.13.81/src/Package.cc 2006-06-01 10:21:07.000000000 +0200
+++ new/yast2-pkg-bindings-2.13.82/src/Package.cc 2006-06-05 10:32:59.000000000 +0200
@@ -1203,7 +1203,7 @@
// ------------------------
/**
@builtin SaveState
- @short Save the current selection state
+ @short Save the current selection state - do not use, not implemented
@description
save the current package selection status for later
retrieval via Pkg::RestoreState()
@@ -1223,7 +1223,7 @@
/**
@builtin RestoreState
- @short Restore Saved state
+ @short Restore Saved state - do not use, not implemented
@description
restore the package selection status from a former
call to Pkg::SaveState()
@@ -1251,7 +1251,7 @@
/**
@builtin ClearSaveState
- @short clear a saved state (to reduce memory consumption)
+ @short clear a saved state (to reduce memory consumption) - do not use, not implemented
@return boolean
*/
diff -urN --exclude=CVS --exclude=.cvsignore --exclude=.svn --exclude=.svnignore old/yast2-pkg-bindings-2.13.81/src/Patch.cc new/yast2-pkg-bindings-2.13.82/src/Patch.cc
--- old/yast2-pkg-bindings-2.13.81/src/Patch.cc 2006-02-16 08:33:47.000000000 +0100
+++ new/yast2-pkg-bindings-2.13.82/src/Patch.cc 2006-06-05 10:55:39.000000000 +0200
@@ -42,10 +42,8 @@
//-------------------------------------------------------------
/**
@builtin YouStatus
-
- @short get map with status information
- @return map
-
+ @short obsoleted, do not use
+ @return map empty map
*/
YCPMap
PkgModuleFunctions::YouStatus ()
@@ -76,14 +74,8 @@
/**
@builtin YouSetServer
-
- @short Set server to be used for getting patches.
- @param map you server map as returned from YouGetServers.
- @return string "" success
-
- "args" wrong arguments
-
- "error" other error
+ @short obsoleted, do not use
+ @return string empty string
*/
YCPValue
PkgModuleFunctions::YouSetServer (const YCPMap& servers)
@@ -102,9 +94,8 @@
/**
@builtin YouGetUserPassword
-
- @short Get username and password needed for access to server.
- @return map "username" success, "password" password
+ @short obsoleted, do not use
+ @return map empty map
*/
YCPValue
PkgModuleFunctions::YouGetUserPassword ()
@@ -114,24 +105,15 @@
you.readUserPassword();
*/
- string username = "you.username()";
- string password = "you.password()";
-
YCPMap result;
- result->add( YCPString( "username" ), YCPString( username ) );
- result->add( YCPString( "password" ), YCPString( password ) );
return result;
}
/**
@builtin YouSetUserPassword
-
- @short Set username and password needed for access to server.
- @param string username
- @param string password
- @param boolean save true, if username/password should be saved to disk
- @return string success if empty, "args" wrong arguments, "error" other error
+ @short obsoleted, do not use
+ @return string empty string
*/
YCPValue
PkgModuleFunctions::YouSetUserPassword (const YCPString& user, const YCPString& passwd, const YCPBoolean& p)
@@ -157,14 +139,8 @@
// ------------------------
/**
@builtin YouGetServers
-
- @short get urls of patch servers
-
- @param list<map> list of maps where results are stored. The maps have the following fields
- set: "url" -> URL of server. "name" -> Descriptive name of server.
- "directory" -> Directory file used to get list of patches.
- @return string empty for success, "args" bad args, "get" error getting file from server
- "write" error writing file to disk and "read" error reading file after download
+ @short obsoleted, do not use
+ @return string empty string
*/
YCPString
PkgModuleFunctions::YouGetServers (YCPReference strings)
@@ -201,11 +177,8 @@
/**
@builtin YouGetDirectory
-
- @short retrieve directory file listing all available patches
-
- @return string empty string for success, "url" -> url not valid, "login" -> login failed
- "error"-> other error
+ @short obsoleted, do not use
+ @return string empty string
*/
YCPValue
PkgModuleFunctions::YouGetDirectory ()
@@ -225,20 +198,12 @@
/**
@builtin YouRetrievePatchInfo
-
- @short retrieve patches
- @param boolean download_again true if patches should be downloaded again
- @param boolean check_signatures true if signatures should be checked.
-
- @return string empty string for success, "args" for bad args, "media" for media error
- "sig" for signature check failed, "abort" for user aborted operation,
- "url" for url not valid and "login" for login failed
+ @short obsoleted, do not use
+ @return string empty string
*/
YCPValue
PkgModuleFunctions::YouRetrievePatchInfo (const YCPBoolean& download, const YCPBoolean& sig)
{
- bool reload = download->value();
- bool checkSig = sig->value();
/* TODO FIXME
InstYou &you = _y2pm.youPatchManager().instYou();
@@ -260,10 +225,9 @@
}
/**
- @builtin YouProcessPatches
- @short Download and install patches.
- @return boolean
-
+ @builtin YouProcessPatche
+ @short obsoleted, do not use
+ @return boolean true
*/
YCPValue
PkgModuleFunctions::YouProcessPatches ()
@@ -277,10 +241,8 @@
/**
@builtin YouSelectPatches
-
- @short select patches based on types.
+ @short obsoleted, do not use
@return void
-
*/
YCPValue
PkgModuleFunctions::YouSelectPatches ()
@@ -322,9 +284,8 @@
/**
@builtin YouRemovePackages
-
- @short remove downloaded packages.
- @return boolean
+ @short - obsoleted, do not use
+ @return boolean true
*/
YCPValue
PkgModuleFunctions::YouRemovePackages ()
diff -urN --exclude=CVS --exclude=.cvsignore --exclude=.svn --exclude=.svnignore old/yast2-pkg-bindings-2.13.81/src/PkgModuleFunctions.cc new/yast2-pkg-bindings-2.13.82/src/PkgModuleFunctions.cc
--- old/yast2-pkg-bindings-2.13.81/src/PkgModuleFunctions.cc 2006-04-24 10:52:55.000000000 +0200
+++ new/yast2-pkg-bindings-2.13.82/src/PkgModuleFunctions.cc 2006-06-05 15:39:33.000000000 +0200
@@ -261,9 +261,7 @@
/**
* @builtin InstSysMode
- * @short Set packagemanager to "inst-sys" mode
- * @description Set packagemanager to "inst-sys" mode - dont use local caches (ramdisk!)
- * OBSOLETED!
+ * @short obsoleted - do not use
* @return void
*/
YCPValue
@@ -431,7 +429,7 @@
/**
* @builtin LastErrorId
- * @short get current error as id string
+ * @short Obsoleted function, do not use
* @return string
*/
YCPValue
diff -urN --exclude=CVS --exclude=.cvsignore --exclude=.svn --exclude=.svnignore old/yast2-pkg-bindings-2.13.81/src/Selection.cc new/yast2-pkg-bindings-2.13.82/src/Selection.cc
--- old/yast2-pkg-bindings-2.13.81/src/Selection.cc 2006-06-01 08:25:38.000000000 +0200
+++ new/yast2-pkg-bindings-2.13.82/src/Selection.cc 2006-06-05 11:22:02.000000000 +0200
@@ -51,7 +51,7 @@
/**
@builtin GetSelections
- @short Return list of selections matching given status
+ @short Return list of selections matching given status - obsoleted, use ResolvableProperties() instead
@description
returns a list of selection names matching the status symbol
and the category.
@@ -156,7 +156,7 @@
/**
@builtin GetPatterns
- @short Return list of patterns matching given status
+ @short Return list of patterns matching given status (obsoleted, use ResolvableProperties())
@description
returns a list of pattern names matching the status symbol
and the category.
@@ -251,6 +251,7 @@
@short Get Pattern Data
@description
+ This builtin will be replaced by ResolvableProperties() in the future.
Return information about pattern
<code>
@@ -328,6 +329,8 @@
@short Get Selection Data
@description
+ This builtin will be replaced by ResolvableProperties() in the future.
+
Return information about selection
<code>
@@ -499,16 +502,12 @@
/**
@builtin SetSelection
- @short Set a new selection
+ @short Set a new selection - obsoleted, use ResolvableInstall() instead
@description
- If the selection is a base selection,
- this effetively resets the current package selection to
- the packages of the newly selected base selection
- Usually returns true
+ Mark the selection for installation
@param string selection
@return boolean Returns false if the given string does not match
a known selection.
-
*/
YCPBoolean
PkgModuleFunctions::SetSelection (const YCPString& selection)
@@ -520,11 +519,9 @@
/**
@builtin ClearSelection
- @short Clear a selected selection
+ @short Clear a selected selection - obsoleted, use ResolvableRemove() instead
@param string selection
@return boolean
-
-
*/
YCPValue
PkgModuleFunctions::ClearSelection (const YCPString& selection)
@@ -538,14 +535,9 @@
/**
@builtin ActivateSelections
- @short Activate all selected selections
- @description
- To be called when user is done with selections and wants
- to continue on the package level (or finish)
-
- This will transfer the selection status to package status
+ @short Activate all selected selections - obsoleted, use PkgSolve() instead
- @return boolean
+ @return boolean true
@deprecated Use Pkg::PkgSolve instead, selections are solvable now
*/
diff -urN --exclude=CVS --exclude=.cvsignore --exclude=.svn --exclude=.svnignore old/yast2-pkg-bindings-2.13.81/src/Source.cc new/yast2-pkg-bindings-2.13.82/src/Source.cc
--- old/yast2-pkg-bindings-2.13.81/src/Source.cc 2006-05-29 13:32:29.000000000 +0200
+++ new/yast2-pkg-bindings-2.13.82/src/Source.cc 2006-06-05 14:56:45.000000000 +0200
@@ -67,12 +67,8 @@
/****************************************************************************************
* @builtin SourceSetRamCache
- * @short Allow/prevent InstSrces from caching package metadata on ramdisk
- * @description
- * In InstSys: Allow/prevent InstSrces from caching package metadata on ramdisk.
- * If no cache is used the media cannot be unmounted, i.e. no CD change possible.
- *
- * @param boolean allow If true, allow caching
+ * @short Obsoleted function, do not use
+ * @param boolean
* @return boolean
**/
YCPValue
@@ -527,26 +523,10 @@
/****************************************************************************************
* @builtin SourceProduct
- * @short Get Product info
- * @param integer SrcId Specifies the InstSrc to query.
- *
- * <code>
- * $[
- * "baseproduct":"",
- * "baseversion":"",
- * "defaultbase":"i386",
- * "distproduct":"SuSE-Linux-DVD",
- * "distversion":"10.0",
- * "flags":"update",
- * "name":"SUSE LINUX",
- * "product":"SUSE LINUX 10.0",
- * "relnotesurl":"http://www.suse.com/relnotes/i386/SUSE-LINUX/10.0/release-notes.rpm",
- * "requires":"suse-release-10.0",
- * "vendor":"SUSE LINUX Products GmbH, Nuernberg, Germany",
- * "version":"10.0"
- * ]
- * </code>
- * @return map Product info as a map
+ * @short Obsoleted function, do not use, see SourceProductData builtin
+ * @deprecated
+ * @param integer
+ * @return map empty map
**/
YCPValue
PkgModuleFunctions::SourceProduct (const YCPInteger& id)
@@ -742,9 +722,7 @@
/****************************************************************************************
* @builtin SourceInstallOrder
*
- * @short Explicitly set an install order.
- * @param map order_map A map of 'int order : int source_id'. source_ids are expected to
- * denote known and enabled sources.
+ * @short not implemented, do not use (Explicitly set an install order.)
* @return boolean
**/
YCPValue
@@ -1469,12 +1447,13 @@
/****************************************************************************************
* Pkg::SourceSaveRanks () -> boolean
*
- * Save ranks to disk. Return true on success, false on error.
+ * @short Obsoleted function, do not use
+ * @return boolean true
**/
YCPValue
PkgModuleFunctions::SourceSaveRanks ()
{
- y2internal( "SourceSaveRanks not implemented yet, please, report" );
+ y2error( "SourceSaveRanks not implemented" );
return YCPBoolean( true );
}
diff -urN --exclude=CVS --exclude=.cvsignore --exclude=.svn --exclude=.svnignore old/yast2-pkg-bindings-2.13.81/src/Target.cc new/yast2-pkg-bindings-2.13.82/src/Target.cc
--- old/yast2-pkg-bindings-2.13.81/src/Target.cc 2006-04-13 09:48:45.000000000 +0200
+++ new/yast2-pkg-bindings-2.13.82/src/Target.cc 2006-06-05 12:50:18.000000000 +0200
@@ -289,6 +289,9 @@
* @description
* return list of maps of all installed products in reverse
* installation order (product installed last comes first)
+ *
+ * Deprecated, will be replaced by ResolvableProperties() in the future.
+ *
* @return list
*/
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Remember to have fun...
---------------------------------------------------------------------
To unsubscribe, e-mail: opensuse-commit-unsubscribe@opensuse.org
For additional commands, e-mail: opensuse-commit-help@opensuse.org