13151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# Copyright (C) 2015 The Android Open Source Project
23151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang#
33151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# Licensed under the Apache License, Version 2.0 (the "License");
43151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# you may not use this file except in compliance with the License.
53151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# You may obtain a copy of the License at
63151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang#
73151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang#      http://www.apache.org/licenses/LICENSE-2.0
83151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang#
93151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# Unless required by applicable law or agreed to in writing, software
103151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# distributed under the License is distributed on an "AS IS" BASIS,
113151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
123151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# See the License for the specific language governing permissions and
133151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# limitations under the License.
143151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang#
153151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang
163151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# If you don't need to do a full clean build but would like to touch
173151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# a file or delete some intermediate files, add a clean step to the end
183151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# of the list.  These steps will only be run once, if they haven't been
193151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# run before.
203151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang#
213151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# E.g.:
223151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang#     $(call add-clean-step, touch -c external/sqlite/sqlite3.h)
233151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang#     $(call add-clean-step, rm -rf $(PRODUCT_OUT)/obj/STATIC_LIBRARIES/libz_intermediates)
243151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang#
253151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# Always use "touch -c" and "rm -f" or "rm -rf" to gracefully deal with
263151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# files that are missing or have been moved.
273151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang#
283151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# Use $(PRODUCT_OUT) to get to the "out/target/product/blah/" directory.
293151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# Use $(OUT_DIR) to refer to the "out" directory.
303151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang#
313151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# If you need to re-do something that's already mentioned, just copy
323151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# the command and add it to the bottom of the list.  E.g., if a change
333151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# that you made last week required touching a file and a change you
343151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# made today requires touching the same file, just copy the old
353151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# touch step and add it to the end of the list.
363151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang#
373151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# ************************************************
383151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# NEWER CLEAN STEPS MUST BE AT THE END OF THE LIST
393151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# ************************************************
403151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang
413151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang
423151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# ************************************************
433151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# NEWER CLEAN STEPS MUST BE AT THE END OF THE LIST
443151057cd2a1802c7e3061d338a3a5e6ac29dc46Ying Wang# ************************************************
45