Integrate test documentation and remove t/ directory

- Integrated information from t/README.md into docs/TESTING.md
- Added section on 'Importing Perl5 Test Suite' with setup instructions
- Removed t/ directory and its tracked files (t/README.md, t/test.pl)
- Updated .gitignore to remove obsolete t/ directory entries
- Testing section in README.md already up-to-date

The t/ directory was a placeholder for imported Perl5 tests. The import
process and instructions are now documented in docs/TESTING.md.

Author: fglock

.gitignore

@@ -25,13 +25,6 @@ src/test/_Deparsed_XSubs.pm
 # Ignore Perl test suite files
 perl5/
 
-# Ignore the t/ directory (Perl test suite copied from perl5/t/)
-# These should be synced from perl5 repo, not committed here
-t/
-# But keep our own t/README.md documentation
-!t/README.md
-!t/test.pl
-
 # Ignore perl5_t/ directory (module tests from perl5/lib/*.t)
 # These are synced from perl5 repo via sync.pl, not committed here
 perl5_t/

docs/TESTING.md

@@ -284,6 +284,40 @@ Check for infinite loops, use timeout command:
 timeout 30s ./jperl problematic_test.t
 ```
 
+## Importing Perl5 Test Suite
+
+PerlOnJava can import and run tests from the official Perl5 repository to verify compatibility and behavior.
+
+### Setup
+
+To import Perl test files and verify their behavior under PerlOnJava:
+
+1. Clone the Perl5 repository (if not already done):
+   ```bash
+   rm -rf perl5  # if it exists
+   git clone https://github.com/Perl/perl5.git
+   ```
+
+2. Run the import script to copy tests and apply patches:
+   ```bash
+   perl dev/import-perl5/sync.pl
+   ```
+
+This will copy all files from `perl5/t/` to `t/` and apply any necessary patches for PerlOnJava compatibility.
+
+### Running Imported Tests
+
+To run the imported Perl5 tests:
+
+```bash
+perl dev/tools/perl_test_runner.pl --output out.json t
+```
+
+See `dev/import-perl5/README.md` for more details on:
+- The import system architecture
+- How to add patches for PerlOnJava compatibility
+- Managing test expectations
+
 ## See Also
 
 - [Build Guide](BUILD.md) - Building PerlOnJava