From 19a4f0e4941b82cc74462c9bbd6729f4096d7edb Mon Sep 17 00:00:00 2001 From: Dmitry Babenko Date: Mon, 27 Feb 2012 17:54:05 +0200 Subject: [PATCH] Rename README to README.md and changed its systax to Markdown --- README => README.md | 39 ++++++++++++++++++++------------------- 1 file changed, 20 insertions(+), 19 deletions(-) rename README => README.md (89%) diff --git a/README b/README.md similarity index 89% rename from README rename to README.md index c70da3221c..dbc9a1d5e4 100644 --- a/README +++ b/README.md @@ -1,17 +1,16 @@ - _________________________ - P H I N G +P H I N G +========================= - - What is it? - ----------- +What is it? +----------- Phing is a PHP based build tool. In theory it is kind of like "make" without makes drawbacks and with the full portability and performance of PHP. (PH)pmake (I)s (N)ot (G)numake - - Why? - ---- + +Why? +---- Why another build tool when there is already make, gnumake, nmake, jam, ant, and others? Because all those tools have limitations that the binarycloud @@ -19,7 +18,7 @@ different platforms. Make-like tools are inherently shell-based: they evaluate a set of dependencies, then execute commands not unlike what you would issue on a shell. - + This means that you can easily extend these tools by using or writing any program for the OS that you are working on; however, this also means that you limit yourself to the OS, or at least the OS type, such as Unix, that @@ -42,32 +41,34 @@ commands, the configuration files are XML-based, calling a target tree where various tasks get executed. Each task is run by an object that implements a particular Task action. - + Of course, this removes some of the expressive power that is inherent in being able to construct a shell command such as + % `find . -name foo -exec rm {}` + but it gives you the ability to be cross-platform - to work anywhere and - everywhere. And if you really need to execute a shell command, Phing has an + everywhere. And if you really need to execute a shell command, Phing has an `` task that allows different commands to be executed based on the operating system it is executing on. - The Latest Version - ------------------ +The Latest Version +------------------ Details of the latest version can be found on the Phing homepage . - Documentation - ------------- +Documentation +------------- - Documentation is available in XHTML format in the docs/ directory. In particular, - open the docs/phing_guide/book/index.html in a frames-compatible browser to see the + Documentation is available in XHTML format in the docs/ directory. In particular, + open the docs/phing_guide/book/index.html in a frames-compatible browser to see the phing user guide. For online documentation, you can also visit the Phing website: http://phing.info/ - Licensing - --------- +Licensing +--------- This software is licensed under the terms you may find in the file named "LICENSE" in this directory.