From 6c308c84ea817fc469ca34afedeb5183f46349f5 Mon Sep 17 00:00:00 2001 From: Sam Thursfield Date: Thu, 26 Oct 2017 11:33:43 +0000 Subject: Rename README so it gets rendered as Markdown in gitlab.com --- README | 53 ----------------------------------------------------- README.md | 53 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 53 insertions(+), 53 deletions(-) delete mode 100644 README create mode 100644 README.md diff --git a/README b/README deleted file mode 100644 index 5300b874..00000000 --- a/README +++ /dev/null @@ -1,53 +0,0 @@ -Baserock reference system definitions -===================================== - -Baserock is a system for developing embedded and appliance Linux systems. For -more information, see . - -These are some example definitions for use with Baserock tooling. You can fork -this repo and develop your own systems directly within it, or use it as a -reference point when developing your own set of definitions. - -The systems listed in the elements/systems/ directory are example systems -that build and run at some point. The only ones we can be sure -that still build in current master of definitions are the ones that -we keep building in our ci system; they are listed in -http://git.baserock.org/cgit/baserock/baserock/definitions.git/tree/clusters/ci.morph - -BuildStream conversions ------------------------ - -It is possible to use BuildStream to build Baserock definitions. The -BuildStream build tool uses a different definitions format, so a conversion -needs to be done first. - -Run the `convert` script from the root of the repository and you will be -rewarded with an autogenerated set of .bst files in the elements/ subdirectory -which should be buildable using BuildStream. - -To run `convert`, you will need defs2bst and ybd. The following commands, run -from the root of the repository, should be enough to do a conversion: - - git clone https://gitlab.com/BuildStream/defs2bst/ - git clone https://gitlab.com/baserock/ybd/ - ./convert - -You can then build e.g. a devel-system using BuildStream: - - bst build systems/devel-system-content.bst - -Some things are not supported by the BuildStream conversion tool, and will need -to be manually dealt with. - - * the build-essential stratum isn't automatically converted, the - elements/gnu-toolchain.bst element is its equivalent and needs to be - manually kept in sync with any changes - - * .configure and .write extensions need to be rewritten as BuildStream - elements - - * non-x86_64 systems aren't automatically converted; BuildStream supports - "arch conditionals" which should make it easier for a single tree of .bst - files to support many platforms, but it's not easy to automatically achieve - this in places like linux.bst where Baserock currently has many different - equivalents diff --git a/README.md b/README.md new file mode 100644 index 00000000..5300b874 --- /dev/null +++ b/README.md @@ -0,0 +1,53 @@ +Baserock reference system definitions +===================================== + +Baserock is a system for developing embedded and appliance Linux systems. For +more information, see . + +These are some example definitions for use with Baserock tooling. You can fork +this repo and develop your own systems directly within it, or use it as a +reference point when developing your own set of definitions. + +The systems listed in the elements/systems/ directory are example systems +that build and run at some point. The only ones we can be sure +that still build in current master of definitions are the ones that +we keep building in our ci system; they are listed in +http://git.baserock.org/cgit/baserock/baserock/definitions.git/tree/clusters/ci.morph + +BuildStream conversions +----------------------- + +It is possible to use BuildStream to build Baserock definitions. The +BuildStream build tool uses a different definitions format, so a conversion +needs to be done first. + +Run the `convert` script from the root of the repository and you will be +rewarded with an autogenerated set of .bst files in the elements/ subdirectory +which should be buildable using BuildStream. + +To run `convert`, you will need defs2bst and ybd. The following commands, run +from the root of the repository, should be enough to do a conversion: + + git clone https://gitlab.com/BuildStream/defs2bst/ + git clone https://gitlab.com/baserock/ybd/ + ./convert + +You can then build e.g. a devel-system using BuildStream: + + bst build systems/devel-system-content.bst + +Some things are not supported by the BuildStream conversion tool, and will need +to be manually dealt with. + + * the build-essential stratum isn't automatically converted, the + elements/gnu-toolchain.bst element is its equivalent and needs to be + manually kept in sync with any changes + + * .configure and .write extensions need to be rewritten as BuildStream + elements + + * non-x86_64 systems aren't automatically converted; BuildStream supports + "arch conditionals" which should make it easier for a single tree of .bst + files to support many platforms, but it's not easy to automatically achieve + this in places like linux.bst where Baserock currently has many different + equivalents -- cgit v1.2.1