1c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# Copyright (C) 2007 The Android Open Source Project
2c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath#
3c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# Licensed under the Apache License, Version 2.0 (the "License");
4c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# you may not use this file except in compliance with the License.
5c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# You may obtain a copy of the License at
6c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath#
7c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath#      http://www.apache.org/licenses/LICENSE-2.0
8c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath#
9c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# Unless required by applicable law or agreed to in writing, software
10c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# distributed under the License is distributed on an "AS IS" BASIS,
11c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# See the License for the specific language governing permissions and
13c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# limitations under the License.
14c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath#
15c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath
16c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# If you don't need to do a full clean build but would like to touch
17c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# a file or delete some intermediate files, add a clean step to the end
18c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# of the list.  These steps will only be run once, if they haven't been
19c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# run before.
20c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath#
21c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# E.g.:
22c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath#     $(call add-clean-step, touch -c external/sqlite/sqlite3.h)
23c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath#     $(call add-clean-step, rm -rf $(PRODUCT_OUT)/obj/STATIC_LIBRARIES/libz_intermediates)
24c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath#
25c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# Always use "touch -c" and "rm -f" or "rm -rf" to gracefully deal with
26c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# files that are missing or have been moved.
27c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath#
28c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# Use $(PRODUCT_OUT) to get to the "out/target/product/blah/" directory.
29c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# Use $(OUT_DIR) to refer to the "out" directory.
30c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath#
31c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# If you need to re-do something that's already mentioned, just copy
32c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# the command and add it to the bottom of the list.  E.g., if a change
33c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# that you made last week required touching a file and a change you
34c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# made today requires touching the same file, just copy the old
35c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# touch step and add it to the end of the list.
36c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath#
37c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# ************************************************
38c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# NEWER CLEAN STEPS MUST BE AT THE END OF THE LIST
39c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# ************************************************
40c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath
41c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# For example:
42c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath#$(call add-clean-step, rm -rf $(OUT_DIR)/target/common/obj/APPS/AndroidTests_intermediates)
43c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath#$(call add-clean-step, rm -rf $(OUT_DIR)/target/common/obj/JAVA_LIBRARIES/core_intermediates)
44c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath#$(call add-clean-step, find $(OUT_DIR) -type f -name "IGTalkSession*" -print0 | xargs -0 rm -f)
45c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath#$(call add-clean-step, rm -rf $(PRODUCT_OUT)/data/*)
46c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath
47c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# ************************************************
48c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# NEWER CLEAN STEPS MUST BE AT THE END OF THE LIST
49c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# ************************************************
50c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath
51c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# This empty file is here solely for the purpose of optimizing the Android build
52c981c48f5bc9aefeffc0bcb0cc3934c2fae179ddNarayan Kamath# Please keep it there, and empty, thanks.
53