openwrt/include
Sergey Matsievskiy a72c8c7705
build: add comments to makefiles
Add comments to build system makefile functions and variables to help
developers in understanding build system internals and ease the
development process.

This patch adds some documentation examples with proposed doxygen-like
syntax. Hopefully, this would start the discussion and result in
generation of the makefile documentation guidelines.

Signed-off-by: Sergey Matsievskiy <matsievskiysv@gmail.com>
Link: https://github.com/openwrt/openwrt/pull/16888
Signed-off-by: Christian Marangi <ansuelsmth@gmail.com>
2024-11-12 17:56:07 +01:00
..
site build: remove ac_cv_header_netinet_sctp_h=no from pre-cached variables 2024-09-22 16:04:09 +02:00
autotools.mk include: autotools: do not symlink files in autoreconf 2024-08-29 20:04:02 +02:00
bpf.mk bpf: fix llvm version check 2024-09-09 10:36:47 +02:00
cmake.mk include: cmake.mk: honor CONFIG_DEBUG 2024-11-12 02:31:06 +00:00
debug.mk build: use SPDX license tags 2021-02-05 14:54:47 +01:00
depends.mk build: make find_md5 reproducible with AUTOREMOVE 2022-09-30 22:26:51 +02:00
device_table.txt
download.mk download: don't overwrite VERSION variable 2024-04-29 08:39:25 +02:00
feeds.mk build: add APK package build capabilities 2024-05-17 23:21:26 +03:00
hardened-ld-pie.specs build: add hardened builds with PIE (ASLR) support 2018-01-27 16:46:45 +01:00
hardening.mk build: add option for building with stack-protector-all 2024-01-19 21:27:14 +01:00
host-build.mk build: add support for host building in a subdirectory 2024-07-27 20:32:20 +02:00
image-commands.mk image: ignore errors from more commands 2024-10-30 14:17:34 +01:00
image.mk build: add comments to makefiles 2024-11-12 17:56:07 +01:00
kernel-6.6 kernel: bump 6.6 to 6.6.60 2024-11-10 10:35:05 +01:00
kernel-build.mk kernel-build.mk: Fix multi-core build warning. 2024-10-06 13:49:39 +02:00
kernel-defaults.mk kernel: rework Initramfs compile cpio handling 2024-09-19 01:07:25 +02:00
kernel-version.mk kernel: fix wrong detection of Linux-Testing-Version in makefile DUMP 2023-05-31 20:28:40 +02:00
kernel.mk loongarch64: new target 2024-05-04 14:14:16 +08:00
logo.png include: update logo with better kerning 2021-01-18 09:31:39 -10:00
logo.svg include: update logo with better kerning 2021-01-18 09:31:39 -10:00
meson.mk include: meson.mk: honor CONFIG_DEBUG 2024-11-12 02:31:06 +00:00
netfilter.mk iptables: update to 1.8.10 2024-10-22 00:52:03 +02:00
nls.mk nls.mk: fixup cmake packages 2022-11-27 00:52:06 +01:00
openssl-module.mk openssl: add legacy provider 2023-04-05 08:24:49 -03:00
package-bin.mk build: allow package to be built for all variants 2021-11-15 00:38:46 +01:00
package-defaults.mk build: add support for PKG_SUBDIRS variable 2024-07-08 08:49:42 +02:00
package-dumpinfo.mk build: remove duplicate MAINTAINER from package-dumpinfo.mk 2024-05-07 22:24:10 +02:00
package-pack.mk build: Honor DEFAULT_VARIANT for APK packages 2024-10-30 14:17:33 +01:00
package-seccomp.mk build: use SPDX license tags 2021-02-05 14:54:47 +01:00
package.mk build: add support for PKG_SUBDIRS variable 2024-07-08 08:49:42 +02:00
prereq-build.mk prereq-build: limit python distutils check to <v3.12 2024-10-16 22:36:43 +02:00
prereq.mk prereq: merge common cases in SetupHostCommand 2023-08-26 14:00:36 +02:00
quilt.mk quilt.mk: don't error on refresh/update if patches doesn't exist 2023-10-06 21:59:29 +02:00
rootfs.mk imagebuilder: fix APK for packages dir and cache 2024-11-09 16:46:35 +01:00
scan.awk build: propagate override information to .packageinfo 2015-02-09 12:09:31 +00:00
scan.mk scan.mk: do not silence output of dump phase 2023-11-13 14:01:24 +01:00
shell.sh build: use mkhash to replace various quirky md5sum/openssl calls 2017-01-05 11:09:12 +01:00
subdir.mk kernel-build.mk: add support for compiling only DTS 2024-02-08 19:57:28 +01:00
target.mk build: add comments to makefiles 2024-11-12 17:56:07 +01:00
toolchain-build.mk toolchain: fix dangling symlink to self in FixupLibdir 2022-07-01 19:17:36 +02:00
toplevel.mk toplevel.mk: add target feeds in 'make distclean' 2024-10-08 22:50:50 +02:00
trusted-firmware-a.mk include/trusted-firmware-a.mk: allow overriding package install template 2024-05-07 22:01:42 +02:00
u-boot.mk u-boot.mk: pass CROSS_COMPILE during config 2024-09-02 12:42:05 +02:00
uclibc++.mk uclibc++: remove 2021-10-24 18:20:50 +02:00
unpack.mk include: use libdeflate's gzip to decompress 2023-01-17 21:40:18 +01:00
verbose.mk verbose.mk: fallback to standard file descriptors 2024-01-05 16:25:14 +01:00
version.mk base-files: add SOURCE_DATE_EPOCH as OPENWRT_BUILD_DATE to os-release 2024-10-20 23:30:27 +02:00