1# Copyright (C) 2019 The Android Open Source Project
2#
3# Licensed under the Apache License, Version 2.0 (the "License");
4# you may not use this file except in compliance with the License.
5# You may obtain a copy of the License at
6#
7#       http://www.apache.org/licenses/LICENSE-2.0
8#
9# Unless required by applicable law or agreed to in writing, software
10# distributed under the License is distributed on an "AS IS" BASIS,
11# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12# See the License for the specific language governing permissions and
13# limitations under the License.
14
15# This is an implementation detail of build.sh and friends. Do not source
16# directly as it will spoil your shell and make build.sh unusable. You have
17# been warned! If you have a good reason to source the result of this file into
18# a shell, please let kernel-team@android.com know and we are happy to help
19# with your use case.
20
21
22# This is a dummy to not break people that have a workflow that includes
23# sourcing build/envsetup.sh into a shell when working with Android repo.
24# The actual functionality of this script has been moved to _setup_env.sh.
25#
26# It turns out that build/envsetup.sh was sourced into the shell by a lot of
27# people. Mostly due to the fact that old documentation asked people to do so
28# (including this script itself). Unfortunately, this causes more harm than it
29# does any good. Mostly it spoils the shell with environment variables that are
30# only valid in the context of a very specific build configuration. To overcome
31# this, the content of this file has been moved to _setup_env.sh and callers
32# within this project have been adjusted. This script serves as a dummy to not
33# break people sourcing it, but it will from now on emit a deprecation warning.
34# That script might be removed at a later time.
35#
36# For further information on the Android Kernel build process with the tooling
37# of this project, please refer to
38# https://source.android.com/setup/build/building-kernels.
39#
40# For any questions or concerns, please contact kernel-team@android.com.
41
42echo "Sourcing 'build/envsetup.sh' for Android Kernels is deprecated and no longer valid!"
43echo "Please refer to the documentation in said script for details."
44