You can not select more than 25 topics Topics must start with a chinese character,a letter or number, can include dashes ('-') and can be up to 35 characters long.

index.html 2.6 kB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051
  1. <html>
  2. <head>
  3. <title>BuildTool Readme</title>
  4. <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
  5. </head>
  6. <body bgcolor="#FFFFFF">
  7. <h1>BuildTool</h1>
  8. <p>BuildTool is a Java based build tool. In theory it is kind of like make without
  9. makes wrinkles.</p>
  10. <h2>Why?</h2>
  11. <p>Why another build tool when there is already make, gnumake, nmake, jam, and
  12. others? Because all of those tools have limitations that its original author
  13. couldn't live with when developming software across multiple platforms. Make
  14. like tools are inherently shell based. They evaluate a set of dependencies and
  15. then execute commands not unlike what you would issue on a shell. This means
  16. that you can easily extend these tools by using or writing any program for the
  17. OS that you are working on. However, this also means that you limit yourself
  18. to the OS, or at least the OS type such as Unix, that you are working on.</p>
  19. <p>Makefiles are inherently evil as well. Anybody who has worked on them for any
  20. time has run into the dreaded tab problem. &quot;Is my command not executing
  21. because I have a space in front of my tab!!!&quot; said the original author
  22. of BuildTool way too many times. Tools like Jam took care of this to a great
  23. degree, but still use yet another format to use and remember.</p>
  24. <p>BuildTool is different. Instead a model where it is extended with shell based
  25. commands, it is extended using Java classes. Instead of writing shell commands,
  26. the configuration files are XML based calling out a target tree where various
  27. tasks get executed. Each task is run by an object which implments a particular
  28. Task interface. </p>
  29. <p>Granted, this removes some of the expressive power that is inherent by being
  30. able to construct a shell command such as `find . -name foo -exec rm {}` but
  31. it gives you the ability to be cross platform. To work anywhere and everywhere.And
  32. hey, if you really need to execute a shell command, BuildTool has an exec rule
  33. that allows different commands to be executed based on the OS that it is executing
  34. on. </p>
  35. <h2>How?</h2>
  36. <p>To get started using BuildTool check out the following topics:</p>
  37. <ul>
  38. <li>Installing BuildTool</li>
  39. <li>Writing a simple BuildFile</li>
  40. <li>Built in Tasks</li>
  41. <li>Writing a new Task</li>
  42. <li>API Documentation</li>
  43. </ul>
  44. <h2>License</h2>
  45. <h2>Feedback</h2>
  46. <p>To provide feedback on this software, please send mail to <a href="mailto:duncan@x180.com">duncan@x180.com</a>.</p>
  47. <hr>
  48. <p>Java is a trademark of Sun Microsystems.</p>
  49. </body>
  50. </html>