aboutsummaryrefslogtreecommitdiffhomepage
path: root/src/main/java/com/google/devtools/build/docgen
diff options
context:
space:
mode:
authorGravatar cparsons <cparsons@google.com>2018-04-12 13:24:39 -0700
committerGravatar Copybara-Service <copybara-piper@google.com>2018-04-12 13:25:55 -0700
commitd60869c57389b521427ab7ffa1d555de7c133d84 (patch)
tree3e14f123801d7f809c06ea26f8e60bee58403744 /src/main/java/com/google/devtools/build/docgen
parent08ddce7cede917d6e8cc97af77985ca77f0d6551 (diff)
Remove docgen corner case on undocumented data structures, as these are no longer relevant.
Verified by building documentation for Bazel at HEAD. RELNOTES: None. PiperOrigin-RevId: 192659718
Diffstat (limited to 'src/main/java/com/google/devtools/build/docgen')
-rw-r--r--src/main/java/com/google/devtools/build/docgen/SkylarkDocumentationCollector.java17
1 files changed, 5 insertions, 12 deletions
diff --git a/src/main/java/com/google/devtools/build/docgen/SkylarkDocumentationCollector.java b/src/main/java/com/google/devtools/build/docgen/SkylarkDocumentationCollector.java
index 4dc96ebbca..8c669bb058 100644
--- a/src/main/java/com/google/devtools/build/docgen/SkylarkDocumentationCollector.java
+++ b/src/main/java/com/google/devtools/build/docgen/SkylarkDocumentationCollector.java
@@ -33,7 +33,6 @@ import java.util.ArrayDeque;
import java.util.Deque;
import java.util.HashMap;
import java.util.HashSet;
-import java.util.List;
import java.util.Map;
import java.util.Set;
import java.util.TreeMap;
@@ -138,18 +137,12 @@ final class SkylarkDocumentationCollector {
SkylarkModule skylarkModule = moduleClass.equals(Object.class)
? getTopLevelModule()
: Runtime.getSkylarkNamespace(moduleClass).getAnnotation(SkylarkModule.class);
- if (skylarkModule == null) {
- // TODO(bazel-team): we currently have undocumented methods on undocumented data
- // structures, namely java.util.List. Remove this case when we are done.
- Preconditions.checkState(!skylarkSignature.documented());
- Preconditions.checkState(moduleClass == List.class);
- } else {
- if (!modules.containsKey(skylarkModule.name())) {
- modules.put(skylarkModule.name(), new SkylarkModuleDoc(skylarkModule, moduleClass));
- }
- SkylarkModuleDoc module = modules.get(skylarkModule.name());
- module.addMethod(new SkylarkBuiltinMethodDoc(module, skylarkSignature, field.getType()));
+ Preconditions.checkNotNull(skylarkModule);
+ if (!modules.containsKey(skylarkModule.name())) {
+ modules.put(skylarkModule.name(), new SkylarkModuleDoc(skylarkModule, moduleClass));
}
+ SkylarkModuleDoc module = modules.get(skylarkModule.name());
+ module.addMethod(new SkylarkBuiltinMethodDoc(module, skylarkSignature, field.getType()));
}
}
}