Details
-
Bug
-
Status: Closed
-
Major
-
Resolution: Fixed
-
None
-
None
-
Windows XP
Description
The following issues were found in the "Installation Guide" under the heading "Installing and Running on Microsoft Windows (win32)"
=======================================================================================================
1. In the Axis2-C Installation Guide, under the heading "2. Installing and Running on Microsoft Windows (win32)" it asks the user to download libxml but it does not say which version to download. When you go to the relevant site, you can see several versions of libxml. E.g. - LATEST_LIBXML2, LATEST_LIBXML2_IS_2.6.27, LATEST_LIBXSLT, LATEST_LIBXSLT_IS_1.1.20. Therefore, it should clearly state which version to download
2. In the Axis2-C Installation Guide under the heading "Using Binary Release" it says that you can download "Microsoft VSExpress2005" edition from the Microsoft Web site. It's better if you can give the site here. (It's true that you can google it and find out but it's good if you can specify the correct link to download Microsoft VSExpress2005. E.g.:- Specify the correct download page)
3. In the Axis2-C Installation Guide, no paths are specified as to where you can download the latest source and binary distributions. Appropriate links should be given in the relevant places
E.g.:- Specify the axis2 download page - http://ws.apache.org/axis2/c/download.cgi
4. The path where the "configure.in" is located is not given (2. 2. Using The Source Release > 2.2.3. Editing configure.in File). When you search for the particular file, it gives 4 instances. Therefore, the document should clearly specify, which file the user should refer.
5. Under the heading "2.2.4. Compiling The Source" it asks the user to run the "vcvars32.bat" file but no such file exists in the source distribution (Assuming that it is in the source distribution). But the problem is I cannot find the "vcvars32.bat" file. Then I realised that this file resides in the VS installation folder. E.g.:- C:\Program Files\Microsoft Visual Studio 8\VC\bin. This is confusing to the user.
The correct path of the "vcvars32.bat" have to be specified clearly.
6. The document states "build the system and create a directory named deploy under build directory:"
What I understand by this is that you have to build the source first and then have to create a folder called deploy. What it should mean is that when you build the source, a folder named "deploy" will be created. Please rephrase this.
7. Under the heading "2. 2. Using The Source Release", first is asks the user to edit the "configure.in" file which is inside the source distribution and then as the next step it asks the user to extract the source distribution to a folder of choice, etc. How can you edit the file which is inside the source distribution without extracting it first? Therefore first it should ask the user to extract the source and then only it should ask the user to edit the particular file. Please rephrase.
8. Minor Issue - Under the heading "2.2.3. Editing configure.in File", it says that the default location for libxml2 is "C:\libxml2" but when you check the file you will see that the path specified in the file is "E:\libxml2-2.6.23.win32". This might be a bit confusing to the user. Therefore, the document should be replaced with the correct path.
9. Under the heading "2.2.3. Editing configure.in File" it should also state that the paths for iconv and zlib1 should also be replaced with the correct paths.