Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit f6be9934 authored by George Mount's avatar George Mount
Browse files

Adds a way to exclude test directories from javadoc. 

By adding a file named NO_DOCS to a directory, all
java files under that directory will be ignored for
javadoc builds. This is especially useful for marking
test projects as not participating in the javadoc
build.

Change-Id: I3b0259f4bb3c8460c3560fdcf97c6cac11d8001d
parent 29ed0752

Android.mk

+16 −1
Original line number Diff line number Diff line
@@ -669,6 +669,16 @@ dirs_to_check_apis := \ 
  $(fwbase_dirs_to_document) \

	$(non_base_dirs)



###########################################################

## Return all directories that have a 'NO_DOCS' file in

## them, appending a '%' to them to form a pattern to

## filter out files under those directories.

## $(1): A list of base directories to look at.

###########################################################

define find-no-docs-pattern

$(addsuffix %, $(dir $(foreach dir, $(1), $(shell cd $(LOCAL_PATH); find $(dir) -name NO_DOCS))))

endef



# These are relative to frameworks/base

# FRAMEWORKS_BASE_SUBDIRS comes from build/core/pathmap.mk

dirs_to_document := \
@@ -676,6 +686,9 @@ dirs_to_document := \ 
  $(addprefix ../../, $(FRAMEWORKS_DATA_BINDING_JAVA_SRC_DIRS)) \

  $(addprefix ../../, $(FRAMEWORKS_SUPPORT_JAVA_SRC_DIRS)) \



patterns_to_not_document := \

	$(call find-no-docs-pattern, $(dirs_to_document))



# These are relative to frameworks/base

html_dirs := \

	$(FRAMEWORKS_BASE_SUBDIRS) \
@@ -689,9 +702,11 @@ common_src_files := \ 


# These are relative to frameworks/base

framework_docs_LOCAL_SRC_FILES := \

	$(call find-other-java-files, $(dirs_to_document)) \

	$(filter-out $(patterns_to_not_document), $(call find-other-java-files, $(dirs_to_document))) \

	$(common_src_files)



#	$(call find-other-java-files, $(dirs_to_document)) \



# These are relative to frameworks/base

framework_docs_LOCAL_API_CHECK_SRC_FILES := \

	$(call find-other-java-files, $(dirs_to_check_apis)) \