aboutsummaryrefslogtreecommitdiffhomepage
path: root/docs/known-incompatibilities.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/known-incompatibilities.md')
-rw-r--r--docs/known-incompatibilities.md23
1 files changed, 17 insertions, 6 deletions
diff --git a/docs/known-incompatibilities.md b/docs/known-incompatibilities.md
index e8e6a038..79ead94c 100644
--- a/docs/known-incompatibilities.md
+++ b/docs/known-incompatibilities.md
@@ -3,12 +3,6 @@
NOTE: This is not an exhaustive list. Shirabe is in early development and there are still a number of significant incompatibilities with Composer that are not documented here yet.
-## Error Messages
-
-Error messages, in particular those from PHP built-in functions, are not intended to be mapped exactly.
-Plugins or external tools that rely on error messages may break.
-
-
## Default Home/Cache/Data Directories
To avoid conflicting with an existing Composer installation, Shirabe's default system directories
@@ -32,6 +26,23 @@ The following are intentionally left unchanged for ecosystem compatibility:
TODO: a CLI flag or an environment variable to force Shirabe to use compatible paths.
+## Error Messages
+
+Error messages, in particular those from PHP built-in functions, are not
+intended to be mapped exactly. Plugins or external tools that rely on error
+messages may break.
+
+
+## Version Reporting
+
+Shirabe has its own version, separate from the Composer version it is ported
+from. `shirabe --version`, `shirabe about` and `shirabe diagnose` report the
+Shirabe version and show the Composer version alongside it.
+
+The pseudo-package `composer` and `composer-runtime-api` keep the original
+Composer version in order not to break the version resolution.
+
+
## Xdebug
Composer disables Xdebug on startup. Shirabe emulates it, but the exact