summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--documentation/README52
1 files changed, 52 insertions, 0 deletions
diff --git a/documentation/README b/documentation/README
new file mode 100644
index 0000000000..5f41f79c37
--- /dev/null
+++ b/documentation/README
@@ -0,0 +1,52 @@
1documentation
2=============
3
4This is the location for the Yocto Project documentation. Documentation
5consists of six manuals (see below).
6
7Manual Organization
8===================
9
10Folders exist for individual manuals as follows:
11
12* adt-manual - The Yocto Project Application Development Toolkit (ADT)
13 User's Guide.
14* bsp-guide - The Yocto Project Board Support (BSP) Developer's Guide
15* dev-manual - The Yocto Project Development Manual
16* kernel-manual - The Yocto Project Kernel Architecture and Use Manual
17* poky-ref-manual - The Yocto Project Reference Manual
18* yocto-project-qs - The Yocto Project Quick Start
19
20Each folder is self-contained regarding content and figures.
21
22Makefile
23========
24
25The Makefile processes manual directories to create HTML, PDF,
26tarballs, etc. Details on how the Makefile work are documented
27inside the Makefile. See that file for more information.
28
29To build a manual, you run the make command and pass it the name
30of the folder containing the manual's contents.
31For example, the following command run from the documentation directory
32creates an HTML and a PDF version of the ADT manual.
33The DOC variable specifies the manual you are making:
34
35 $ make DOC=adt-manual
36
37poky.ent
38========
39
40This file defines variables used for documentation production. The variables
41are used to define release pathnames, URLs for the published manuals, etc.
42
43template
44========
45Contains various templates, fonts, and some old PNG files.
46
47tools
48=====
49Contains a tool to convert the DocBook files to PDF format.
50
51
52