1
0

rework doc

- drop linux-doc
- always build tools with docs
This commit is contained in:
2024-10-29 05:12:06 +03:00
parent 035dfc85aa
commit 6d27d8e6f8
14 changed files with 4 additions and 101 deletions

48
debian/rules.real vendored
View File

@@ -189,20 +189,6 @@ endif
rm -f $(INSTALL_DIR)/lib/modules/$(REAL_VERSION)/source
@$(stamp)
$(STAMPS_DIR)/build-doc: DIR=$(BUILD_DIR)/build-doc
# sphinx commands in /usr/bin are managed by the alternatives system.
# Change $PATH to make sure we consistently use the Python 3 version.
$(STAMPS_DIR)/build-doc: PATH:=/usr/share/sphinx/scripts/python3:$(PATH)
$(STAMPS_DIR)/build-doc: $(STAMPS_DIR)/source
ifeq (,$(filter nodoc,$(DEB_BUILD_PROFILES)))
mkdir -p '$(BUILD_DIR)'
rm -rf '$(DIR)'
$(call copy_source,$(DIR))
+$(MAKE_CLEAN) -C '$(DIR)' PYTHON=python3 xmldocs
+$(MAKE_CLEAN) -C '$(DIR)' PYTHON=python3 htmldocs
endif
@$(stamp)
define dh_binary_pre
dh_testroot
dh_prep
@@ -240,40 +226,6 @@ binary_meta:
$(dh_binary_pre)
$(dh_binary_post)
build_doc: $(STAMPS_DIR)/build-doc
binary_doc: DIR = $(BUILD_DIR)/build-doc
binary_doc: OUT_DIR = $(DESTDIR)/usr/share/doc/$(PACKAGE_NAME)
binary_doc: $(STAMPS_DIR)/build-doc
$(dh_binary_pre)
ifeq (,$(filter nodoc,$(DEB_BUILD_PROFILES)))
mkdir -p $(OUT_DIR)
set -o pipefail; \
find CREDITS MAINTAINERS README Documentation \
-name '.gitignore' -prune -o -name DocBook -prune -o \
-path Documentation/media -prune -o \
-path Documentation/sphinx -prune -o \
-name 'Makefile*' -prune -o \
-print | \
cpio -pd --preserve-modification-time '$(OUT_DIR)'
set -o pipefail; \
cd $(DIR)/Documentation/output; \
find * -name '*.rst' -prune -o -name objects.inv -prune \
-o -name xml -prune -o -print | \
cpio -pd --preserve-modification-time '$(OUT_DIR)/html'
find $(OUT_DIR)/Documentation -type f | xargs gzip -9n
# Fix up symlinks to gzipped docs
cd $(OUT_DIR)/Documentation; \
find -type l | while read link; do \
dest="$$(readlink -f "$$link")"; \
if [ -f "$$dest.gz" ]; then \
rm -f "$$link"; \
ln -sr "$$dest.gz" "$$link.gz"; \
fi; \
done
endif
$(dh_binary_post)
build_headers-common:
binary_headers-common: PACKAGE_NAME_KBUILD = linux-kbuild-$(ABINAME)