axis-c-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Evanthika Amarasiri (JIRA)" <j...@apache.org>
Subject [jira] Created: (AXIS2C-564) Issues in the Axis2-C Installation Guide - Installing and Running on Microsoft Windows (win32)
Date Mon, 26 Mar 2007 11:10:32 GMT
Issues in the Axis2-C Installation Guide - Installing and Running on Microsoft Windows (win32)
----------------------------------------------------------------------------------------------

                 Key: AXIS2C-564
                 URL: https://issues.apache.org/jira/browse/AXIS2C-564
             Project: Axis2-C
          Issue Type: Bug
          Components: documentation
         Environment: Windows XP
            Reporter: Evanthika Amarasiri


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.


-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


---------------------------------------------------------------------
To unsubscribe, e-mail: axis-c-dev-unsubscribe@ws.apache.org
For additional commands, e-mail: axis-c-dev-help@ws.apache.org


Mime
View raw message