MySQL Bugs: #59161: connector c++ - packages and download page

Bug #59161	connector c++ - packages and download page
Submitted:	24 Dec 2010 16:37	Modified:	24 Dec 2010 19:02
Reporter:	Santo Leto	Email Updates:
Status:	Verified	Impact on me:	None
Category:	Connector / C++	Severity:	S3 (Non-critical)
Version:	1.1.0	OS:	Windows
Assigned to:		CPU Architecture:	Any
Tags:	connector_cpp, Download, intuitiveness, packages, usability

Description:
In the download page of the Connector C++ (but a similar speech can be done for the download page of the connector C) there are several packages and it's not that easy to understand the differences between them.

Let's consider for example 32-bit versions.

We have the Installer:

mysql-connector-c++-1.1.0-win32.msi

and three zip archives:

mysql-connector-c++-1.1.0.zip (the connector source)				
mysql-connector-c++-noinstall-1.1.0-win32.zip
mysql-connector-c++-noinstall-1.1.0-win32-vs2005.zip

1) it's not intuitive to understand that mysql-connector-c++-1.1.0.zip is the archive that contains the source code (what about adding a src suffix? Bug #59160).

2) what are the differences between mysql-connector-c++-noinstall-1.1.0-win32.zip and mysql-connector-c++-noinstall-1.1.0-win32-vs2005.zip? if I'm not wrong the documentation is not updated on this point.		

3) what about adding a small sentence which describe the packages in the download table of the website? (this could be useful in general for all tools and downloads, to increase intuitiveness and help new users which are going to download some tools for the first time).

How to repeat:
-

Suggested fix:
See above.

Thank you for the problem report.

Thanks for the hint on the format of the download pages. The download pages somewhat follow the standard MySQL templates.

There's pretty exhaustive information on VS version stuff at http://forge.mysql.com/wiki/Connector_C%2B%2B and http://forge.mysql.com/wiki/Connector_C%2B%2B_Binary_Builds . That's also noted at http://dev.mysql.com/doc/refman/5.1/en/connector-cpp-installation-binary.html .

I think the requested information is given although "tools" != "Visual Studio". And that's because we really mean tools in order to make cleat that its relevant not only for Windows.

http://dev.mysql.com/downloads/connector/cpp/

All distributions of Connector/C++ contain a README file, which contains platform-specific notes. At the end of the README file contained in the binary distribution you will find the settings used to build the binaries. If you experience build-related issues on a platform, it may help to check the settings used on the platform to build the binary.

A better solution is to build your MySQL Connector/C++ libraries from the source code, using the same tools that you use for building your application. This ensures compatibility.

One problem that can occur is when the tools you use to build your application are not compatible with the tools used to build the binary versions of MySQL Connector/C++. Ideally, you need to build your application with the same tools that were used to build the MySQL Connector/C++ binaries.

Posted by developer:
 
Package names have been updated in never versions. On Windows they look now like this:

mysql-connector-c++-noinstall-1.1.7-win32.{zip,msi}
mysql-connector-c++-noinstall-1.1.7-winx64.{zip,msi}

There are no VS-specific packages any more. The only remaining concern is no -src suffix for source packages. I will check if there are any obstacles to changing this.