feat: better linking, document samples

Author: schuhwerk

php-error-log-viewer.php

@@ -143,8 +143,7 @@ public function parse( $raw ) {
 	}
 
 	public function link_vscode_files( $string ) {
-		$string = preg_replace_callback( ' $([A-Z]:)?([\\\/][^:()]+)[:\(]([0-9]+)\)?$', array( $this, 'vscode_link_filter' ), $string );
-		$string = preg_replace_callback( ' $([A-Z]:)?([\\\/][^:()]+) on line ([0-9]+)\)?$', array( $this, 'vscode_link_filter' ), $string );
+		$string = preg_replace_callback( '$([A-Z]:)?([\\\/][^:(\s]+)(?: on line |[:\(])([0-9]+)\)?$', array( $this, 'vscode_link_filter' ), $string );
 		return $string;
 	}
 
@@ -175,7 +174,7 @@ public function replace_callback( $arr ) {
 			$this->content[ $err_id ]        = array();
 			$this->content[ $err_id ]['id']  = $err_id; // err_id.
 			$this->content[ $err_id ]['cnt'] = 1; // counter.
-			$this->index[] = $err_id;
+			$this->index[]                   = $err_id;
 		} else { // we already have that error...
 			$this->content[ $err_id ]['cnt']++; // counter.
 		}

readme.md

@@ -44,3 +44,12 @@ vscode_path_search='/srv/www/current/'
 ;
 vscode_path_replace='C:/my-repository/'
 ```
+
+## Linking
+The log viewer extracts paths and line numbers from your log file (transforms them) and creates vscode links.
+It works for the following samples:
+
+- <mark>/srv/www/web/app/themes/defaultspace/functions.php(605)</mark>: get_post_card(Object(WP_Post), Array)
+- PHP Fatal error:  Uncaught TypeError: ..., called in <mark>C:\foo\bar/themes/defaultspace/functions.php on line 605</mark> 
+- ... and defined in <mark>C:\foo\bar/themes/defaultspace/functions.php:63</mark>
+