summaryrefslogtreecommitdiff
path: root/doc
Commit message (Collapse)AuthorAgeFilesLines
* Fail if we try to build a BST_FORMAT_VERSION we do not support anymorejjardon/BST_FORMAT_VERSIONJavier Jardón2019-09-128-8/+8
| | | | | bst-1.x support BST_FORMAT_VERSION == 17, as that is not supported by master I think is ok to set BST_FORMAT_VERSION_MIN = 18
* Update documentation to explain split cachesTristan Maat2019-09-062-0/+59
|
* doc/source/format_declaring.rst: Documenting strict dependenciesTristan Van Berkom2019-08-312-0/+13
| | | | | | This adds documentation on the new keyword `strict` in dependency declarations, and adds a link to the strict mode user config section.
* Move qmake plugin to bst-plugins-experimentalcoldtom/move-qmakeThomas Coldrick2019-08-141-1/+0
|
* Move modulebuild plugin to bst-plugins-experimentalThomas Coldrick2019-08-141-1/+0
| | | | Continuing moving plugins over to bst-plugins-experimental.
* Move makemaker plugin to bst-plugins-experimentalThomas Coldrick2019-08-121-1/+0
| | | | Continuing moving plugins to bst-plugins-experimental.
* Move make plugin to bst-plugins-experimentalcoldtom/move-makeThomas Coldrick2019-08-091-1/+0
|
* Move meson element to bst-plugins-experimentalThomas Coldrick2019-08-081-1/+0
|
* doc/source/core_plugins.rst: bst-external -> bst-plugins-experimentalJavier Jardón2019-08-081-1/+1
|
* Move cmake plugin to bst-plugins-experimentalcoldtom/move-cmakeThomas Coldrick2019-08-081-1/+0
| | | | | | | | | | | | It was agreed on the mailing list to move all plugins to a single repository, before moving them into domain-specific repositories. As a result it seems reasonable to move everything to the bst-plugins-experimental repo as this stepping stone, rather than creating a whole new repo. This commit starts the process of moving things over by moving only the cmake plugin to bst-plugins-experimental, and altering the tests to reflect the new location.
* format_project.rst: Add required push flag to documentationJames Ennis2019-08-061-0/+2
| | | | | When declaring artifact/source servers which we want to push to, we must set a "push" boolean
* doc/source/format_project.rst: Fix tiny typoTristan Maat2019-07-291-2/+1
|
* node: Add 'get_str_list' on 'MappingNode'Benjamin Schubert2019-07-171-1/+1
| | | | | | `mapping.get_sequence(...).as_str_list()` is a very common pattern seen both in plugins and the core. Adding a helper to reduce the number of operations will make usage smoother
* node: document public APIBenjamin Schubert2019-07-151-0/+1
|
* _yaml: Decomission 'dump()'. 'roundtrip_dump' is an equivalent function nowBenjamin Schubert2019-07-151-1/+1
| | | | | Remove completely '_yaml.dump()' and replace all notions and call by 'roundtrip_dump'
* _yaml: Remove 'node_items' and add 'MappingNode.items()'Benjamin Schubert2019-07-151-1/+2
| | | | | | One difference is that 'MappingNode.items()' does not strip the provenance from scalars and lists, which ends up not affecting the code much.
* doc/bst2html: Remove usage of 'node_get' and use new APIBenjamin Schubert2019-07-151-13/+11
|
* doc/source/using_config.rst: Add pull-artifact-files optionRaoul Hidalgo Charman2019-07-111-2/+6
| | | | Part of #1043
* Rename (spawn, fork) -> 'start process'Angelos Evripiotis2019-06-061-2/+2
| | | | | | | | | | | | | | Avoid confusion by not referring to starting another process as 'spawning'. Note that 'spawn' is a process creation method, which is an alternative to forking. Say 'create child process' instead of 'fork' where it doesn't harm understanding. Although we currently only use the 'fork' method for creating subprocesses, there are reasons for us to support 'spawn' in the future. More information on forking and spawning: https://docs.python.org/3/library/multiprocessing.html#contexts-and-start-methods
* _yaml.pyx: Forbid expected_type=Mapping, and remove isinstance checkBenjamin Schubert2019-06-031-3/+2
| | | | | | | | | | | Calls to `isinstance` can be particularily costly. Using type() is much faster. The only known case where the `isinstance` was useful is for dictionnaries where we would ask for a 'Mapping' instead. Disallowing 'Mapping' for expected_type considerably speeds up the calls to this functions. Also add into NEWS
* docs: Update configuring cache serverraoul/1024-artifact-docsRaoul Hidalgo Charman2019-05-314-33/+40
| | | | | | | | Now that we have both artifact and source caches the documentation is updated to reflect that. Some sections headings/links etc. have been expanded and changed. Part of #1025
* doc: Add architecture section on cachesRaoul Hidalgo Charman2019-05-313-0/+71
| | | | Part of #1024
* docs: update to reflect artifact as a protoRaoul Hidalgo Charman2019-05-311-6/+7
| | | | Part of #1024
* Move source from 'buildstream' to 'src/buildstream'Chandan Singh2019-05-213-6/+6
| | | | | | This was discussed in #1008. Fixes #1009.
* Remove OSTree plugin; It lives now in the bst-plugins-experimental repoJavier Jardón2019-05-142-1/+5
|
* doc/source/format_declaring.rst: Fix the YAML blockMathieu Bridon2019-04-221-1/+1
| | | | String starting with a "%" character need to be quoted.
* doc: Fix the build with Sphinx 2.0Mathieu Bridon2019-04-221-1/+1
| | | | | | | | | | | | Sphinx 1.7, released in February 2018 moved the sphinx.apidoc module to sphinx.ext.apidoc, with an alias and a deprecation warning in place so users know to port their code. The compatibility alias was removed in Sphinx 2.0, so we need to move to the new module name. Fortunately, since the new module name is more than a year old, this shouldn't break anything for anybody.
* plugintestutils: Rename 'plugintestutils' package to 'testing'phil/rename-plugintestutilsPhil Dawson2019-04-161-1/+1
| | | | | | | | | - Rename plugintestutils to testing. - Don't run the tests from bst-plugins-template. This imports buildstream.plugintestutils so will have to be disabled to get through CI. This can be re nabled once bst-plugins-template has been patched.
* docs: Add generated docs for buildstream.plugintestutilsPhil Dawson2019-04-121-0/+1
|
* using_config.rst: Add source cache documentationRaoul Hidalgo Charman2019-03-251-0/+46
| | | | Part of #440
* format_project.rst: Add source cache documentationRaoul Hidalgo Charman2019-03-251-0/+27
| | | | Part of #440
* Added doc's for workspace reset --softpointswaves/softresetWilliam Salmon2019-03-213-0/+45
|
* docs: Add bst artifact delete to using_commands.rstJames Ennis2019-03-131-0/+7
|
* doc/source/core_plugins.rst: Add link to bst-plugins-containerChandan Singh2019-03-121-0/+1
| | | | | | https://gitlab.com/BuildStream/bst-plugins-container has now had its first (and second and third too) release, add it to the list of known external plugins.
* doc: Show a non-TLS remote-execution config. exampleMartin Blanchard2019-02-282-6/+2
| | | | https://gitlab.com/BuildStream/buildstream/issues/799
* Document how to refer to cross-junction dependencies inlinechandan/junction-dependency-formatChandan Singh2019-02-261-0/+35
| | | | | | In the previous commit, we added support to express cross-junction dependencies inline as simple strings. Document it along with the version in which the feature was added.
* doc: Update configuration examples with 'instance-name'Martin Blanchard2019-02-222-4/+7
|
* doc/./arch_sandboxing: no OSTree artifact cacheaevri/doc_arch_depsAngelos Evripiotis2019-02-201-6/+6
| | | | | As of commit 1f8b4aa290a908a697f008a29ea143a9320dd639, we're no longer using the OSTree artifact cache. Update accordingly.
* doc/./arch_sandboxing: reword 'user provided user'Angelos Evripiotis2019-02-201-1/+1
|
* doc/./arch_sandboxing: 'read only'->'read-only'Angelos Evripiotis2019-02-201-1/+1
| | | | I read this wrong initially, the hyphen would have helped me here.
* doc/./arch_cachekeys: note no direct runtime depsAngelos Evripiotis2019-02-201-0/+3
| | | | | | | | I was mistaken on this point in my first reading. The sentence on strong and weak key equivalency made me check my assumptions. Help others with the same misunderstanding by explicitly calling this out in a new paragraph.
* doc/./arch_cachekeys: consistent full-stopsAngelos Evripiotis2019-02-201-5/+5
|
* doc/./arch_cachekeys: JSON now, not dict pickleAngelos Evripiotis2019-02-201-1/+1
|
* doc/./arch_scheduler: fix 'imerative' typoAngelos Evripiotis2019-02-201-1/+1
|
* doc/./arch_scheduler: fixup "it's" typosAngelos Evripiotis2019-02-201-3/+3
| | | | | | "it's" is always short for "it is" or "it has". The possesive pronoun for "it" is "its", like "his".
* doc/../arch_dependency_model: transient/transitiveAngelos Evripiotis2019-02-201-2/+3
|
* doc/./arch_data_model:edit comp stages for clarityAngelos Evripiotis2019-02-201-3/+4
|
* doc/./arch_data_model: add some missing full-stopsAngelos Evripiotis2019-02-201-11/+11
|
* doc/./arch_data_model: fixup affect/effectAngelos Evripiotis2019-02-201-3/+3
|
* cachedir: add new dir option that's default root to other dirsRaoul Hidalgo Charman2019-02-192-5/+2
| | | | | | Makes artifactdir and builddir obsolete. Fixes #870