[Buildroot] [PATCH 2/4] manual: provide make targets to build the documentation
Yann E. MORIN
yann.morin.1998 at anciens.enib.fr
Mon Oct 10 08:57:56 UTC 2011
Thomas, All,
On Monday 10 October 2011 104640 Thomas Petazzoni wrote:
> Special thanks for Yann E. Morin for giving input and suggestions to
> implement this.
>
> Signed-off-by: Thomas Petazzoni <thomas.petazzoni at free-electrons.com>
> Acked-by: Luca Ceresoli <luca at lucaceresoli.net>
Reviewed by: "Yann E. MORIN" <yann.morin.1998 at anciens.enib.fr>
> ---
> Makefile | 45 ++++++++++++++++++++++++++++++++++++++++++++-
> 1 files changed, 44 insertions(+), 1 deletions(-)
>
> diff --git a/Makefile b/Makefile
> index 8525b7d..d0f947d 100644
> --- a/Makefile
> +++ b/Makefile
> @@ -672,10 +672,19 @@ ifeq ($(BR2_TARGET_BAREBOX),y)
> @echo ' barebox-savedefconfig - Run barebox savedefconfig'
> endif
> @echo
> + @echo 'Documentation:'
> + @echo ' manual - build manual in HTML, split HTML, PDF and txt'
> + @echo ' manual-html - build manual in HTML'
> + @echo ' manual-split-html - build manual in split HTML'
> + @echo ' manual-pdf - build manual in PDF'
> + @echo ' manual-txt - build manual in txt'
> + @echo ' manual-epub - build manual in ePub'
> + @echo
> @echo 'Miscellaneous:'
> @echo ' source - download all sources needed for offline-build'
> @echo ' source-check - check all packages for valid download URLs'
> @echo ' external-deps - list external packages used'
> + @echo ' manual - build the Buildroot manual'
> @echo
> @echo ' make V=0|1 - 0 => quiet build (default), 1 => verbose build'
> @echo ' make O=dir - Locate all output files in "dir", including .config'
> @@ -683,7 +692,7 @@ endif
> @$(foreach b, $(sort $(notdir $(wildcard $(TOPDIR)/configs/*_defconfig))), \
> printf " %-35s - Build for %s\\n" $(b) $(b:_defconfig=);)
> @echo
> - @echo 'See docs/README and docs/buildroot.html for further details'
> + @echo 'See docs/README, or generate the Buildroot manual for further details'
> @echo
>
> release: OUT=buildroot-$(BR2_VERSION)
> @@ -691,5 +700,39 @@ release: OUT=buildroot-$(BR2_VERSION)
> release:
> git archive --format=tar --prefix=$(OUT)/ master|gzip -9 >$(OUT).tar.gz
>
> +MANUAL_SOURCES = $(wildcard docs/manual/*.txt)
> +
> +manual: manual-html manual-split-html manual-pdf manual-txt manual-epub
> +
> +manual-html: $(MANUAL_SOURCES)
> + @echo "HTML manual..."
> + $(Q)mkdir -p $(O)/docs/manual
> + $(Q)a2x -f xhtml -d book -L -r docs/images -D $(O)/docs/manual/ \
> + docs/manual/manual.txt
> +
> +manual-split-html: $(MANUAL_SOURCES)
> + @echo "Split HTML manual..."
> + $(Q)mkdir -p $(O)/docs/manual
> + $(Q)a2x -f chunked -d book -L -r docs/images -D $(O)/docs/manual/ \
> + docs/manual/manual.txt
> +
> +manual-pdf: $(MANUAL_SOURCES)
> + @echo "PDF manual..."
> + $(Q)mkdir -p $(O)/docs/manual
> + $(Q)a2x --dblatex-opts "-P latex.output.revhistory=0" -f pdf -d book -L -D $(O)/docs/manual/ \
> + docs/manual/manual.txt
> +
> +manual-txt: $(MANUAL_SOURCES)
> + @echo "Text manual..."
> + $(Q)mkdir -p $(O)/docs/manual
> + $(Q)a2x -f text -d book -L -D $(O)/docs/manual/ \
> + docs/manual/manual.txt
> +
> +manual-epub: $(MANUAL_SOURCES)
> + @echo "EPUB manual..."
> + $(Q)mkdir -p $(O)/docs/manual
> + $(Q)a2x -f epub -d book -L -r docs/images/ -D $(O)/docs/manual/ \
> + docs/manual/manual.txt
> +
> .PHONY: $(noconfig_targets)
>
--
.-----------------.--------------------.------------------.--------------------.
| Yann E. MORIN | Real-Time Embedded | /"\ ASCII RIBBON | Erics' conspiracy: |
| +0/33 662376056 | Software Designer | \ / CAMPAIGN | ^ |
| --==< O_o >==-- '------------.-------: X AGAINST | /e\ There is no |
| http://ymorin.is-a-geek.org/ | (*_*) | / \ HTML MAIL | """ conspiracy. |
'------------------------------'-------'------------------'--------------------'
More information about the buildroot
mailing list