doc: update install instructions

Author: bimalkjha

INSTALL.md

@@ -57,28 +57,35 @@ pip install git+https://git@github.com/ibmdb/python-ibmdb.git
 - For other pre-requisite and non-wheel installation, please check [here](https://github.com/ibmdb/python-ibmdb?tab=readme-ov-file#installation).
 
 **Note:**
-When we install ibm_db package on Linux, MacOS and Windows, `pip install ibm_db` command install
-prebuilt Wheel package that includes clidriver too and ignores `IBM_DB_HOME` or `IBM_DB_INSTALLER_URL`
-environment variables if set. Also, auto downloading of clidriver does not happen as clidriver is
-already present inside wheel package.
 
-To inforce auto downloading of clidriver or to make setting of environment variable `IBM_DB_HOME`
-effective, install ibm_db from source distribution using below command:
+- When we install ibm_db package on Linux, MacOS and Windows, `pip install ibm_db` command install prebuilt Wheel package that includes clidriver too and ignores `IBM_DB_HOME` or `IBM_DB_INSTALLER_URL` environment variables if set. Also, auto downloading of clidriver does not happen as clidriver is already present inside wheel package.
+
+- If `db2cli validate` command works in your system and installed db2 client/server
+  has `include` directory, ibm_db installation from souce distribution will not download clidriver, but it will use the existing client/server from the system. But, installation using wheel image will not use existing clidriver.
+
+- To inforce auto downloading of clidriver _OR_ to make setting of environment variable `IBM_DB_HOME` or `IBM_DB_INSTALLER_URL` or `CLIDRIVER_VERSION` effective; install ibm_db from source distribution using below command:
 
 ```
 pip install ibm_db --no-binary :all: --no-cache-dir
 ```
 
-If you have to use your own URL for clidriver.tar.gz/.zip please set environment variable
+- If you have to use your own URL for clidriver.tar.gz/.zip please set environment variable
 
 ```
 IBM_DB_INSTALLER_URL=full_path_of_clidriver.tar.gz/.zip
+pip install ibm_db --no-binary :all: --no-cache-dir
 ```
 
-When ibm_db get installed from wheel package, you can find clidriver under site_packages directory
-of Python. You need to copy license file under `site_packages/clidriver/license` to be effective, if any.
+- To install using specific version of clidriver from https://public.dhe.ibm.com/ibmdl/export/pub/software/data/db2/drivers/odbc_cli/:
 
-**Note:** For windows after installing ibm_db, recieves the below error when we try to import ibm_db :
+```
+export CLIDRIVER_VERSION=v11.5.9
+pip install ibm_db --no-binary :all: --no-cache-dir
+```
+
+- When ibm_db get installed from wheel package, you can find clidriver under site_packages directory of Python. You need to copy license file under `site_packages/clidriver/license` to be effective, if any.
+
+**Note:** For windows after installing `ibm_db`, recieves the below error when we try to import ibm_db :
 
 ```>python
 Python 3.11.4 (tags/v3.11.4:d2340ef, Jun  7 2023, 05:45:37) [MSC v.1934 64 bit (AMD64)] on win32
@@ -106,9 +113,13 @@ Refer https://bugs.python.org/issue36085 for more details.
 
 #### 1.2 Manual Installation
 
+Make sure you have Python, pip and git installed in your system.
+
 ```
+python -m pip --version => Make sure it works, else install pip first.
 git clone https://github.com/ibmdb/python-ibmdb/
 cd python-ibmdb
+python -m pip install -U pip setuptools wheel build
 python -m build
 pip install dist/ibm_db-3.2.8-cp313-cp313-win_amd64.whl
 pip list
@@ -122,6 +133,7 @@ pip list
 ```
 git clone https://github.com/ibmdb/python-ibmdb/
 cd python-ibmdb
+python -m pip install -U pip setuptools wheel build
 python setup.py bdist_egg => It generates egg file under dist directory.
 python setup.py install
 pip list
@@ -140,6 +152,7 @@ To install ibm_db as python wheel, use below commands(recommended):
 ```
 git clone https://github.com/ibmdb/python-ibmdb/
 cd python-ibmdb
+python -m pip install -U pip setuptools wheel build
 python -m build  => Note down the path of generated *.whl file to use below
 pip install dist/ibm_db-3.2.8-cp313-cp313-win_amd64.whl
 pip list  => You can see ibm_db in the output
@@ -466,7 +479,7 @@ These APIs ensure consistent and reliable error handling across all supported en
 
 ### Installation:
 
-    Follow same steps as documented for [ibm_db Installation on Linux, AIX, zLinux, Widnows and MacOS.](#inslnx)
+Follow same steps as documented for [ibm_db Installation on Linux, AIX, zLinux, Widnows and MacOS.](#inslnx)
 
 ## <a name="troubleshooting"></a> 4. Troubleshooting Post Install Errors on MacOS
 

README.md

@@ -46,11 +46,13 @@ If you face problems due to missing python header files while installing the dri
      or
     yum install python-devel
 ```
+
 If you have installed `DB2_RTC*` i.e. **DB2 Runtime Client** and want `ibm_db` to use it instead of clidriver, please read [this comment](https://github.com/ibmdb/python-ibmdb/issues/1023#issuecomment-3062805368) and take action.
 
 - clidriver v12.1 on Linux uses x86_64_v2 instruction set which is not supported by cibuildwheel and wheel image creation [fails](https://github.com/pypa/manylinux/issues/1725) using v12.1 clidriver. So, default version of clidriver on Linux platform is v11.5.9 only.
 
 - You can force installation of ibm_db on Linux with clidriver v12.1 using below commands:
+
 ```
 export CLIDRIVER_VERSION=v12.1.0
 pip install ibm_db --no-binary :all: --no-cache-dir
@@ -86,22 +88,14 @@ pip install ibm_db
 
 This will install ibm_db and ibm_db_dbi module.
 
-- When we install ibm_db package on Linux, MacOS and Windows, `pip install ibm_db` command install
-  prebuilt Wheel package that includes clidriver too and ignores `IBM_DB_HOME` or `IBM_DB_INSTALLER_URL`
-  or `CLIDRIVER_VERSION` environment variables if set. Also, auto downloading of clidriver does not happen
-  as clidriver is already present inside wheel package.
+- When we install ibm_db package on Linux, MacOS and Windows, `pip install ibm_db` command install prebuilt Wheel package that includes clidriver too and ignores `IBM_DB_HOME` or `IBM_DB_INSTALLER_URL` or `CLIDRIVER_VERSION` environment variables if set. Also, auto downloading of clidriver does not happen as clidriver is already present inside wheel package.
 
-- For platforms not supported by python-wheel, ibm_db will get installed from souce distribution.
-  GCC compiler is required on non-windows platform and VC++ compiler on Windows platform to
-  install `ibm_db` from souce distribution.
+- For platforms not supported by python-wheel, ibm_db will get installed from souce distribution, GCC compiler is required on non-windows platform and VC++ compiler on Windows platform to install `ibm_db` from souce distribution.
 
 - If `db2cli validate` command works in your system and installed db2 client/server
-  has `include` directory, ibm_db installation from souce distribution will not download clidriver, but
-  it will use the existing client/server from the system.
+  has `include` directory, ibm_db installation from souce distribution will not download clidriver, but it will use the existing client/server from the system.
 
-- To inforce auto downloading of clidriver _OR_ to make setting of environment variable `IBM_DB_HOME` or
-  `IBM_DB_INSTALLER_URL` or `CLIDRIVER_VERSION` effective; install ibm_db from source distribution
-  using below command:
+- To inforce auto downloading of clidriver _OR_ to make setting of environment variable `IBM_DB_HOME` or `IBM_DB_INSTALLER_URL` or `CLIDRIVER_VERSION` effective; install ibm_db from source distribution usin below command:
 
 ```
 pip install ibm_db --no-binary :all: --no-cache-dir
@@ -123,8 +117,7 @@ pip install ibm_db --no-binary :all: --no-cache-dir
 
 - ibm_db will override value of CLIDRIVER_VERSION to v12.1.0 for MacARM64 and to v11.5.9 for Macx64 platform.
 
-- When ibm_db get installed from wheel package, you can find clidriver under site_packages directory
-  of Python. You need to copy license file under `site_packages/clidriver/license` to be effective, if any.
+- When ibm_db get installed from wheel package, you can find clidriver under site_packages directory of Python. You need to copy license file under `site_packages/clidriver/license` to be effective, if any.
 
 **Note:** For windows after installing ibm_db, recieves the below error when we try to import ibm_db :
 
@@ -532,7 +525,6 @@ If you intend to install the clidriver manually, Following are the details of th
 |          |    sparc     |   sun64_odbc_cli.tar.gz   |    Yes    |    V11.1     |
 |          |    sparc     |   sun32_odbc_cli.tar.gz   |    Yes    |    V11.1     |
 
-
 <a name='downloads'></a>
 
 ## Downloads