Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

first_tutorial.txt: targets no longer end in BUILD #3

Closed
wants to merge 1 commit into from
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions _sources/first_tutorial.txt
Original file line number Diff line number Diff line change
Expand Up @@ -19,9 +19,9 @@ Now you're ready to invoke pants for more useful things.

You invoke pants with *goals* (like ``test`` or ``bundle``) and the
*build targets* to use (like
``tests/java/com/pants/examples/hello/greet/BUILD:greet``). For example, ::
``tests/java/com/pants/examples/hello/greet:greet``). For example, ::

./pants goal test tests/java/com/pants/examples/hello/greet/BUILD:greet
./pants goal test tests/java/com/pants/examples/hello/greet:greet

Goals (the "verbs" of Pants) produce new files from Targets (the "nouns").

Expand All @@ -40,7 +40,7 @@ Pants knows about goals ("verbs" like ``bundle`` and ``test``) and targets
(build-able things in your source code). A typical pants command-line
invocation looks like ::

./pants goal test tests/java/com/pants/examples/hello/greet/BUILD:greet
./pants goal test tests/java/com/pants/examples/hello/greet:greet

Looking at the pieces of this we see

Expand Down Expand Up @@ -73,7 +73,7 @@ Looking at the pieces of this we see
You can specify more than one goal on a command line. E.g., to generate an
Eclipse project *and* run tests, we could have said ``eclipse tests``.

``tests/java/com/pants/examples/hello/greet/BUILD:greet``
``tests/java/com/pants/examples/hello/greet:greet``
This is a *build target*, a "build-able" thing in your source code. To define
these, you set up configuration files named ``BUILD`` in your source code file
tree. (You'll see more about these later.)
Expand Down Expand Up @@ -182,7 +182,7 @@ To build a runnable Java binary, we need to first compile its dependencies.
The ``main-bin`` binary has two dependencies,
``pants('src/java/com/pants/examples/hello/greet')``
is the *address* of another target. Addresses look,
roughly, like ``path/to/BUILD:targetname``.
roughly, like ``path/to/directory:targetname``.
We can see this build target in the ``.../hello/greet/BUILD`` file:

.. literalinclude:: ../../../java/com/pants/examples/hello/greet/BUILD
Expand Down