10444 2016-10-17 13:07:20 +0000 Suggested documentation to explain line joining 2016-10-19 18:44:32 +0000 1 1 9 Documentation BitBake User Manual bitbake-manual 2.2 x86 Multiple RESOLVED FIXED 19 Oct 2016: RESOLVED Undecided normal 2.3 M1 1 ulfalizer srifenbark srifenbark --- --- Done (doc changes complete) oldest_to_newest 67291 0 ulfalizer 2016-10-17 13:07:20 +0000 Hello Scott, It's not documented how line joining works. This is mostly stuff that people figure out quickly anyway, but it doesn't hurt to cover it in some detail. Here's a suggested new section: 3.1.2. Line joining Outside of [functions](https://www.yoctoproject.org/docs/2.2/bitbake-user-manual/bitbake-user-manual.html#functions) , BitBake joins any line ending in "\" with the following line before parsing statements. This is most commonly used to split variable assignments over multiple lines, as in the following example: FOO = "bar \ baz \ qaz" Both the backslash and the newline that follows it are removed when joining lines, so no newlines end up in the value of FOO. As another example, the two assignments below both assign "barbaz" to FOO: FOO = "barbaz" FOO = "bar\ baz" Note { BitBake does not interpet escape sequences like '\n' in variable values. For these to have an effect, the value must be passed to some utility that interprets escape sequences, like 'printf' or 'echo -n'. } Cheers, Ulf 67292 1 ulfalizer 2016-10-17 13:08:35 +0000 Typo: "interpet" should be "interpret" 67372 2 srifenbark 2016-10-19 16:11:40 +0000 Ulf, Here is the new section - http://www.yoctoproject.org/docs/2.2/bitbake-user-manual/bitbake-user-manual.html#line-joining. I did a bit of word smithing. Thanks, Scott 67379 3 ulfalizer 2016-10-19 18:20:10 +0000 Thanks! I'd write "newline" rather than "new line" to make it clear that it's talking about a character rather than about an entire line. That seems to be the convention from looking at https://en.wikipedia.org/wiki/Newline as well. The rest looks fine. Cheers, Ulf 67381 4 srifenbark 2016-10-19 18:44:32 +0000 Hi Ulf, Okay - good point. I changed it. See http://www.yoctoproject.org/docs/2.2/bitbake-user-manual/bitbake-user-manual.html#line-joining. I am going to set as RESOLVED and put the doc flag at "done." Thanks, Scott