doc site cross references: call them pantsmark, pantsref instead of xmark, xref

<a xmark="foo"> looks like it could be some obscure HTML thing. Switch to <a pantsmark="foo"> which is more obviously a pants thing.

Testing Done:
https://travis-ci.org/pantsbuild/pants/builds/41306457

Reviewed at https://rbcommons.com/s/twitter/r/1348/
Use awk instead of sed to filter ever Nth line out of the integration test output The sed -n "K~N" syntax is not compatible with sed on MacOS.

Testing Done:
compared the list of integration tests listed when modifying the -i N:M parameters to the script.
Here is a good CI run https://travis-ci.org/pantsbuild/pants/builds/41359083

Bugs closed: 800

Reviewed at https://rbcommons.com/s/twitter/r/1350/
fix string formatting so 'test -h' does not crash

Testing Done:
PANTS_DEV=1 ./pants goal test -h

doesn't crash, unlike

./pants goal test -h

https://travis-ci.org/pantsbuild/pants/builds/41402745

Bugs closed: 805

Reviewed at https://rbcommons.com/s/twitter/r/1353/
Add dummy readme in examples/src/../scala/hello for Intellij plugin integration tests.

We added capability to the pants plugin to index non target owning files e.g. deploy scripts or READMEs
here https://rbcommons.com/s/twitter/r/1338/

We added the for the plugins.
Integration tests for Intllij plugin

Testing Done:
yes.
https://github.com/pantsbuild/pants/commit/d0fc5d05e8fae14311bab4cb7e664fa23fb02a8c

Reviewed at https://rbcommons.com/s/twitter/r/1356/
Support for the --kill-nailguns option was inadvertently removed, this puts it back.

The kill-nailguns flag was being read through old_options.cleanup_nailguns

Also updated the nailgun timeout logic to try and pinpoint transient errors in CI if it
happens again.

This reverts the change at https://rbcommons.com/s/twitter/r/1345/ which is redundant with this one (and not as effective.)

Testing Done:
CI Passed.

Bugs closed: 803

Reviewed at https://rbcommons.com/s/twitter/r/1352/
scala_specs: mention specs lib in the docstring; mention junit works, too

because not all Scala tests are scala_tests

Bugs closed: 622

Reviewed at https://rbcommons.com/s/twitter/r/1326/
Cache files created by (specially designed) annotation processors.

These annotation processors (so far, only twitter.common.args) write a file into META-INF which lists all of the files they created. Make pants process that file to decide which files should go in the artifact cache.

Testing Done:
Ran integration tests.

Bugs closed: 132

Reviewed at https://rbcommons.com/s/twitter/r/1250/
Revert "Cache files created by (specially designed) annotation processors."

This reverts commit e556eaa08f9c8e1be64a694d739283235d6989b0.

Apparently, this fails in CI for reasons I don't understand, so I'm
reverting it until I can figure it out.
doc: fix JVMProjects problems I didn't want to think about in rb/1176

Don't claim 'goal jar' is one of "The Usual Commands". It's kind of obscure and scary.

An extra "is" was in code font. Yeah, "is" is valid Python. But this wasn't Python, this was English.

Updated ivy mention: use new flags/config.

Tweaked nailgun description.

While I was in there: removed a section on getting help. It was redundant with
first_tutorial, except that it hadn't kept up to date :-(

Reviewed at https://rbcommons.com/s/twitter/r/1358/
doc: nailgun 5 seconds -> 10 seconds

Bugs closed: 804

Reviewed at https://rbcommons.com/s/twitter/r/1363/
Cache files created by (specially designed) annotation processors.

These annotation processors (so far, only twitter.common.args) write a file into META-INF which lists all of the files they created. Make pants process that file to decide which files should go in the artifact cache.

Testing Done:
Ran integration tests.

Bugs closed: 132

Reviewed at https://rbcommons.com/s/twitter/r/1250/
Get rid of some direct uses of config in jvm_compile.

These are now replaced with registered options.

Got rid of the javac_args config key, as it was basically the same as
--args, except that pants added the -C escapes for you. This was confusing and
inconsistent anyway.

Created --source and --target options, and removed a random reference
to the old way of specifying those from test_rcfile.py, to avoid confusion
(even though the test still passed).

Testing Done:
All relevant unit and integration tests pass.

CI baking.

Reviewed at https://rbcommons.com/s/twitter/r/1357/