summaryrefslogtreecommitdiffstats
path: root/documentation/README
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2013-07-08 10:57:48 +0300
committerRichard Purdie <richard.purdie@linuxfoundation.org>2013-08-13 13:18:36 +0100
commitd917158ff68cbdddd1c1b3506df899c9acea86ac (patch)
tree66fdbbe468ca376849f3dfbe4abfa556fae4f605 /documentation/README
parente5dae1b9809aef993c6e2abd3769ae1337de7bc2 (diff)
downloadpoky-d917158ff68cbdddd1c1b3506df899c9acea86ac.tar.gz
README: Updated the file to reflect current state of documentation
This file was out of date. I replaced the kernel-manual descriptions with dev-kernel. Also, added the profiling manual. Finally, changed the poky-ref-manual string to ref-manual. (From yocto-docs rev: a1e60078dcfcfd5a912d78f981fe70dc1aa33e37) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/README')
-rw-r--r--documentation/README65
1 files changed, 31 insertions, 34 deletions
diff --git a/documentation/README b/documentation/README
index 911484cb99..d01678d4f4 100644
--- a/documentation/README
+++ b/documentation/README
@@ -2,60 +2,60 @@ documentation
2============= 2=============
3 3
4This is the directory that contains the Yocto Project documentation. The Yocto 4This is the directory that contains the Yocto Project documentation. The Yocto
5Project source repositories at http://git.yoctoproject.org/cgit.cgi have two 5Project source repositories at http://git.yoctoproject.org/cgit.cgi have two
6instances of the "documentation" directory. You should understand each of 6instances of the "documentation" directory. You should understand each of
7these instances. 7these instances.
8 8
9 poky/documentation - The directory within the poky Git repository containing 9 poky/documentation - The directory within the poky Git repository containing
10 the set of Yocto Project manuals. When you clone the 10 the set of Yocto Project manuals. When you clone the
11 poky Git repository, the documentation directory 11 poky Git repository, the documentation directory
12 contains the manuals. The state of the manuals in this 12 contains the manuals. The state of the manuals in this
13 directory is guaranteed to reflect the latest Yocto 13 directory is guaranteed to reflect the latest Yocto
14 Project release. The manuals at the tip of this 14 Project release. The manuals at the tip of this
15 directory will also likely contain most manual 15 directory will also likely contain most manual
16 development changes. 16 development changes.
17 17
18 yocto-docs/documentation - The Git repository for the Yocto Project manuals. 18 yocto-docs/documentation - The Git repository for the Yocto Project manuals.
19 This repository is where manual development 19 This repository is where manual development
20 occurs. If you plan on contributing back to the 20 occurs. If you plan on contributing back to the
21 Yocto Project documentation, you should set up 21 Yocto Project documentation, you should set up
22 a local Git repository based on this upstream 22 a local Git repository based on this upstream
23 repository as follows: 23 repository as follows:
24 24
25 git clone git://git.yoctoproject.org/yocto-docs 25 git clone git://git.yoctoproject.org/yocto-docs
26 26
27 Changes and patches are first pushed to the 27 Changes and patches are first pushed to the
28 yocto-docs Git repository. Later, they make it 28 yocto-docs Git repository. Later, they make it
29 into the poky Git repository found at 29 into the poky Git repository found at
30 git://git.yoctoproject.org/poky. 30 git://git.yoctoproject.org/poky.
31 31
32Manual Organization 32Manual Organization
33=================== 33===================
34 34
35Folders exist for individual manuals as follows: 35Folders exist for individual manuals as follows:
36 36
37* adt-manual - The Yocto Project Application Development Toolkit (ADT) 37* adt-manual - The Yocto Project Application Developer's Guide.
38 User's Guide. 38* bsp-guide - The Yocto Project Board Support Package (BSP) Developer's Guide
39* bsp-guide - The Yocto Project Board Support (BSP) Developer's Guide
40* dev-manual - The Yocto Project Development Manual 39* dev-manual - The Yocto Project Development Manual
41* kernel-manual - The Yocto Project Kernel Architecture and Use Manual 40* kernel-dev - The Yocto Project Linux Kernel Development Manual
42* poky-ref-manual - The Yocto Project Reference Manual 41* ref-manual - The Yocto Project Reference Manual
43* yocto-project-qs - The Yocto Project Quick Start 42* yocto-project-qs - The Yocto Project Quick Start
44* mega-manual - The aggregated manual comprised of all YP manuals and guides 43* mega-manual - An aggregated manual comprised of all YP manuals and guides
44* profile-manual - The Yocto Project Profile and Tracing Manual
45 45
46Each folder is self-contained regarding content and figures. Note that there 46Each folder is self-contained regarding content and figures. Note that there
47is a sed file needed to process the links of the mega-manual. The sed file 47is a sed file needed to process the links of the mega-manual. The sed file
48is located in the tools directory. Also note that the figures folder in the 48is located in the tools directory. Also note that the figures folder in the
49mega-manual directory contains duplicates of all the figures in the YP folders 49mega-manual directory contains duplicates of all the figures in the YP folders
50directories for all YP manuals and guides. 50directories for all YP manuals and guides.
51 51
52If you want to find HTML versions of the Yocto Project manuals on the web, 52If you want to find HTML versions of the Yocto Project manuals on the web,
53go to http://www.yoctoproject.org and click on the "Documentation" tab. From 53go to http://www.yoctoproject.org and click on the "Documentation" tab. From
54there you have access to archived documentation from previous releases, current 54there you have access to archived documentation from previous releases, current
55documentation for the latest release, and "Docs in Progress" for the release 55documentation for the latest release, and "Docs in Progress" for the release
56currently being developed. 56currently being developed.
57 57
58In general, the Yocto Project site (http://www.yoctoproject.org) is a great 58In general, the Yocto Project site (http://www.yoctoproject.org) is a great
59reference for both information and downloads. 59reference for both information and downloads.
60 60
61Makefile 61Makefile
@@ -66,8 +66,8 @@ tarballs, etc. Details on how the Makefile work are documented
66inside the Makefile. See that file for more information. 66inside the Makefile. See that file for more information.
67 67
68To build a manual, you run the make command and pass it the name 68To build a manual, you run the make command and pass it the name
69of the folder containing the manual's contents. 69of the folder containing the manual's contents.
70For example, the following command run from the documentation directory 70For example, the following command run from the documentation directory
71creates an HTML and a PDF version of the ADT manual. 71creates an HTML and a PDF version of the ADT manual.
72The DOC variable specifies the manual you are making: 72The DOC variable specifies the manual you are making:
73 73
@@ -86,9 +86,6 @@ Contains various templates, fonts, and some old PNG files.
86tools 86tools
87===== 87=====
88Contains a tool to convert the DocBook files to PDF format. This folder also 88Contains a tool to convert the DocBook files to PDF format. This folder also
89contains the mega-manual.sed file, which is used by Makefile to process 89contains the mega-manual.sed file, which is used by Makefile to process
90cross-references from within the manual that normally go to an external 90cross-references from within the manual that normally go to an external
91manual. 91manual.
92
93
94