[PATCH cygport 1/3] Document src_unpack_hook and src_patch_hook
Jon Turney
jon.turney@dronecode.org.uk
Tue Feb 13 13:13:00 GMT 2018
Mention that these are unstable API and may be change in future.
---
lib/src_prep.cygpart | 23 ++++++++++++++++++-----
1 file changed, 18 insertions(+), 5 deletions(-)
diff --git a/lib/src_prep.cygpart b/lib/src_prep.cygpart
index 1e9247a..2277ba4 100644
--- a/lib/src_prep.cygpart
+++ b/lib/src_prep.cygpart
@@ -1,3 +1,4 @@
+
################################################################################
#
# src_prep.cygpart - cygport source unpacking and preparation functions
@@ -373,9 +374,15 @@ __src_prep() {
rm -f ${DISTCLEANFILES}
fi
- # src_unpack_hook() is an optional function which can be defined
- # to alter the original source tree and avoid large patches
- # or long DIFF_EXCLUDES, or to apply patches in tarballs
+
+#****v* Preparation/src_unpack_hook
+# DESCRIPTION
+# src_unpack_hook() is an optional function which can be defined
+# to alter the original source tree, to avoid large patches
+# or long DIFF_EXCLUDES.
+# (This API is not yet stable and is subject to change)
+#****
+
if __check_function src_unpack_hook
then
__check_unstable src_unpack_hook;
@@ -410,8 +417,14 @@ __src_prep() {
esac
done
- # similar to src_unpack_hook(), but is called after SRC_PATCH patches
- # useful for changing permissions, etc., on patched files
+#****v* Preparation/src_patch_hook
+# DESCRIPTION
+# src_patch_hook() an optional function which can be defined, which
+# is called after patches have been applied, for changing
+# permissions, etc., on patched files.
+# (This API is not yet stable and is subject to change)
+#****
+
if __check_function src_patch_hook
then
__check_unstable src_patch_hook;
--
2.16.1
More information about the Cygwin-apps
mailing list