diff options
-rw-r--r-- | documentation/dev-manual/dev-manual-newbie.xml | 40 |
1 files changed, 40 insertions, 0 deletions
diff --git a/documentation/dev-manual/dev-manual-newbie.xml b/documentation/dev-manual/dev-manual-newbie.xml index 6d5650ae05..9d5e7a3646 100644 --- a/documentation/dev-manual/dev-manual-newbie.xml +++ b/documentation/dev-manual/dev-manual-newbie.xml | |||
@@ -1265,6 +1265,46 @@ | |||
1265 | will want to extend, configure or optimize it for their specific uses. | 1265 | will want to extend, configure or optimize it for their specific uses. |
1266 | You should send patches to the appropriate mailing list so that they | 1266 | You should send patches to the appropriate mailing list so that they |
1267 | can be reviewed and merged by the appropriate maintainer. | 1267 | can be reviewed and merged by the appropriate maintainer. |
1268 | </para> | ||
1269 | |||
1270 | <para> | ||
1271 | Before submitting any change, be sure to find out who you should be | ||
1272 | notifying. | ||
1273 | Several methods exist through which you find out who you should be copying | ||
1274 | or notifying: | ||
1275 | <itemizedlist> | ||
1276 | <listitem><para><emphasis>Maintenance File:</emphasis> | ||
1277 | Examine the <filename>maintainers.inc</filename> file, which is | ||
1278 | located in the | ||
1279 | <link linkend='source-directory'>Source Directory</link> | ||
1280 | at <filename>meta-yocto/conf/distro/include</filename>, to | ||
1281 | see who is responsible for code. | ||
1282 | </para></listitem> | ||
1283 | <listitem><para><emphasis>Board Support Package (BSP) README Files:</emphasis> | ||
1284 | For BSP maintainers of supported BSPs, you can examine | ||
1285 | individual BSP <filename>README</filename> files. | ||
1286 | Alternatively, you can examine the | ||
1287 | <filename>MAINTAINERS</filename> file, which is found in the | ||
1288 | <filename>meta-intel</filename>, for a list of all supported | ||
1289 | BSP maintainers. | ||
1290 | </para></listitem> | ||
1291 | <listitem><para><emphasis>Search by File:</emphasis> | ||
1292 | Using <link linkend='git'>Git</link>, you can enter the | ||
1293 | following command to bring up a short list of all commits | ||
1294 | against a specific file: | ||
1295 | <literallayout class='monospaced'> | ||
1296 | git shortlog -- <filename> | ||
1297 | </literallayout> | ||
1298 | Just provide the name of the file for which you are interested. | ||
1299 | The information returned is not ordered by history but does | ||
1300 | include a list of all committers grouped by name. | ||
1301 | From the list, you can see who is responsible for the bulk of | ||
1302 | the changes against the file. | ||
1303 | </para></listitem> | ||
1304 | </itemizedlist> | ||
1305 | </para> | ||
1306 | |||
1307 | <para> | ||
1268 | For a list of the Yocto Project and related mailing lists, see the | 1308 | For a list of the Yocto Project and related mailing lists, see the |
1269 | "<ulink url='&YOCTO_DOCS_REF_URL;#resources-mailinglist'>Mailing lists</ulink>" section in | 1309 | "<ulink url='&YOCTO_DOCS_REF_URL;#resources-mailinglist'>Mailing lists</ulink>" section in |
1270 | the Yocto Project Reference Manual. | 1310 | the Yocto Project Reference Manual. |