summaryrefslogtreecommitdiff
path: root/WHATSNEW.txt
diff options
context:
space:
mode:
authorDerrell Lipman <derrell.lipman@unwireduniverse.com>2008-03-03 18:13:33 -0500
committerKarolin Seeger <ks@sernet.de>2008-03-04 09:02:42 +0100
commit2f0a61564ae080b027d43d77428d290fd8ca017b (patch)
treee0a6d6892e148222a922582a5f75aa2412dbc70f /WHATSNEW.txt
parent8cd0cf153e409dd49e66bd500fad8501371a83a5 (diff)
downloadsamba-2f0a61564ae080b027d43d77428d290fd8ca017b.tar.gz
Continued revamping of libsmbclient.
- James suggested using gcc's "deprecated" attribute to mark the context structure fields to generate warnings. This creates a scenario with the best of all worlds. I'm able to move to an organization that more easily allows future enhancements, while avoiding any mandatory changes by applications. Thanks, James! - Updated WHATSNEW.txt so that it accurately reflects the current state of affairs. Derrell (cherry picked from commit a67f96fbe9683b46c2149f7cb439d13f7f0e6ecd) (This used to be commit 046653403fadfa2d42decce7048eca6321b321c6)
Diffstat (limited to 'WHATSNEW.txt')
-rw-r--r--WHATSNEW.txt17
1 files changed, 6 insertions, 11 deletions
diff --git a/WHATSNEW.txt b/WHATSNEW.txt
index 62a0baf9fc2..0b355547d93 100644
--- a/WHATSNEW.txt
+++ b/WHATSNEW.txt
@@ -111,16 +111,11 @@ Modified API for libsmbclient
Maintaining ABI compatibility for libsmbclient has become increasingly
difficult to accomplish, while also keeping the code organization such that it
is easily readable. Towards the goal of maintaining ABI compatibility and
-also keeping the code easy to maintain and enhance, the API has changed
-somewhat. In particular, the fields in the SMBCCTX context structure are no
-longer intended to be read/write by the user. The names of the fields have
-changed to encourage any recompilations to use the new interface, but for
-continued ABI compatibility, the fields are in the same locations in the
-context structure as they were previously so any previously-compiled
-applications should continue to work with this new version.
-
-An application that previously accessed the members of the SMBCCTX context
-structure will encounter errors if recompiled. This is intentional to
+also keeping the code easy to maintain and enhance, the API has been enhanced.
+In particular, the fields in the SMBCCTX context structure are no longer
+intended to be read/write by the user, and are marked as deprecated. An
+application that previously accessed the members of the SMBCCTX context
+structure will now encounter warnings if recompiled. This is intentional, to
encourage implementation of the small changes required for the new interface.
The number of changes is expected to be quite small for the vast majority of
applications, and no changes need be made for many applications. The changes
@@ -141,7 +136,7 @@ under these comment blocks:
Callable functions for directories
Callable functions applicable to both files and directories
-Example changes that may be required:
+Example changes that may be required to eliminate "deprecated" warnings:
/* Set the debug level */
context->debug = 99;