| Summary: | Some small mostly package-related nits | ||
|---|---|---|---|
| Product: | [Documentation] Reference | Reporter: | ulfalizer |
| Component: | handbook | Assignee: | Scott Rifenbark <srifenbark> |
| Status: | RESOLVED FIXED | QA Contact: | |
| Severity: | normal | ||
| Priority: | Undecided | CC: | poky.doc.watcher, poky.watcher, srifenbark |
| Version: | 2.2 | ||
| Target Milestone: | 2.2 M4 | ||
| Hardware: | x86 | ||
| OS: | Multiple | ||
| Whiteboard: | 12 July 2016: RESOLVED | ||
| OS type for building Yocto: | --- | Type of Regression: | --- |
| Verified: | Documentation change: | Done (doc changes complete) | |
Hi, See http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#var-FILES for the changes to the FILES glossary entry See http://www.yoctoproject.org/docs/2.2/ref-manual/ref-manual.html#usingpoky-debugging-taskrunning for the change to "Running Specific Tasks" section. See http://www.yoctoproject.org/docs/2.2/dev-manual/dev-manual.html#new-recipe-makefile-based-package for the change in the dev-manual. Thanks, Scott Looks good to me. Thanks, Ulf Awesome! Setting to RESOLVED and turning the flag off for docs. scott |
Some small mostly package-related nits Hello! Some small (too small for separate bugs) documentation nits below: * The FILES variable is closely linked to the PACKAGES variable, but the FILES glossary entry does not mention it at all. The first sentence of the FILES glossary entry could be replaced by this: The list of files and directories that are placed in a package. The [PACKAGES] variable lists the packages generated by a recipe. * The FILES glossary entry has a path with a redundant '/' at the end. This is a personal pet peeve because it means you often end up with ugly stuff like "//", plus people start thinking all directory paths have to end with '/'. Here's the fixed version: FILES_${PN} += "${bindir}/mydir1 ${bindir}/mydir2/myfile" * In '2.3.3. Running Specific Tasks', instead of saying "any given package consists of a set of tasks", it would be better to say "any given recipe consists of a set of tasks". People often confuse packages and recipes. * There's another redundant '/' in '5.3.18.3. Makefile-Based Package' in the development manual. Instead of S = "${WORKDIR}/git/" it could just say S = "${WORKDIR}/git" Cheers, Ulf