X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=camera%2Fdocs%2FCameraMetadataKeys.mako;h=6006c8d34d39452e512574935a113c640c6850a8;hb=245e2796956edd42992a700440cb62569e1e26aa;hp=63811ce9b6d8ff7e5da25dc1cd9cc3d374d3b0db;hpb=5a885f6adbc1e37779395053bd874c59abf1495c;p=android-x86%2Fsystem-media.git diff --git a/camera/docs/CameraMetadataKeys.mako b/camera/docs/CameraMetadataKeys.mako index 63811ce9..6006c8d3 100644 --- a/camera/docs/CameraMetadataKeys.mako +++ b/camera/docs/CameraMetadataKeys.mako @@ -24,21 +24,6 @@ * modify the comment blocks at the start or end. *~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~@~*/ -<%! - ## - ## Generate extra text blocks for the details field - def generate_extra_detail(entry): - def inner(text): - if entry.optional: - text += '\n\nOptional - This value may be {@code null} on some devices.\n' - if any(tag.name == 'FULL' for tag in entry.tags): - text += \ - '\nFull capability - \n' + \ - 'Present on all camera devices that report being {@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL_FULL HARDWARE_LEVEL_FULL} devices in the\n' + \ - 'android.info.supportedHardwareLevel key\n' - return text - return inner -%> ## ## Generate a single key and docs <%def name="generate_key(entry)">\ @@ -52,7 +37,7 @@ if entry.details: details = dedent(entry.details) # Unconditionally add extra information if necessary - extra_detail = generate_extra_detail(entry)("") + extra_detail = generate_extra_javadoc_detail(entry)("") concatenated_info = description + details + extra_detail %>\ @@ -67,15 +52,16 @@ ${concatenated_info | javadoc(metadata)}\ % endif % if entry.deprecated: * @deprecated +${entry.deprecation_description | javadoc(metadata)} % endif - % if entry.applied_visibility == 'hidden': + % if entry.applied_visibility in ('hidden', 'ndk_public'): * @hide % endif */ % if entry.deprecated: @Deprecated % endif - % if entry.applied_visibility == 'public': + % if entry.applied_visibility in ('public', 'java_public'): @PublicKey % endif % if entry.synthetic: @@ -90,17 +76,17 @@ ${concatenated_info | javadoc(metadata)}\ % for outer_namespace in metadata.outer_namespaces: ## assumes single 'android' namespace % for section in outer_namespace.sections: % if section.find_first(lambda x: isinstance(x, metadata_model.Entry) and x.kind == xml_name) and \ - any_visible(section, xml_name, ('public','hidden') ): + any_visible(section, xml_name, ('public','hidden','ndk_public','java_public') ): % for inner_namespace in get_children_by_filtering_kind(section, xml_name, 'namespaces'): ## We only support 1 level of inner namespace, i.e. android.a.b and android.a.b.c works, but not android.a.b.c.d ## If we need to support more, we should use a recursive function here instead.. but the indentation gets trickier. - % for entry in filter_visibility(inner_namespace.merged_entries, ('hidden','public')): + % for entry in filter_visibility(inner_namespace.merged_entries, ('hidden','public', 'ndk_public', 'java_public')): ${generate_key(entry)} % endfor % endfor % for entry in filter_visibility( \ get_children_by_filtering_kind(section, xml_name, 'merged_entries'), \ - ('hidden', 'public')): + ('hidden', 'public', 'ndk_public', 'java_public')): ${generate_key(entry)} % endfor % endif