summaryrefslogtreecommitdiffstats
path: root/documentation/kernel-manual/Makefile
diff options
context:
space:
mode:
authorBeth Flanagan <elizabeth.flanagan@intel.com>2011-06-02 10:18:35 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2011-12-20 22:35:16 +0000
commita02537187fcf131f1b97ec38d6f88a1ae82649fa (patch)
treea2020aa4a09031610aea55522494d4aa98bbda9d /documentation/kernel-manual/Makefile
parent78d092fe7a6b12e737ddc7c9564a72ad85a8a3c9 (diff)
downloadpoky-a02537187fcf131f1b97ec38d6f88a1ae82649fa.tar.gz
documentation: [YOCTO #1025] build system for docs
These changes fix the following issues: 1. Multiple Makefiles. There really is no need for this. 2. Unable to maintain more than one version of the docs on the webserver. This is a quick fix to enable the above. In order to build the documentation, at the top level, issue a: make all DOC=<doc directory name> make all DOC=kernel-manual Also, some changes need to occur on the webserver to fully incorporate these fixes. http://www.yoctoproject.org/documentation/ The docs are now published to: http://www.yoctoproject.org/docs/<Release MM.mm>/<doc name> The main page should be changed to point not only to the current doc release, but also to the prior releases. This will enable us to maintain prior release documentation without stomping over it when we publish new docs. Also, we'll need to repoint the yocto-quick-start link to yocto-project-qs. Or rename documentation/yocto-project-qs/* to support the website naming. (From yocto-docs rev: b5cb0801691dbedfa9d3733a6b62450c8a674fa0) Signed-off-by: Beth Flanagan <elizabeth.flanagan@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/kernel-manual/Makefile')
-rw-r--r--documentation/kernel-manual/Makefile65
1 files changed, 0 insertions, 65 deletions
diff --git a/documentation/kernel-manual/Makefile b/documentation/kernel-manual/Makefile
deleted file mode 100644
index 2d9cc98c18..0000000000
--- a/documentation/kernel-manual/Makefile
+++ /dev/null
@@ -1,65 +0,0 @@
1# You must call this Makefile using the following form:
2#
3# make
4# make html
5# make pdf
6# make tarball
7# make clean
8# make publish
9#
10# "make" creates the HTML, PDF, and tarballs.
11# "make html" creates just the HTML
12# "make pdf" creates just the PDF
13# "make tarball" creates the tarball
14# "make clean" removes the HTML and PDF files
15# "make publish" pushes the HTML, PDF, figures, and stylesheet to the web server
16#
17
18XSLTOPTS = --stringparam html.stylesheet style.css \
19 --stringparam chapter.autolabel 1 \
20 --stringparam appendix.autolabel A \
21 --stringparam section.autolabel 1 \
22 --stringparam section.label.includes.component.label 1 \
23 --xinclude
24
25VER = 1.0
26DOC = kernel-manual
27ALLPREQ = html pdf tarball
28TARFILES = kernel-manual.html kernel-manual.pdf style.css figures/kernel-title.png figures/kernel-architecture-overview.png
29MANUALS = $(DOC).html $(DOC).pdf
30FIGURES = figures
31STYLESHEET = *.css
32
33##
34# These URI should be rewritten by your distribution's xml catalog to
35# match your localy installed XSL stylesheets.
36XSL_BASE_URI = http://docbook.sourceforge.net/release/xsl/current
37XSL_XHTML_URI = $(XSL_BASE_URI)/xhtml/docbook.xsl
38
39all: html pdf tarball
40
41pdf:
42 ../tools/poky-docbook-to-pdf kernel-manual.xml ../template
43
44##
45# These URI should be rewritten by your distribution's xml catalog to
46# match your localy installed XSL stylesheets.
47
48html:
49# See http://www.sagehill.net/docbookxsl/HtmlOutput.html
50
51# xsltproc $(XSLTOPTS) -o yocto-project-qs.html $(XSL_XHTML_URI) yocto-project-qs.xml
52 xsltproc $(XSLTOPTS) -o kernel-manual.html yocto-project-kernel-manual-customization.xsl kernel-manual.xml
53
54tarball: html
55 cd $(DOC); tar -cvzf $(DOC).tgz $(TARFILES); cd ..
56
57validate:
58 xmllint --postvalid --xinclude --noout kernel-manual.xml
59
60publish:
61 scp -r $(MANUALS) $(STYLESHEET) www.yoctoproject.org:/srv/www/www.yoctoproject.org-docs/$(VER)/$(DOC)
62 scp -r $(FIGURES) www.yoctoproject.org:/srv/www/www.yoctoproject.org-docs/$(VER)/$(DOC)/figures
63
64clean:
65 rm -f $(MANUALS)