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