Update README (switch to Markdown too).

This commit is contained in:
Stan Angeloff 2012-06-01 10:50:53 +03:00
parent eae050302e
commit c9ff5be35c
2 changed files with 52 additions and 3 deletions

3
README
View file

@ -1,3 +0,0 @@
This is a mirror of http://www.vim.org/scripts/script.php?script_id=2874
This is an updated version of the php.vim syntax file distributed with VIM. The list of PHP constants, functions, and classes was updated to be current with PHP 5.3. Many new classes were added in the 5.2 branch and the distributed version only covers up to 5.1.4. In addition I simplified the file, removing several sections that are not often used (at least by me) such as automatic folding of all control structures and ASP tags support. I also removed several switches designed for b/c with VIM 5.X and 6.X. As an addition I have included the PHP file I used to generate the constant, function, class list. It uses reflection to mine out these items from your PHP installation and generate part of the php.vim script. Before running open up the file and adjust the output file location and the list of extensions to generate syntax for. Then run "php php_vimgen.php" from your shell.

52
README.md Normal file
View file

@ -0,0 +1,52 @@
php.vim
=======
This project is a fork of [php.vim--Garvin][garvin] which in turn is an update
of the [php.vim][php-vim] script which in turn is an updated version of the
php.vim syntax file distributed with Vim. Whew!
[garvin]: https://github.com/vim-scripts/php.vim--Garvin
[php-vim]: http://www.vim.org/scripts/script.php?script_id=2874
Improvements
------------
- Spell checking was enabled in strings and comments (both single and
multi-line).
- Spell checking was enabled in heredocs, e.g., `<<<EOD`.
- The PHP built-in and extension-provided functions list was updated for
PHP 5.3.
- Compatibility with [html5.vim][html5].
- Support for not-so-common extensions was turned off, e.g., `mssql_*`.
- Basic support for PHP 5.4 syntax was added.
[html5]: https://github.com/othree/html5.vim
Customising
-----------
A script `update_syntax.php` is provided to re-generate the syntax file.
A single variable `$allowed_extensions` can be customised to
[turn on/off][defaults] certain extensions.
When re-generating the syntax file, you must have allowed extensions installed.
[defaults]: https://github.com/StanAngeloff/php.vim/blob/master/update_syntax.php#L29-L101
### Original README
> This is an updated version of the php.vim syntax file distributed with VIM.
> The list of PHP constants, functions, and classes was updated to be current
> with PHP 5.3. Many new classes were added in the 5.2 branch and the
> distributed version only covers up to 5.1.4. In addition I simplified the
> file, removing several sections that are not often used (at least by me) such
> as automatic folding of all control structures and ASP tags support. I also
> removed several switches designed for b/c with VIM 5.X and 6.X. As an
> addition I have included the PHP file I used to generate the constant,
> function, class list. It uses reflection to mine out these items from your
> PHP installation and generate part of the php.vim script. Before running open
> up the file and adjust the output file location and the list of extensions to
> generate syntax for. Then run "php php_vimgen.php" from your shell.