aboutsummaryrefslogtreecommitdiffstats
path: root/documentation/README
blob: 911484cb99d0f51bdbcdf87057531dd16da6ba56 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
documentation
=============

This is the directory that contains the Yocto Project documentation.  The Yocto
Project source repositories at http://git.yoctoproject.org/cgit.cgi have two 
instances of the "documentation" directory.  You should understand each of
these instances.

  poky/documentation - The directory within the poky Git repository containing
                       the set of Yocto Project manuals.  When you clone the 
                       poky Git repository, the documentation directory 
                       contains the manuals.  The state of the manuals in this 
                       directory is guaranteed to reflect the latest Yocto 
                       Project release.  The manuals at the tip of this 
                       directory will also likely contain most manual 
                       development changes.

  yocto-docs/documentation - The Git repository for the Yocto Project manuals.  
                             This repository is where manual development 
                             occurs.  If you plan on contributing back to the 
                             Yocto Project documentation, you should set up 
                             a local Git repository based on this upstream 
                             repository as follows:

                               git clone git://git.yoctoproject.org/yocto-docs

                             Changes and patches are first pushed to the 
                             yocto-docs Git repository.  Later, they make it 
                             into the poky Git repository found at 
                             git://git.yoctoproject.org/poky.  

Manual Organization
===================

Folders exist for individual manuals as follows:

* adt-manual       - The Yocto Project Application Development Toolkit (ADT)
                     User's Guide.
* bsp-guide        - The Yocto Project Board Support (BSP) Developer's Guide
* dev-manual       - The Yocto Project Development Manual
* kernel-manual    - The Yocto Project Kernel Architecture and Use Manual
* poky-ref-manual  - The Yocto Project Reference Manual
* yocto-project-qs - The Yocto Project Quick Start
* mega-manual      - The aggregated manual comprised of all YP manuals and guides

Each folder is self-contained regarding content and figures.  Note that there
is a sed file needed to process the links of the mega-manual.  The sed file
is located in the tools directory.  Also note that the figures folder in the 
mega-manual directory contains duplicates of all the figures in the YP folders
directories for all YP manuals and guides.

If you want to find HTML versions of the Yocto Project manuals on the web, 
go to http://www.yoctoproject.org and click on the "Documentation" tab.  From 
there you have access to archived documentation from previous releases, current
documentation for the latest release, and "Docs in Progress" for the release 
currently being developed.

In general, the Yocto Project site (http://www.yoctoproject.org) is a great 
reference for both information and downloads.

Makefile
========

The Makefile processes manual directories to create HTML, PDF,
tarballs, etc.  Details on how the Makefile work are documented
inside the Makefile.  See that file for more information.

To build a manual, you run the make command and pass it the name
of the folder containing the manual's contents. 
For example, the following command run from the documentation directory 
creates an HTML and a PDF version of the ADT manual.
The DOC variable specifies the manual you are making:

     $ make DOC=adt-manual

poky.ent
========

This file defines variables used for documentation production.  The variables
are used to define release pathnames, URLs for the published manuals, etc.

template
========
Contains various templates, fonts, and some old PNG files.

tools
=====
Contains a tool to convert the DocBook files to PDF format.  This folder also
contains the mega-manual.sed file, which is used by Makefile to process 
cross-references from within the manual that normally go to an external 
manual.