bazel-contrib · bazel-docs-pull-requestor · May 2, 2026
diff --git a/navigation.json b/navigation.json
@@ -87,6 +87,14 @@
           "$ref": "./navigation/7.7.en.json"
         }
       ]
+    },
+    {
+      "version": "6.5",
+      "languages": [
+        {
+          "$ref": "./navigation/6.5.en.json"
+        }
+      ]
     }
   ]
 }
diff --git a/reference/command-line-reference.mdx b/reference/command-line-reference.mdx
@@ -3397,6 +3397,9 @@ Miscellaneous options, not otherwise categorized.:
     Tags:
     [`loading_and_analysis`](#effect_tag_LOADING_AND_ANALYSIS), [`incompatible_change`](#metadata_tag_INCOMPATIBLE_CHANGE)
 
+`--j2objc_translation_flags=<comma-separated list of options>` multiple uses are accumulated
+:   Additional options to pass to the J2ObjC tool.
+
 `--java_debug`
 :   Causes the Java virtual machine of a java test to wait for a connection from a JDWP-compliant debugger (such as jdb) before starting the test. Implies -test_output=streamed.
 
@@ -6063,6 +6066,9 @@ Miscellaneous options, not otherwise categorized.:
     Tags:
     [`loading_and_analysis`](#effect_tag_LOADING_AND_ANALYSIS), [`incompatible_change`](#metadata_tag_INCOMPATIBLE_CHANGE)
 
+`--j2objc_translation_flags=<comma-separated list of options>` multiple uses are accumulated
+:   Additional options to pass to the J2ObjC tool.
+
 `--java_debug`
 :   Causes the Java virtual machine of a java test to wait for a connection from a JDWP-compliant debugger (such as jdb) before starting the test. Implies -test_output=streamed.
 
@@ -7874,6 +7880,9 @@ Miscellaneous options, not otherwise categorized.:
     Tags:
     [`loading_and_analysis`](#effect_tag_LOADING_AND_ANALYSIS), [`incompatible_change`](#metadata_tag_INCOMPATIBLE_CHANGE)
 
+`--j2objc_translation_flags=<comma-separated list of options>` multiple uses are accumulated
+:   Additional options to pass to the J2ObjC tool.
+
 `--java_debug`
 :   Causes the Java virtual machine of a java test to wait for a connection from a JDWP-compliant debugger (such as jdb) before starting the test. Implies -test_output=streamed.
 
@@ -9506,6 +9515,9 @@ Miscellaneous options, not otherwise categorized.:
     Tags:
     [`loading_and_analysis`](#effect_tag_LOADING_AND_ANALYSIS), [`incompatible_change`](#metadata_tag_INCOMPATIBLE_CHANGE)
 
+`--j2objc_translation_flags=<comma-separated list of options>` multiple uses are accumulated
+:   Additional options to pass to the J2ObjC tool.
+
 `--java_debug`
 :   Causes the Java virtual machine of a java test to wait for a connection from a JDWP-compliant debugger (such as jdb) before starting the test. Implies -test_output=streamed.
 
@@ -12496,6 +12508,9 @@ Miscellaneous options, not otherwise categorized.:
     Tags:
     [`loading_and_analysis`](#effect_tag_LOADING_AND_ANALYSIS), [`incompatible_change`](#metadata_tag_INCOMPATIBLE_CHANGE)
 
+`--j2objc_translation_flags=<comma-separated list of options>` multiple uses are accumulated
+:   Additional options to pass to the J2ObjC tool.
+
 `--java_debug`
 :   Causes the Java virtual machine of a java test to wait for a connection from a JDWP-compliant debugger (such as jdb) before starting the test. Implies -test_output=streamed.
 

diff --git a/rules/lib/fragments.mdx b/rules/lib/fragments.mdx
@@ -10,6 +10,7 @@ Rule implementations can get them using `ctx.fragments.[fragment name]`
 * [bazel_android](/rules/lib/fragments/bazel_android)
 * [coverage](/rules/lib/fragments/coverage)
 * [cpp](/rules/lib/fragments/cpp)
+* [j2objc](/rules/lib/fragments/j2objc)
 * [java](/rules/lib/fragments/java)
 * [objc](/rules/lib/fragments/objc)
 * [platform](/rules/lib/fragments/platform)

diff --git a/rules/lib/overview.mdx b/rules/lib/overview.mdx
@@ -17,6 +17,7 @@ title: 'One-Page Overview'
 * [bazel_android](/rules/lib/fragments/bazel_android)
 * [coverage](/rules/lib/fragments/coverage)
 * [cpp](/rules/lib/fragments/cpp)
+* [j2objc](/rules/lib/fragments/j2objc)
 * [java](/rules/lib/fragments/java)
 * [objc](/rules/lib/fragments/objc)
 * [platform](/rules/lib/fragments/platform)

diff --git a/upstream b/upstream
diff --git a/versions/9.1.0/basics/task-based-builds.mdx b/versions/9.1.0/basics/task-based-builds.mdx
@@ -23,32 +23,32 @@ Take this example from the
    <description>
      simple example build file
    </description>
-   {/* set global properties for this build */}
+   <!-- set global properties for this build -->
    <property name="src" location="src"/>
    <property name="build" location="build"/>
    <property name="dist" location="dist"/>
 
    <target name="init">
-     {/* Create the time stamp */}
+     <!-- Create the time stamp -->
      <tstamp/>
-     {/* Create the build directory structure used by compile */}
+     <!-- Create the build directory structure used by compile -->
      <mkdir dir="${build}"/>
    </target>
    <target name="compile" depends="init"
        description="compile the source">
-     {/* Compile the Java code from ${src} into ${build} */}
+     <!-- Compile the Java code from ${src} into ${build} -->
      <javac srcdir="${src}" destdir="${build}"/>
    </target>
    <target name="dist" depends="compile"
        description="generate the distribution">
-     {/* Create the distribution directory */}
+     <!-- Create the distribution directory -->
      <mkdir dir="${dist}/lib"/>
-     {/* Put everything in ${build} into the MyProject-${DSTAMP}.jar file */}
+     <!-- Put everything in ${build} into the MyProject-${DSTAMP}.jar file -->
      <jar jarfile="${dist}/lib/MyProject-${DSTAMP}.jar" basedir="${build}"/>
    </target>
    <target name="clean"
        description="clean up">
-     {/* Delete the ${build} and ${dist} directory trees */}
+     <!-- Delete the ${build} and ${dist} directory trees -->
      <delete dir="${build}"/>
      <delete dir="${dist}"/>
    </target>

diff --git a/versions/9.1.0/community/users.mdx b/versions/9.1.0/community/users.mdx
@@ -1,5 +1,5 @@
 ---
-title: "Who's Using Bazel"
+title: 'Who's Using Bazel'
 ---
 
 Note: Using Bazel? You can add your company on
@@ -43,7 +43,7 @@ analysis. Their motto is _Big data is hard. We make it easy_.
 
 ### [ASML](https://asml.com)
 
-<img src="https://upload.wikimedia.org/wikipedia/en/6/6c/ASML_Holding_N.V._logo.svg" width="150" align="right" />
+<img src="https://upload.wikimedia.org/wikipedia/en/6/6c/ASML_Holding_N.V._logo.svg" width="150" align=right />
 
 ASML is an innovation leader in the semiconductor industry. We provide chipmakers
 with everything they need – hardware, software and services – to mass produce

diff --git a/versions/9.1.0/concepts/build-files.mdx b/versions/9.1.0/concepts/build-files.mdx
@@ -130,6 +130,19 @@ for anyone to create new rules.
     and binaries and tests can depend on libraries, with the expected
     separate-compilation behavior.
 
+<table class="columns">
+  <tr>
+    <td><a class="button button-with-icon button-primary"
+           href="/versions/9.1.0/concepts/labels">
+        <span class="material-icons" aria-hidden="true">arrow_back</span>Labels</a>
+    </td>
+    <td><a class="button button-with-icon button-primary"
+           href="/versions/9.1.0/concepts/dependencies">
+        Dependencies<span class="material-icons icon-after" aria-hidden="true">arrow_forward</span></a>
+    </td>
+  </tr>
+</table>
+
 ## File encoding
 
 `BUILD` and `.bzl` files should be encoded in UTF-8, of which ASCII is a valid

diff --git a/versions/9.1.0/concepts/dependencies.mdx b/versions/9.1.0/concepts/dependencies.mdx
@@ -70,57 +70,55 @@ depends on `c`.
   </tr>
   <tr>
     <td>
-```
-rule(
+      <pre>rule(
     name = "a",
     srcs = "a.in",
     deps = "//b:b",
 )
-```
+      </pre>
     </td>
     <td>
-```
+      <pre>
 rule(
     name = "b",
     srcs = "b.in",
     deps = "//c:c",
 )
-```
+      </pre>
     </td>
   </tr>
   <tr class="alt">
     <td><code>a / a.in</code></td>
     <td><code>b / b.in</code></td>
   </tr>
   <tr>
-    <td>
-```
+    <td><pre>
 import b;
 b.foo();
-```
+    </pre>
     </td>
     <td>
-```
+      <pre>
 import c;
 function foo() {
   c.bar();
 }
-```
+      </pre>
     </td>
   </tr>
   <tr>
     <td>
       <figure>
         <img src="/versions/9.1.0/docs/images/a_b_c.svg"
-             alt="Declared dependency graph with arrows connecting a, b, and c" />
+             alt="Declared dependency graph with arrows connecting a, b, and c">
         <figcaption><b>Declared</b> dependency graph</figcaption>
       </figure>
     </td>
     <td>
       <figure>
         <img src="/versions/9.1.0/docs/images/a_b_c.svg"
              alt="Actual dependency graph that matches the declared dependency
-                  graph with arrows connecting a, b, and c" />
+                  graph with arrows connecting a, b, and c">
         <figcaption><b>Actual</b> dependency graph</figcaption>
       </figure>
     </td>
@@ -142,20 +140,20 @@ direct _actual_ dependency on `c`, but forgets to declare it in the build file
   </tr>
   <tr>
     <td>
-```
-import b;
-import c;
-b.foo();
-c.garply();
-```
+      <pre>
+        import b;
+        import c;
+        b.foo();
+        c.garply();
+      </pre>
     </td>
     <td>&nbsp;</td>
   </tr>
   <tr>
     <td>
       <figure>
         <img src="/versions/9.1.0/docs/images/a_b_c.svg"
-             alt="Declared dependency graph with arrows connecting a, b, and c" />
+             alt="Declared dependency graph with arrows connecting a, b, and c">
         <figcaption><b>Declared</b> dependency graph</figcaption>
       </figure>
     </td>
@@ -164,7 +162,7 @@ c.garply();
         <img src="/versions/9.1.0/docs/images/a_b_c_ac.svg"
              alt="Actual dependency graph with arrows connecting a, b, and c. An
                   arrow now connects A to C as well. This does not match the
-                  declared dependency graph" />
+                  declared dependency graph">
         <figcaption><b>Actual</b> dependency graph</figcaption>
       </figure>
     </td>
@@ -189,13 +187,12 @@ fault of their own.
   <tr>
     <td>&nbsp;</td>
     <td>
-```
-rule(
+      <pre>rule(
     name = "b",
     srcs = "b.in",
     <strong>deps = "//d:d",</strong>
 )
-```
+      </pre>
     </td>
   </tr>
   <tr class="alt">
@@ -205,28 +202,28 @@ rule(
   <tr>
     <td>&nbsp;</td>
     <td>
-```
-import d;
-function foo() {
-  d.baz();
-}
-```
+      <pre>
+      import d;
+      function foo() {
+        d.baz();
+      }
+      </pre>
     </td>
   </tr>
   <tr>
     <td>
       <figure>
         <img src="/versions/9.1.0/docs/images/ab_c.svg"
              alt="Declared dependency graph with arrows connecting a and b.
-                  b no longer connects to c, which breaks a's connection to c" />
+                  b no longer connects to c, which breaks a's connection to c">
         <figcaption><b>Declared</b> dependency graph</figcaption>
       </figure>
     </td>
     <td>
       <figure>
         <img src="/versions/9.1.0/docs/images/a_b_a_c.svg"
              alt="Actual dependency graph that shows a connecting to b and c,
-                  but b no longer connects to c" />
+                  but b no longer connects to c">
         <figcaption><b>Actual</b> dependency graph</figcaption>
       </figure>
     </td>
@@ -302,18 +299,15 @@ As you look over our `BUILD` files, you might notice that some `data` labels
 refer to directories. These labels end with `/.` or `/` like these examples,
 which you should not use:
 
-<p>
-  <span class="compare-worse">Not recommended</span> —
+<p><span class="compare-worse">Not recommended</span> —
   <code>data = ["//data/regression:unittest/."]</code>
 </p>
 
-<p>
-  <span class="compare-worse">Not recommended</span> —
+<p><span class="compare-worse">Not recommended</span> —
   <code>data = ["testdata/."]</code>
 </p>
 
-<p>
-  <span class="compare-worse">Not recommended</span> —
+<p><span class="compare-worse">Not recommended</span> —
   <code>data = ["testdata/"]</code>
 </p>
 
@@ -331,8 +325,7 @@ enumerate the set of files contained within them, either explicitly or using the
 [`glob()`](/versions/9.1.0/reference/be/functions#glob) function. (Use `**` to force the
 `glob()` to be recursive.)
 
-<p>
-  <span class="compare-better">Recommended</span> —
+<p><span class="compare-better">Recommended</span> —
   <code>data = glob(["testdata/**"])</code>
 </p>
 
@@ -365,3 +358,16 @@ filegroup(
 
 You can then reference the label `my_data` as the data dependency in your test.
 
+<table class="columns">
+  <tr>
+    <td><a class="button button-with-icon button-primary"
+           href="/versions/9.1.0/concepts/build-files">
+        <span class="material-icons" aria-hidden="true">arrow_back</span>BUILD files</a>
+    </td>
+    <td><a class="button button-with-icon button-primary"
+           href="/versions/9.1.0/concepts/visibility">
+        Visibility<span class="material-icons icon-after" aria-hidden="true">arrow_forward</span></a>
+    </td>
+  </tr>
+</table>
+