Merge "Document that blueprint:"mutated"
properties are skipped." am: 9fd2ed93df
am: 7cf283232e
am: bd3c584db6
Original change: https://android-review.googlesource.com/c/platform/build/blueprint/+/1823195 Change-Id: Id3e35e8e3973df2e13d58717ebc58a7f7cb969e5
This commit is contained in:
commit
455adcb019
1 changed files with 9 additions and 5 deletions
|
@ -20,7 +20,8 @@ import (
|
||||||
)
|
)
|
||||||
|
|
||||||
// AppendProperties appends the values of properties in the property struct src to the property
|
// AppendProperties appends the values of properties in the property struct src to the property
|
||||||
// struct dst. dst and src must be the same type, and both must be pointers to structs.
|
// struct dst. dst and src must be the same type, and both must be pointers to structs. Properties
|
||||||
|
// tagged `blueprint:"mutated"` are skipped.
|
||||||
//
|
//
|
||||||
// The filter function can prevent individual properties from being appended by returning false, or
|
// The filter function can prevent individual properties from being appended by returning false, or
|
||||||
// abort AppendProperties with an error by returning an error. Passing nil for filter will append
|
// abort AppendProperties with an error by returning an error. Passing nil for filter will append
|
||||||
|
@ -38,7 +39,8 @@ func AppendProperties(dst interface{}, src interface{}, filter ExtendPropertyFil
|
||||||
}
|
}
|
||||||
|
|
||||||
// PrependProperties prepends the values of properties in the property struct src to the property
|
// PrependProperties prepends the values of properties in the property struct src to the property
|
||||||
// struct dst. dst and src must be the same type, and both must be pointers to structs.
|
// struct dst. dst and src must be the same type, and both must be pointers to structs. Properties
|
||||||
|
// tagged `blueprint:"mutated"` are skipped.
|
||||||
//
|
//
|
||||||
// The filter function can prevent individual properties from being prepended by returning false, or
|
// The filter function can prevent individual properties from being prepended by returning false, or
|
||||||
// abort PrependProperties with an error by returning an error. Passing nil for filter will prepend
|
// abort PrependProperties with an error by returning an error. Passing nil for filter will prepend
|
||||||
|
@ -58,7 +60,7 @@ func PrependProperties(dst interface{}, src interface{}, filter ExtendPropertyFi
|
||||||
// AppendMatchingProperties appends the values of properties in the property struct src to the
|
// AppendMatchingProperties appends the values of properties in the property struct src to the
|
||||||
// property structs in dst. dst and src do not have to be the same type, but every property in src
|
// property structs in dst. dst and src do not have to be the same type, but every property in src
|
||||||
// must be found in at least one property in dst. dst must be a slice of pointers to structs, and
|
// must be found in at least one property in dst. dst must be a slice of pointers to structs, and
|
||||||
// src must be a pointer to a struct.
|
// src must be a pointer to a struct. Properties tagged `blueprint:"mutated"` are skipped.
|
||||||
//
|
//
|
||||||
// The filter function can prevent individual properties from being appended by returning false, or
|
// The filter function can prevent individual properties from being appended by returning false, or
|
||||||
// abort AppendProperties with an error by returning an error. Passing nil for filter will append
|
// abort AppendProperties with an error by returning an error. Passing nil for filter will append
|
||||||
|
@ -79,7 +81,7 @@ func AppendMatchingProperties(dst []interface{}, src interface{},
|
||||||
// PrependMatchingProperties prepends the values of properties in the property struct src to the
|
// PrependMatchingProperties prepends the values of properties in the property struct src to the
|
||||||
// property structs in dst. dst and src do not have to be the same type, but every property in src
|
// property structs in dst. dst and src do not have to be the same type, but every property in src
|
||||||
// must be found in at least one property in dst. dst must be a slice of pointers to structs, and
|
// must be found in at least one property in dst. dst must be a slice of pointers to structs, and
|
||||||
// src must be a pointer to a struct.
|
// src must be a pointer to a struct. Properties tagged `blueprint:"mutated"` are skipped.
|
||||||
//
|
//
|
||||||
// The filter function can prevent individual properties from being prepended by returning false, or
|
// The filter function can prevent individual properties from being prepended by returning false, or
|
||||||
// abort PrependProperties with an error by returning an error. Passing nil for filter will prepend
|
// abort PrependProperties with an error by returning an error. Passing nil for filter will prepend
|
||||||
|
@ -99,6 +101,7 @@ func PrependMatchingProperties(dst []interface{}, src interface{},
|
||||||
|
|
||||||
// ExtendProperties appends or prepends the values of properties in the property struct src to the
|
// ExtendProperties appends or prepends the values of properties in the property struct src to the
|
||||||
// property struct dst. dst and src must be the same type, and both must be pointers to structs.
|
// property struct dst. dst and src must be the same type, and both must be pointers to structs.
|
||||||
|
// Properties tagged `blueprint:"mutated"` are skipped.
|
||||||
//
|
//
|
||||||
// The filter function can prevent individual properties from being appended or prepended by
|
// The filter function can prevent individual properties from being appended or prepended by
|
||||||
// returning false, or abort ExtendProperties with an error by returning an error. Passing nil for
|
// returning false, or abort ExtendProperties with an error by returning an error. Passing nil for
|
||||||
|
@ -123,7 +126,8 @@ func ExtendProperties(dst interface{}, src interface{}, filter ExtendPropertyFil
|
||||||
// ExtendMatchingProperties appends or prepends the values of properties in the property struct src
|
// ExtendMatchingProperties appends or prepends the values of properties in the property struct src
|
||||||
// to the property structs in dst. dst and src do not have to be the same type, but every property
|
// to the property structs in dst. dst and src do not have to be the same type, but every property
|
||||||
// in src must be found in at least one property in dst. dst must be a slice of pointers to
|
// in src must be found in at least one property in dst. dst must be a slice of pointers to
|
||||||
// structs, and src must be a pointer to a struct.
|
// structs, and src must be a pointer to a struct. Properties tagged `blueprint:"mutated"` are
|
||||||
|
// skipped.
|
||||||
//
|
//
|
||||||
// The filter function can prevent individual properties from being appended or prepended by
|
// The filter function can prevent individual properties from being appended or prepended by
|
||||||
// returning false, or abort ExtendMatchingProperties with an error by returning an error. Passing
|
// returning false, or abort ExtendMatchingProperties with an error by returning an error. Passing
|
||||||
|
|
Loading…
Reference in a new issue