diff options
Diffstat (limited to 'bitbake/doc/bitbake-user-manual')
-rw-r--r-- | bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.rst | 31 |
1 files changed, 0 insertions, 31 deletions
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.rst b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.rst index 6760b10828..93ac18b78a 100644 --- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.rst +++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.rst | |||
@@ -569,37 +569,6 @@ password, and fetches a Revision based on a Label: :: | |||
569 | 569 | ||
570 | You should always set S to "${WORKDIR}/p4" in your recipe. | 570 | You should always set S to "${WORKDIR}/p4" in your recipe. |
571 | 571 | ||
572 | By default, the fetcher strips the depot location from the local file paths. In | ||
573 | the above example, the content of ``example-depot/main/source/`` will be placed | ||
574 | in ``${WORKDIR}/p4``. For situations where preserving parts of the remote depot | ||
575 | paths locally is desirable, the fetcher supports two parameters: | ||
576 | |||
577 | - *"module":* | ||
578 | The top-level depot location or directory to fetch. The value of this | ||
579 | parameter can also point to a single file within the depot, in which case | ||
580 | the local file path will include the module path. | ||
581 | - *"remotepath":* | ||
582 | When used with the value "``keep``", the fetcher will mirror the full depot | ||
583 | paths locally for the specified location, even in combination with the | ||
584 | ``module`` parameter. | ||
585 | |||
586 | Here is an example use of the the ``module`` parameter: :: | ||
587 | |||
588 | SRC_URI = "p4://user:passwd@example-depot/main;module=source/..." | ||
589 | |||
590 | In this case, the content of the top-level directory ``source/`` will be fetched | ||
591 | to ``${P4DIR}``, including the directory itself. The top-level directory will | ||
592 | be accesible at ``${P4DIR}/source/``. | ||
593 | |||
594 | Here is an example use of the the ``remotepath`` parameter: :: | ||
595 | |||
596 | SRC_URI = "p4://user:passwd@example-depot/main;module=source/...;remotepath=keep" | ||
597 | |||
598 | In this case, the content of the top-level directory ``source/`` will be fetched | ||
599 | to ``${P4DIR}``, but the complete depot paths will be mirrored locally. The | ||
600 | top-level directory will be accessible at | ||
601 | ``${P4DIR}/example-depot/main/source/``. | ||
602 | |||
603 | .. _repo-fetcher: | 572 | .. _repo-fetcher: |
604 | 573 | ||
605 | Repo Fetcher (``repo://``) | 574 | Repo Fetcher (``repo://``) |