Commit Graph

171 Commits

Author SHA1 Message Date
Scott Rifenbark 6fedf7b147 dev-manual: Edits to "Workflows" section.
(From yocto-docs rev: 6b076afb92454b8a7279f747a78bbf565a93c09d)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-04-10 16:20:56 +01:00
Scott Rifenbark 78ec6f7c07 dev-manual: Edits to "Basic Commands" section.
(From yocto-docs rev: 3cd5c68d610d7ec2fe4c8d1ad64b05833bb31425)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-04-10 16:20:56 +01:00
Scott Rifenbark f1c2fea3f8 dev-manual: Edits to "Repositories, Tags, and Branches" section.
(From yocto-docs rev: 6ab8d6441d53871b2e0a7163a31b1505a86872b2)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-04-10 16:20:56 +01:00
Scott Rifenbark 47fda36cec dev-manual: Edits to "Git" section.
(From yocto-docs rev: d9df3683831253bfb63f764c95531d341aea2dbd)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-04-10 16:20:56 +01:00
Scott Rifenbark 3ac6406127 dev-manual: Edits to "Licensing" section.
(From yocto-docs rev: e04a9b4d04872a753ec81e1c4600ee3189d667c0)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-04-10 16:20:56 +01:00
Scott Rifenbark 2477c9c7b2 dev-manual: Edits to "Yocto Project Terms" section.
(From yocto-docs rev: d5742f17daccbaab752e9c82f12dbc9b166bb901)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-04-10 16:20:56 +01:00
Scott Rifenbark c218ec6883 dev-manual: Edits to "Yocto Project Source Repositories" section.
Some minor text editing.  Also, updated two figures to be
more recent.  One for the Index of Releases and one for the
YP Downloads page from the website.  They were very dated.

(From yocto-docs rev: 59255d7c0175a5280239d070ce902079229cf909)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-04-10 16:20:56 +01:00
Scott Rifenbark c589b85305 dev-manual: Edits to "Summary" section.
(From yocto-docs rev: 6c73cc0e01ed10c225eb054eb5ea5a26b989bbdb)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-04-10 16:20:56 +01:00
Scott Rifenbark b7b64ae73f dev-manual: Edits to "Policies and Change Flow" section.
(From yocto-docs rev: 9d4c4fdaec73a0bba3e19872cad24a8c2463da58)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-04-10 16:20:56 +01:00
Scott Rifenbark f09cca6d49 dev-manual: Edits to "Autobuilders" section.
(From yocto-docs rev: 5facb63e7bd0bb9627e83cfc34ae82a3898fe349)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-04-10 16:20:55 +01:00
Scott Rifenbark 47b7e49eb3 dev-manual: Edits to "Source Control Management (SCM)" section.
(From yocto-docs rev: 8e2290f43f37e39ef3aa97e97b73f15978ca1076)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-04-10 16:20:55 +01:00
Scott Rifenbark f04dc51f14 dev-manual: Some edits early in Chapter 3.
(From yocto-docs rev: 566af2c28413eeb89b69a59fab087e0145a9493e)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-04-10 16:20:55 +01:00
Scott Rifenbark 315a3156e1 dev-manual: Updated the "Core System Development" section
Added a new bullet as a tip for best practices that addresses
how we address bug 3071 and 3274.  We are suggesting they enable
a PR Service if they are using continually incrementing PR values
when package feeds are published or used.

Reported-by: Richard Purdie <richard.purdie@linux.com>
(From yocto-docs rev: b90497f139b1b6f7ab5510313eb297d5d7fb4e68)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-03-22 17:08:43 +00:00
Scott Rifenbark 94153bf869 dev-manual: Review comments applied for "Working in team" section
Fixes YOCTO #3274

Re-wordings per Dave Stewarts review comments.

(From yocto-docs rev: 1d8fbc557388e9b86274e58d04cc6e70193e500c)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-03-02 12:57:21 +00:00
Scott Rifenbark f7d2cea755 dev-manual: Review comments added to "Working in Team" section
Fixes YOCTO #3274

Applied several recommended changes for the section describing
best practices when using YP in a team enviornment.  these
changes were from Dave Stewart.

(From yocto-docs rev: 7efc9864dc6757e3cf5c026f3c1785e5947cbfec)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-03-02 12:57:21 +00:00
Scott Rifenbark 63788f1f66 dev-manual: Edits to the "Working in a Team Environment" section.
Fixes YOCTO #3274

Applied various review edits from Richard Purdie.  Additionally,
I ran a spell-check on the chapter and caught some typos.
I fixed these as necessary.

(From yocto-docs rev: 794a13d26bb7a9e268b16f809158a6af58cc3ce8)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-03-02 12:57:20 +00:00
Scott Rifenbark e57f8627be dev-manual: Revision of "Team Environment" section.
Fixes YOCTO #3274

First draft of a re-written section that describes best
practices for scaling the YP over a large development
effort.  this draft is based on Richard Purdie's text
he sent to me.

(From yocto-docs rev: e5135f76946997a0a060dd16c0b62308be4f6048)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-02-14 17:25:45 +00:00
Scott Rifenbark 0ad26c66e0 dev-manual: Updates to expose cross-toolchain recipes.
Added a bulleted list to the "Terms" section to help define
some toolchain recipes such as gcc-cross-initial,
gcc-cross-intermediate, and so forth.

Added a cross-reference link to the term
"Cross-Development Toolchain" in the the "Working Using
Stand-alone Cross-development Toolchains" section.
This gives the reader a way to see more on the toolchain
recipes.

(From yocto-docs rev: 2cb612424c0cf6addfd8bce8a0ef77665c35bd9a)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-02-14 17:24:04 +00:00
Scott Rifenbark 8c58a9cca2 dev-manual: Edits to "Metadata" term.
In the "Terms" section, I enhanced the "Metadata" term to include
a bit about Metadata in the context of the kernel.  This type of
metadata is discussed at length in the YP Linux Kernel Development
Manual.

(From yocto-docs rev: c6f48bc4c33850eaa1dbf5867759a19d373766ce)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-01-27 13:56:04 +00:00
Robert P. J. Day 4c582a8b2e dev-manual: Various fixes for links, typos, and grammar
1. Added "Debian" as a distribution for best results.
2. Fixed a link to the Hob page and two links for the
   Build Appliance.
3. Three typos fixed and a few grammar items fixed.

(From yocto-docs rev: 0b381094ed9cc2d66895d4ad7c63005c8a918eb1)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2013-01-07 14:43:28 +00:00
Scott Rifenbark 72d01bf43d documentation: dev-manual - Removed all trailing whitespace.
(From yocto-docs rev: d117584a589460412a7fc4df15512b0d9c9448c7)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-12-11 16:15:24 +00:00
Robert Cochran 205c7961f3 Documentation: dev-manual - Fixed maintainer link.
I updated a note that points the reader to the maintainers list.  The
note in the master branch pointed the reader to a nonexistent (old) file.

(From yocto-docs rev: d947d6d9bd42562a84ad3ac90e4c2052f421119c)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-12-11 16:15:23 +00:00
Scott Rifenbark 7c88384bb2 documentation: dev-manual - Updated collaboration section
Fixes [YOCTO #3274]

I have added a new area at the bottom of the current
"Using the Yocto Project in a Team Environment" section.
This section is the spot for addressing what Richard Purdie
coined as "How to use YP in a work group."  For now, the
changes are based on the information that Richard placed in
the Bugzilla entry.  Presumably we can build on this information.

(From yocto-docs rev: 92c5d1b6ac6b553fab19410170364dca40123c59)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-12-03 13:53:00 +00:00
Scott Rifenbark c2f14db4e0 documentation: several manuals - Notes and links for filename space issue
Fixes [YOCTO_#3396]

Spaces in file and directory names is an issue for the build
system and throws an error when sourcing the environment
setup script.  I added key notes in several areas of the doc
set.  I also added some cross-references to the oe-init-build-env
section in some other areas where running the script is discussed.

(From yocto-docs rev: 1d102e91ba77391096749bd7df6c05b2b695b33f)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-12-03 13:52:55 +00:00
Scott Rifenbark 2b51188de6 documentation: dev-manual - Final changes before 1.3 lockdown.
Made minor changes as needed due to some new sections, links,
and capitalization standards.

(From yocto-docs rev: bc966e5a78dadd14ecf1896a36e40a9b256bae77)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-23 00:03:13 +01:00
Paul Eggleton fa0415052f documentation: dev-manual - Typo fixed.
(From yocto-docs rev: f64babca3cce710718bbc6b4199ae6ad4002d209)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-15 14:45:10 +01:00
Scott Rifenbark 20a2dda2c2 documentation: bsp-guide, dev-manual, kernel-manual - Removed links
Removing the Appendix A (BSP) example had some rippling affects
throughout the doc set.  There were several links into the appendix.
All these links had to either be modified (if possible) or simply
removed since the appendix will be removed.

(From yocto-docs rev: fff35abd87e945de1806eef63a56a956d104bf92)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-04 14:08:20 +01:00
Paul Eggleton dd7db5cf83 documentation: poky-ref-manual, dev-manual - added link to oe-core
* Explain that we test with a set of reference hardware rather than only
  supporting hardware that we have (avoiding any implication that the
  build system can't support other devices). These are in the
  faq entry in the poky-ref-manual for the question of how we can
  claim Poky / OpenEmbedded-Core is stable.

* Adjust the language so that it is OE-Core friendly, with a link to
  the Development Manual for the definition of OE-Core.

(From yocto-docs rev: 5ff1604dd383b26e918c319fcbe46dd1589cebc5)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-02 17:41:38 +01:00
Scott Rifenbark ebd71dd979 documentation: dev-manual - Better description of location of scripts
The description for where the "scripts" directory lives was not
conforming to our terminology.

(From yocto-docs rev: 925167c446b86ca09d387d01568db64113412311)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-01 23:30:30 +01:00
Scott Rifenbark 452332445a documentation: dev-manual - wording change to remove ambiguity.
(From yocto-docs rev: 01fc1959efa85fdba17beec4a5c565108c6ab68a)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-01 23:30:30 +01:00
Scott Rifenbark 8cd203a46c documentation: dev-manual - formatting change.
(From yocto-docs rev: 8d43e7ff1ad8151a09e12524d9b9afe825322954)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-01 23:30:30 +01:00
Scott Rifenbark 5992839b92 documentation: dev-manual - Buzilla components updated to six.
(From yocto-docs rev: 28480c246f0346d16424837d6be5d45e084e15c3)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-01 23:30:30 +01:00
Scott Rifenbark d399b589b2 documentation: dev-manual - better wording.
For obvious reasons I changed this one :)

(From yocto-docs rev: 5f3203292f46bea799321e4520668252a46fb599)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-01 23:30:29 +01:00
Scott Rifenbark 12ba89a88a documentation: dev-manual - Added link to pull scripts.
(From yocto-docs rev: 87fe511d4114295f8d67705c03ac11983f51cf7a)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-01 23:30:29 +01:00
Scott Rifenbark 332e696958 documenation: dev-manual - added link to section on patching.
(From yocto-docs rev: 6316ef2aa8947d64fb262824b9f57df0e3a8e1c3)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-01 23:30:29 +01:00
Scott Rifenbark 07925515ac documentation: dev-manual - better terminology.
(From yocto-docs rev: 06f1556d10c75134e53ade7bab407623f00b6a87)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-01 23:30:29 +01:00
Scott Rifenbark 6bf96aa1f9 documenation: dev-manual - formatting fix.
(From yocto-docs rev: 24e653c02278d7a3d935104296f54cf9fff9ce12)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-01 23:30:29 +01:00
Scott Rifenbark 8606f28cb4 documenation: dev-manual - clarifies local branch.
(From yocto-docs rev: fff80ac6e0a7092f19a268694f974ff45fb0fe8b)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-01 23:30:29 +01:00
Scott Rifenbark 78aedfa4d4 documentation: dev-manual - grammar fix.
(From yocto-docs rev: eecdc407ae10a9c4146d79735e2e3fce7a031083)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-01 23:30:29 +01:00
Scott Rifenbark a1fc37eabc documenation: dev-manual - updated the key tags example list.
(From yocto-docs rev: 8bdbe16e97be04482d3b06c9cf63bdef6ab49d5a)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-01 23:30:29 +01:00
Scott Rifenbark 5bd37e57e1 documentation: dev-manual - Better wording for repo setup
I improved the wording such that it is not tied to a
x.x type release.  It is more generic here and will survive
better under future releases.

(From yocto-docs rev: 2bd644db7fef71cd2f07f6d3dcbd2ba60b83df08)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-01 23:30:28 +01:00
Scott Rifenbark e25d32bd2f documentation: dev-manual - updated string of example branches.
(From yocto-docs rev: 79171c5c3c805178971ac099471d466e08968bbf)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-01 23:30:28 +01:00
Scott Rifenbark a206035698 documenation: dev-manual - Added "the" in front of YP use.
(From yocto-docs rev: 0bb38edb5a1b855322da2afe2af57d627a573c51)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-01 23:30:28 +01:00
Scott Rifenbark 2977ae4021 documentation: dev-manual - grammar fix.
(From yocto-docs rev: 0c6804e0c9c3721964f5780f6ce6d56ec813fd47)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-01 23:30:28 +01:00
Scott Rifenbark 52780ddb3e documentation: dev-manual - grammar fix.
(From yocto-docs rev: 8611504763fe3d1e8fb95ceb06416e78203741b8)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-01 23:30:28 +01:00
Scott Rifenbark ee198802a3 documentation: dev-manual - First re-write of "Package" term.
(From yocto-docs rev: 735f6b10710f060541de88c9164c9cc1e605d436)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-01 23:30:28 +01:00
Scott Rifenbark 0101e9edf4 documentation: dev-manual - Added QEMU for image target.
(From yocto-docs rev: 6dceb27dd5687e1a6a9ae3ad8decccbaa211376a)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-01 23:30:28 +01:00
Scott Rifenbark 33547c2f0c documentation: dev-manual - grammar fix.
(From yocto-docs rev: a601b39d93d036a0e54f5e4f0b8d0bb052c5ef98)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-01 23:30:27 +01:00
Scott Rifenbark 655264abcf documentation: dev-manual - Fixed buildbot target heading.
(From yocto-docs rev: dc8949b3493b16d3a8ba83aad0ec756c53fcd1cf)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-10-01 23:30:27 +01:00
Scott Rifenbark c4a923bcb0 documentation: Toolchain corrections from tarball to .sh file
For 1.3 there is not longer a toolchain tarball.  Instead, there
is a wrapper script that lets you install the tarball.  This
fundamental usage model change caused several ripples throughout
the documentation set.  I have changed wordings and examples
to reflect the new paradigm.

(From yocto-docs rev: afb2069daa91e04c0f78ba425a6b184cb820d888)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-09-14 09:50:52 +01:00
Scott Rifenbark 64b9137b43 documentation: Fixed links to BitBake User Manual
Robert P. J. Day pointed out a link in the development manual that
was for the BitBake User Manual.  The link resolved to an old,
non-maintained version of BitBake documentation.  According to
Richard Purdie, the BitBake docs referenced should be the ones
that ship in the bitbake/doc/manual directory of poky.  The
YP docs had been using a variable named BITBAKE_DOCS_URL that
also resolved to the antiquated user manual site.  Consequently,
there were many links that needed fixed across both the YP
Development Manual and the YP Reference Manual.  Each of these
references now points in general to the bitbake/doc/manual
directory in poky for more information.

Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: 12f77236b602e9ec43e845c8cec060ad342af19c)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-09-14 09:50:45 +01:00
Scott Rifenbark 0278e3b760 documentation/dev-manual/dev-manual-newbie.xml: Edits to email patch section
I updated the section that describes how to submit a patch through
email while not using the scripts that send patches and request
pulls.

(From yocto-docs rev: 9167b89289134d8d16610cc527d0d71713c0641b)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-09-04 12:55:01 +01:00
Scott Rifenbark d192e6f2ad documentation: Section change for using email to submit patch
Changed the title and a single reference from the Kernel manual
to a title more representative of how these patches are sent -
not using scripts.

(From yocto-docs rev: ff908c34fae88eab9724891a008142a834f34081)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-09-04 12:55:00 +01:00
Scott Rifenbark 2595a2b65e documentation/dev-manual/dev-manual-newbie.xml: Updates to submitting patches
I added text to indicate that using the two scripts for generating
patches and requesting pulls is the preferred method to send
a patch.

(From yocto-docs rev: d6f036a91074dd00c51fe0f937224182fc801b3b)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-09-04 12:55:00 +01:00
Scott Rifenbark 6b357655fe documentation: Section Heading change for pushing commits
Changed the section heading for the part describing how to
push changes upstream via the poky scripts.  Also had to
change one cross-reference to the section in the kernel
manual.

(From yocto-docs rev: be7712aba044238e8781cdf869c5d14e77eb09a2)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-09-04 12:55:00 +01:00
Scott Rifenbark 923563477e documentation/dev-manual: Title Fixes
Fixed several references to books.  There should be no books referenced
using "The" at the beginning of the manual title.  These need to be
"the" in order for correct mega-manual link processing with the
sed script.

(From yocto-docs rev: 76753216c7138d55f7b6f9167d678245ab3134e7)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-09-04 12:54:58 +01:00
Scott Rifenbark 2db4088ced documentation: converted ref-images and ref-features to chapters
As part of moving the reference manual to a real reference manual I
am removing the "appendix" classification and having everthing be
a chapter.  I changed the "ref-imagese" and "ref-features" appendices
to chapters and made any references in the doc set use the proper
term now (chapter).

(From yocto-docs rev: 08117634034a5cd5567c971957583d986c9ee9a4)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-07-17 10:54:11 +01:00
Scott Rifenbark c20cdf677f documentation: Fixed the links to the BitBake Documentation page.
Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
(From yocto-docs rev: ddee80872afc567b9381387980f257b337f29ea1)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-07-17 10:54:10 +01:00
Scott Rifenbark ddafc107cd documentation/dev-manual/dev-manual-newbie.xml: Edits to submitting change
Fixes [YOCTO_#2671]

Added a bit more in here about considering requesting rights to have
a contrib area to YP and OE if user is a regular and significant
contributor.

(From yocto-docs rev: b54bba33b2706bed593a9ee66d5c72f820c37d32)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-07-04 14:48:17 +01:00
Scott Rifenbark 75d007be84 documentation/dev-manual/dev-manual-newbie.xml: edits to sending patch
The section that describes how to send a patch upstream via email
did not have a good connection to the various mailing lists.  I
added some references to this section and also mentioned using
the scripts if the user has many changes to commit.

(From yocto-docs rev: ad75ae45420c43bda974d22b02094237b5c7cc50)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-07-04 14:48:17 +01:00
Scott Rifenbark bf753f8aef documentation/dev-manual/dev-manual-newbie.xml: Fixed typo.
(From yocto-docs rev: d1ca036f11203f842eb87a204487c414ee901818)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-07-04 14:48:17 +01:00
Paul Eggleton 257e61a2cb dev-manual: tidy up "How to Submit a Change" section
* Change some of the language and patch submission directions to
  correctly represent how we work together with OpenEmbedded (this
  changed with the introduction of OE-Core a few releases ago).
* Correct --help option to -h for pull request scripts
* Clarify commit message guidelines
* Touch up a few other bits and pieces

Fixes [YOCTO #2671].

(From yocto-docs rev: 3170ce5e0757951afee13207c117316e33449b39)

Signed-off-by: Paul Eggleton <paul.eggleton@linux.intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-07-04 14:48:15 +01:00
Scott Rifenbark 85673e5466 documentation/dev-manual: Scrub for Yocto Project term
I have replaced the term "Yocto Project" with more appropriate terms
where possible.

(From yocto-docs rev: 622ef9a2b4897ecd151b641b43d7706ab673c989)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-07-03 14:55:02 +01:00
Robert P. J. Day f3e184af04 documentation/dev-manual/dev-manual-newbie.xml: Typos fixed.
Typoes/fixes to chapter 3.

(From yocto-docs rev: 5cf906df6ae8a729a8f10510a89e570ed9d900e7)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-06-21 13:03:07 +01:00
Scott Rifenbark 661acaec76 documentation/dev-manual/dev-manual-newbie.xml: Tag example fixed
The example that creates a local branch based on a release tag
in the "Repositories, Tags, and Branches" section was not optimal.
Darren Hart informed me that naming a local branch the same name
as a tag confuses Git.  Plus, the "-b" option was mis-placed.
Renamed the local branch to have "my-" in front of it and moved
the "-b" option earlier in the command.

(From yocto-docs rev: 29f4ea267ef687431e09eca4634fcb6cc48a6f81)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-05-01 20:50:46 +01:00
Scott Rifenbark 88b3ff0951 documentation/dev-manual/dev-manual-newbie.xml: Fixed branch example
The example in the "Repositories, Tags, and Branches" section that
creates a local branch that tracks the upstream branch is incorrect.
The syntax should be "git checkout -b &DISTRO_NAME; origin/&DISTRO_NAME;

Fixed it.

(From yocto-docs rev: ec80d43ad97370771c9cd7f7e6a4637db5f80e9b)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-05-01 20:50:45 +01:00
Scott Rifenbark 0bb47e87a9 documentation/dev-manual/dev-manual-newbie.xml: Link added for TOPDIR
(From yocto-docs rev: 56d07f8251b78ae8cef3a78836b16eccb2849b89)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-05-01 20:50:45 +01:00
Scott Rifenbark fd7c1df7b6 documentation: Replacements for "1.1" and "edison", etc.
I did a quick and dirty scrub over the manuals for the strings
"1.1" and "edison".  I found some instances that were not properly
variablized.  Also, discovered some references to the
linux-yocto-3.0-1.1.x.  All but one instance of this needed changed
to linux-yocto-3.2.

(From yocto-docs rev: 620fb4b7626defcefc8a039de09ae4599ee7f454)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-04-23 23:04:46 +01:00
Scott Rifenbark 0f25a65a26 documentation/dev-manual/dev-manual-newbie.xml: Added to append term
I added more information to the YP Term "Append Files."

(From yocto-docs rev: e1a7e9b0a790d394e237a0972140107d11178408)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-03-23 14:24:48 +00:00
Scott Rifenbark aa3a201629 documentation/dev-manual: Converted to use poky.ent
I converted the hard links to use the variables as established
in the file poky.ent.

Also, Cleaned up some bad text in the term "Yocto Project Files."
Looks like a cut-and-paste problem.

(From yocto-docs rev: e2e20bf4895d80dae73595e93132f37fb31121d1)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-03-23 14:24:43 +00:00
Scott Rifenbark c25d7fcbf4 documentation/dev-manual/dev-manual-newbie.xml: Fixed typo.
(From yocto-docs rev: be10660d8a0b08731e763dbe761bfbc2e00f9831)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-03-08 12:08:09 -08:00
Scott Rifenbark 2cae64b94f documentation/dev-manual: Re-org of topics
Several topics in the "Common Tasks" chapter really fit better in
the "Newbie" chapter.  I moved these sections out.  I also combined
information from the section on submitting changes from the
"Common Tasks" and the "Newbie" chapter to live in the "Newbie"
chapter only.

(From yocto-docs rev: 90fa8c125e545c57a5a994dd59715b73c5c4882f)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-03-08 12:08:07 -08:00
Scott Rifenbark 25f74b31b7 documentation/dev-manual/dev-manual-newbie.xml: Fixed link
Removed redundant link to manual.

(From yocto-docs rev: 7e7bc327237cae2be3c67e5b711548a16c4d8648)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-03-08 12:08:07 -08:00
Scott Rifenbark c38b2de630 documentation/dev-manual: New Layer section and metadata link anchor
The change to the dev-manual-newbie.xml file was minor.  I added
a link anchor for the term "metadata."

The change to the dev-manual-common-tasks.xml was extensive.  I have
added an entirely new section on layers called "Understanding and
Using Layers."  The new material has several sub-sections.

Information was based on emails from Paul Eggleton.

(From yocto-docs rev: 4fb34abd60180fc2482ddb9f62e476763cee7679)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-03-08 12:08:06 -08:00
Scott Rifenbark 6aeeeba08f documentation/dev-manual: Added anchor point and edits to kernel config
I added a reference anchor to the spot in the dev-manual for the
"Yocto Project Source Repositories".

Other changes were to the bsp guide and were general edits to the
"Linux Kernel Configuration" section.

(From yocto-docs rev: def35923199d48c879ff06a68f81b5cd28d55185)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-03-08 12:08:04 -08:00
Scott Rifenbark c0859cd2b6 documentation/dev-manual: Fixed YP Build Directory Term
Throughout the manual there is a specific term to refer to the
YP build directory: "Yocto Project Build Directory."  This term
was being loosely referred to and was not consisten in linking to
the actual term definition in the Terms chapter.  All this is
fixed.

(From yocto-docs rev: 9229a512a62780a0e52089cc865d0903cbe7c92e)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-03-08 12:08:00 -08:00
Scott Rifenbark 66ce594d28 documentation/dev-manual/dev-manual-newbie.xml: three small corrections
Put in the real link to the YP Source repositories instead of a
click "here" thing.  Put in a reference to the BSP Layer section
from the term layer.  Fixed a grammar type.

(From yocto-docs rev: 6b3b63480f948dad2c5101deedb8deafad291728)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-03-08 12:07:59 -08:00
Scott Rifenbark 7b5215b886 documentation/dev-manual/dev-manual-newbie.xml: edits to build dir term
I beefed up the definition for the term "Yocto Project Build
Directory."  I included the TOPDIR role and also expanded the
discussion on how it is created and the control the user has
over it.

(From yocto-docs rev: d00f30708ccd5fb9e1fc3c8e5240e0ab7a892fe0)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-03-08 12:07:54 -08:00
Scott Rifenbark 9ad6975035 documentation/dev-manual/dev-manual-newbie.xml: Added text anchor
(From yocto-docs rev: d316f9506e0f94ca7bf75f2bdedb509b327b2ded)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-03-08 12:07:54 -08:00
Scott Rifenbark 43e6e25bd5 documentation/dev-manual/dev-manual-newbie.xml: Edits to Git section
Last edits to the "Git" section and the bulleted item that defines
the term "Yocto Project Files."  These edits were from a review of
Joshua Lock.

Reported-by: Joshua Lock <joshua.lock@intel.com>
(From yocto-docs rev: 57cbb06aac566e02bb2e2a1ad05c3ff6dbb0359c)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-03-08 12:07:53 -08:00
Scott Rifenbark b97cdc1c8c documentation/dev-manual: Reference link clean-up
I made another pass through the document and cleaned up some
mistakes and also removed redundant links to manuals where I had
already provided a link to the specific section.

(From yocto-docs rev: 5da8ffe100127f5fe4bfd2b478f177d6bef3a968)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-03-08 12:07:51 -08:00
Scott Rifenbark deddea16d2 documentation/dev-manual/dev-manual-newbie.xml: Git section updated
I split the Git section into a couple sub-sections.  One talks
about concepts and the other is the section on simple commands.
Hopefully the concepts section now addresses the confusion
people are having over branches, tags, etc.

Also changed the definition of the term "Yocto Project Files"
based on some input by Joshua Lock.

(From yocto-docs rev: d76a9942dd12e6bd3ccba5331039477b26c02379)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-03-08 12:07:49 -08:00
Scott Rifenbark 9cfbefcc3d documentation/dev-manual: Edits to clarify YP files
These edits help explain the differences between local YP files
created through a tarball extraction vs cloning a Git repository.

(From yocto-docs rev: ed368800c3e9ece71d27d6d690f0ddc264a4c2da)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-03-08 12:07:49 -08:00
Scott Rifenbark e26a00d262 documentation/dev-manual: Updates to index of releases
Had to update the figure again and I updated the surrounding
text.

(From yocto-docs rev: ed0aea8ad3670aace1eb51ca7a72e75a4c129fba)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-03-08 12:07:39 -08:00
Scott Rifenbark c063c231d1 documentation/dev-manual/dev-manual-newbie.xml: Fixed broken link to Git
Found another broken link to the Git documentation.  They must have changed
this stuff up.  So I set the link to point to the appropriate area in
the Git Community Book.  Talks about distributed workflows.

(From yocto-docs rev: f81d6bbff20629b2b3af73ef53f471090b9d828b)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-03-08 12:07:37 -08:00
Scott Rifenbark f6d3ca28d9 documentation/dev-manual/dev-manual-newbie.xml: fixed broken link
there was a link to some Git documentation referencing workflows that
apparently had gone stale.  I replaced the reference with a link to
the Git Community Book.

(From yocto-docs rev: 7a2cbe4c45eb9bb53d5ddbc014bd6005c2844d56)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2012-03-08 12:07:37 -08:00
Scott Rifenbark 31c4229d3c documentation/dev-manual/dev-manual-newbie.xml: Updates to Bugzilla use
I updated the Bug Tracking section to include rudimentary use of
Bugzilla for entering a new bug.

Fixes [YOCTO #237]

(From yocto-docs rev: 8f2702444812c9dc25195340acebbaae15cd59d7)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2011-11-25 15:24:19 +00:00
Scott Rifenbark 39899b2212 documentation/dev-manual: Edits from Tom Zanussi.
Tom Zanussi provided a review up through part of the "model"
chapter.  I have implemented his comments mosty verbatim.

Reported-by: Tom Zanussi
(From yocto-docs rev: 693d4fadd4b34ffef9953fb1850d381ff7c028a3)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2011-11-25 15:24:17 +00:00
Scott Rifenbark 684c35b7aa documentation: Changed all manual links to point to "latest"
There are many references to YP documentation throughout the
YP manual set.  They used to have hard-coded links to the
current release (e.g. yoctoproject.org/docs/1.1 for Edison).
This created a situation where if you went to a document on
the website and clicked on a external reference to another
manual, you would redirect to the current manual on the website.
Really, you would want to go to the latest manual, which is
one that is under development.  Changing the links to
"yoctoproject.org/docs/latest" makes the tip of master, which
is used for devloping the next release, always have references
to the manuals being developed and not back to the stable
released set of manuals.

This "latest" and "current" scheme for the links is not perfect.
What has to happen when the latest set of the manuals freezes
and becomes the next stable release, all the links in the docs
will need to be changed from "latest" in the URL to the new
release number.  So for example, all the "latest" occurences
would need to be changed to "1.2".  Then for the next cycle
as development begins again, the links need to be infused with
"latest" again.

(From yocto-docs rev: a234aef34303b07671da956de0e94b352797143e)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2011-11-25 15:24:17 +00:00
Robert P. J. Day bf1e5c6413 documentation/dev-manual/dev-manual-newbie.xml: Robert P. J. Edits
Robert suggested some minor wording changes that are good.

(From yocto-docs rev: 50822bc3722e2f3b0a73ed837842ddc5c7595c7b)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2011-11-08 16:26:30 +00:00
Robert P. J. Day 296fd7a7de documentation/dev-manual/dev-manual-newbie.xml: Robert P. J. Edits
Robert ear-marked some links to point to downloads.yoctoproject.org.
He also made several wording changes that resulted in better language
and in a couple of cases fixed incorrect subject/verb usage.

(From yocto-docs rev: 9106619c4264c2669be041c1e6d6124e022ab2d1)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2011-11-08 16:26:30 +00:00
Scott Rifenbark 1d06f45acb documentation/dev-manual: Fixed five broken links and removed note
The restructuring of the web site where we store manuals broke some
links that were cut-and-pasted in from older work.  These slipped by
me so not changing them would direct the user to a 1.0 version of
the externally referenced manual rather than the 1.1 version.

I also got rid of a visible "WRITER'S NOTE" in the document that
was left behind.

(From yocto-docs rev: 1508826312a2fe35e5d693821a4c7737baafcb2e)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2011-10-14 00:31:11 +01:00
Scott Rifenbark f54a78c891 documentation: Fixed links for yocto-1.1
After greping through the documentation directory, I addressed
all the <ulink> statements that used to have yocto-1.0 in the URL.
They are now yocto-1.1.

(From yocto-docs rev: 97d160263c5905fdeaf4ec285bc5359918790581)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2011-10-06 18:41:47 +01:00
Scott Rifenbark 3790c5580a documentation/dev-manual/dev-manual-newbie.xml: added information for licenses
I added the directory where the list of know licenses are in the YP
files structure (meta/files/common-licenses).

(From yocto-docs rev: 6a8db1a5ac653dbc8730e61293221c0b0890888d)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2011-10-04 13:46:38 +01:00
Scott Rifenbark cbcdc22d90 documentation/dev-manual: Added TM to first Eclipse in chapters.
(From yocto-docs rev: 0f8b655da637ebf7708bdfff1473707c9ea3b8ef)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2011-09-25 17:59:59 +01:00
Scott Rifenbark 15793a8210 documentation/dev-manual/dev-manual-newbie.xml: note for maintainer
Added a note indicating where you can find the maintainer for yocto
code.  Suggestion by Robert Berger.

(From yocto-docs rev: 8e55cc4c460582964b0267b4f43c14e7100f17fe)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2011-09-25 17:59:59 +01:00
Scott Rifenbark 7021e04af8 documentation/dev-manual/dev-manual-newbie.xml: addes link to commit page
I provided a link to the OpenEmbedded wiki page created by Mark Hatle
that provides good guidelines on how to create well-formed commit
messages.

(From yocto-docs rev: ea7b0100a7b45c369cb67daa0705dcc5acef40c8)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2011-09-25 17:59:59 +01:00
Scott Rifenbark 2a745da247 documentation/dev-manual/dev-manual-newbie.xml: edits and enhancements.
General pass-through for consistency in referencing sections.
Also, added Darren Hart's review comments for the "Submitting a
Change" section.  I added more about the mailing lists and how to
submit a proper commit message.

(From yocto-docs rev: d9c8f5db8c862b1be724915cc43da6d12b88b97d)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2011-09-25 17:59:58 +01:00
Scott Rifenbark d7dc960e14 documentation/dev-manual/dev-manual-newbie.xml: new terms
I moved the terms "Yocto Project Files" and "Yocto Project Build
Tree" into this development manual.  They were previous defined
in the ADT manual.  It makes more sense to have them where with other
terms.

(From yocto-docs rev: 2133110fd280db8cfbe998e6b46cdee0b260e777)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2011-09-25 17:59:57 +01:00
Scott Rifenbark 524f57771b documentation/dev-manual/dev-manual-newbie.xml: re-write change submit
The section on submitting a change was very sparse and incomplete.
I have significantly upgraded this section to provide more details.

(From yocto-docs rev: af43bb1e4902c45afb5ac4b0f099877acd7a81a2)

Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2011-09-25 17:59:57 +01:00