Added examples

Author: sergeyklay

README.md

@@ -56,6 +56,17 @@ extension=zephir_parser.so
 
 Finally, restart the web server.
 
+## Usage
+
+```php
+$path   = __DIR__ . '/test.zep';
+$retval = zephir_parse_file(file_get_contents($path), $path);
+
+echo PHP_EOL;
+var_export($retval);
+echo PHP_EOL;
+```
+
 ## License
 
 Zephir Parser is open source software licensed under the MIT License. See the LICENSE file for more

ide/zephir_parser.php

@@ -0,0 +1,29 @@
+<?php
+
+/*
+ +--------------------------------------------------------------------------+
+ | Zephir Parser                                                            |
+ +--------------------------------------------------------------------------+
+ | Copyright (c) 2013-2017 Zephir Team and contributors                     |
+ +--------------------------------------------------------------------------+
+ | This source file is subject the MIT license, that is bundled with        |
+ | this package in the file LICENSE, and is available through the           |
+ | world-wide-web at the following url:                                     |
+ | https://zephir-lang.com/license.html                                     |
+ |                                                                          |
+ | If you did not receive a copy of the MIT license and are unable          |
+ | to obtain it through the world-wide-web, please send a note to           |
+ | license@zephir-lang.com so we can mail you a copy immediately.           |
+ +--------------------------------------------------------------------------+
+*/
+
+/**
+ * Parses a file and returning an intermediate array representation.
+ *
+ * @param string $content
+ * @param string $filepath
+ * @return array
+ */
+function zephir_parse_file($content, $filepath)
+{
+}

parser/base.c

@@ -70,7 +70,7 @@ static void xx_parse_with_token(void* xx_parser, int opcode, int parsercode, xx_
 }
 
 /**
- * Parses a comment returning an intermediate array representation
+ * Parses a programm and returning an intermediate array representation
  */
 void xx_parse_program(zval *return_value, char *program, size_t program_length, char *file_path, zval **error_msg) {
 

zephir_parser.c

@@ -28,8 +28,8 @@
 
 extern void *xx_parse_program(zval *return_value, char *program, size_t program_length, char *file_path, zval **error_msg);
 
-/* {{{ proto string zephir_parse_file(string arg)
-   Return a string to confirm that the module is compiled in */
+/* {{{ proto array zephir_parse_file(string content, string filepath)
+   Parses a file and returning an intermediate array representation */
 PHP_FUNCTION(zephir_parse_file)
 {
 	size_t filepath_len = 0;