Skip to content

Commit

Permalink
Rename README to README.md and changed its systax to Markdown
Browse files Browse the repository at this point in the history
  • Loading branch information
stgeneral committed Feb 27, 2012
1 parent d4ed3ac commit 19a4f0e
Showing 1 changed file with 20 additions and 19 deletions.
39 changes: 20 additions & 19 deletions README → README.md
@@ -1,25 +1,24 @@
_________________________
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
development team could not live with when developing software across
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
Expand All @@ -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 <exec>
everywhere. And if you really need to execute a shell command, Phing has an `<exec>`
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
<http://phing.info/>.

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.
Expand Down

0 comments on commit 19a4f0e

Please sign in to comment.