Buck: Remove non working local_jar rule and documentation

Since: [1] local_jar() is broken and cannot be fixed. It was always
a hack that relied on the ability to define two different targets
with the same output artifact name.

* [1] https://github.com/facebook/buck/commit/c92ef212b53fff08a8452649b4d4faadc6b89b11

Change-Id: I5801d71092763bdcee1c07e35aafa5e0d6ca9e39

local_jar.bucklet

diff --git a/local_jar.bucklet b/local_jar.bucklet
deleted file mode 100644
index a7bd35b..0000000
--- a/local_jar.bucklet
+++ /dev/null
@@ -1,64 +0,0 @@
-# Copyright (C) 2013 The Android Open Source Project
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-# http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-#
-# If a dependent library is undergoing active development it must be
-# recompiled and the change must be reflected in the Buck build process. For
-# example testing Gerrit against changed JGit snapshot version. After building
-# JGit library, the artifacts are created in local Maven build directory.
-#
-# To shorten that workflow and take the installation of the artifacts to the
-# local Maven repository and fetching it again from there out of the picture,
-# `local_jar()` method is used:
-#
-# Example:
-#
-# local_jar(
-#   name = 'jgit',
-#   jar = '/home/<user>/projects/jgit/org.eclipse.jgit/target/org.eclipse.jgit-3.3.0-SNAPSHOT.jar',
-#   src_jar = '/home/<user>/projects/jgit/org.eclipse.jgit/target/org.eclipse.jgit-3.3.0-SNAPSHOT-sources.jar',
-#   deps = [':ewah']
-# )
-#
-def local_jar(
-    name,
-    jar,
-    src_jar = None,
-    deps = [],
-    visibility = ['PUBLIC']):
-  binjar = name + '.jar'
-  srcjar = name + '-src.jar'
-  genrule(
-    name = name + '__local_bin',
-    cmd = 'ln -s %s $OUT' % jar,
-    out = binjar)
-  if src_jar:
-    genrule(
-      name = name + '__local_src',
-      cmd = 'ln -s %s $OUT' % src_jar,
-      out = srcjar)
-    prebuilt_jar(
-      name = name + '_src',
-      binary_jar = ':' + name + '__local_src',
-      visibility = visibility,
-    )
-  else:
-    srcjar = None
-
-  prebuilt_jar(
-    name = name,
-    deps = deps,
-    binary_jar = ':' + name + '__local_bin',
-    source_jar = ':' + name + '__local_src' if srcjar else None,
-    visibility = visibility,
-  )