I was under the impression from the POSIX specs for sed that it is necessary to left-align the text on the line following the i\ command, unless you want leading whitespace in the output.A quick test on my Mac (using BSD sed) shows that perhaps this is not necessary:$ cat test.sed #!/bin/sed -fi\      This line starts with spaces.$ echo some text | sed -f test.sedThis line starts with spaces.some text$ However, I can't seem to find this documented anywhere.  It's not in the POSIX specs, and it's not even in sed's man page on my system.Can I rely on this behavior in sed scripts which I want to be portable?  How portable is it?(Is it documented anywhere?)(Bonus question: Is it even possible to force sed to insert whitespace at the beginning of a fixed line passed to i\?)
Is it portable to indent the argument to sed's 'i\' command?
sed;posix;portability
Yes, it should be portable as long as you escape any leading blank. Why ? Because some seds strip blank characters from text lines and the only way to avoid that is to escape the leading blank, as these manual pages dating back from the last century explain: 1, 2, 3The same goes for BSD sed (OSX just copied the code, it's not their extension) and if you check the archives and read the man page from BSD 2.11 it's pretty clear:(1)i\text  .......  An argument denoted text consists of one or more lines, all but the  last of which end with '\' to hide the newline.  Backslashes in text  are treated like backslashes in the replacement string of an 's'  command, and may be used to protect initial blanks and tabs against  the stripping that is done on every script line.Now, where is this documented in the POSIX spec ? It only saysThe argument text shall consist of one or more lines. Each embedded  <newline> in the text shall be preceded by a  <backslash>. Other   <backslash> characters in text shall be removed, and the following  character shall be treated literally.and if you scroll down under RATIONALE it saysThe requirements for acceptance of  <blank> and  <space> characters in  command lines has been made more explicit than in early proposals to  describe clearly the historical practice and to remove confusion about  the phrase protect initial blanks [sic] and tabs from the stripping  that is done on every script line that appears in much of the  historical documentation of the sed utility description of text. (Not  all implementations are known to have stripped  <blank> characters from  text lines, although they all have allowed leading  <blank> characters  preceding the address on a command line.)Since the part with backslashes may be used to was not included in that quote, the remaining phrase protect initial blanks... doesn't make any sense...1Anyway, to sum up: some implementations did (and some still do) strip blanks from text lines. However, since the POSIX spec to which all implementations should comply saysOther <backslash> characters in text shall be removed, and the  following character shall be treated literally.we can conclude that the portable way to indent the lines in the text-to-be-inserted is by escaping the leading blank on each of those lines.1: I also don't understand why OSX/BSD people have changed the entire paragraph in the man page without altering the source code - you get the same behavior as before but the man section that documents this stuff is no longer there. 