Merge branch 'fix/github-issues-v1.5.0'

Author: Thavarshan

README.MD

@@ -14,6 +14,15 @@
 **Example:**
 
 ```sh
+$ phpvm version
+phpvm version 1.5.0
+
+PHP Version Manager for macOS and Linux
+Author: Jerome Thayananthajothy <[email protected]>
+Repository: https://github.com/Thavarshan/phpvm
+
+Usage: phpvm help
+
 $ phpvm use 8.2
 Switching to PHP 8.2...
 Switched to PHP 8.2.
@@ -31,9 +40,13 @@ PHP 8.1.13
 - Install and manage multiple PHP versions.
 - Seamlessly switch between installed PHP versions.
 - Auto-switch PHP versions based on project `.phpvmrc`.
-- Supports macOS (via Homebrew) and Linux distributions.
+- Supports macOS (via Homebrew) and Linux distributions including WSL.
+- Enhanced cross-platform compatibility with improved shell support.
 - Works with common shells (`bash`, `zsh`).
+- Comprehensive version commands (`phpvm version`, `phpvm --version`, `phpvm -v`).
+- Post-install validation with helpful warnings for missing binaries.
 - Improved error handling with detailed messages and suggestions.
+- Enhanced Homebrew integration with better link failure detection.
 - Informative, color-coded feedback with timestamps for logs.
 - Includes unit tests with BATS for automated testing.
 - Helper functions for better maintainability and reduced code duplication.
@@ -72,6 +85,21 @@ If the installation was successful, it should output the path to `phpvm`.
 
 ## Usage
 
+### Available Commands
+
+| Command                   | Description                           |
+| ------------------------- | ------------------------------------- |
+| `phpvm install <version>` | Install a specific PHP version        |
+| `phpvm use <version>`     | Switch to a specific PHP version      |
+| `phpvm system`            | Switch to system/Homebrew default PHP |
+| `phpvm list`              | List all installed PHP versions       |
+| `phpvm auto`              | Auto-switch based on `.phpvmrc` file  |
+| `phpvm test`              | Run built-in self-tests               |
+| `phpvm version`           | Show version information              |
+| `phpvm --version`         | Show version information (alias)      |
+| `phpvm -v`                | Show version information (alias)      |
+| `phpvm help`              | Show help message                     |
+
 ### Installing PHP Versions
 
 To install a specific version of PHP:
@@ -88,7 +116,7 @@ To switch between installed versions:
 phpvm use 8.0
 ```
 
-To switch back to the system PHP version:
+To switch back to the system PHP version (Homebrew default on macOS):
 
 ```sh
 phpvm system
@@ -100,6 +128,18 @@ Verify the active version with:
 php -v
 ```
 
+### Version Information
+
+To check the phpvm version and get information:
+
+```sh
+phpvm version
+# or
+phpvm --version
+# or
+phpvm -v
+```
+
 ### Auto-Switching PHP Versions
 
 Create a `.phpvmrc` file in your project directory to specify the desired PHP version:
@@ -157,18 +197,24 @@ export PATH="$PHPVM_DIR/bin:$PATH"
 If you experience issues with `phpvm`, try the following:
 
 - Run `phpvm test` to verify all functions are working correctly
+- Check the phpvm version with `phpvm version` or `phpvm --version`
 - Ensure your shell profile is sourcing `phpvm.sh`
 - Restart your terminal after installing or updating
 - Verify that the required package manager is installed:
   - Homebrew for macOS
   - apt, dnf, yum, or pacman for Linux
 - Check for permission issues during the installation or PHP version switching process
 - For Linux systems, you may need to use `sudo` for installation and switching
+- On WSL systems, ensure you're using bash shell compatibility
+- If you encounter Homebrew link issues on macOS, try manually relinking: `brew unlink [email protected] && brew link --force [email protected]`
 - Refer to the [Changelog](./CHANGELOG.md) for recent updates and fixes
 
 ## Development & Testing
 
 - This project includes a set of BATS unit tests located in the repository (e.g., `test_phpvm.bats`).
+- v1.5.0 introduces significant cross-platform compatibility improvements, especially for WSL and Linux systems.
+- Enhanced error handling and validation with post-install checks for binary availability.
+- Improved Homebrew integration with better link failure detection and recovery.
 - Contributions, bug reports, and feature requests are welcome.
 - The codebase now includes helper functions for better maintainability and reduced duplication.