forked from brl/citadel
94 lines
4.1 KiB
Plaintext
94 lines
4.1 KiB
Plaintext
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:
|
|
|
|
* sdk-manual - The Yocto Project Software Development Kit (SDK) Developer's Guide.
|
|
* bsp-guide - The Yocto Project Board Support Package (BSP) Developer's Guide
|
|
* dev-manual - The Yocto Project Development Tasks Manual
|
|
* kernel-dev - The Yocto Project Linux Kernel Development Tasks Manual
|
|
* ref-manual - The Yocto Project Reference Manual
|
|
* yocto-project-qs - The Yocto Project Quick Start
|
|
* mega-manual - The Yocto Project Mega-Manual, which is an aggregated manual comprised
|
|
of all YP manuals and guides
|
|
* profile-manual - The Yocto Project Profile and Tracing Manual
|
|
* toaster-manual - The Toaster Manual
|
|
|
|
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 version of the SDK manual.
|
|
The DOC variable specifies the manual you are making:
|
|
|
|
$ make DOC=sdk-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.
|