On Tuesday, August 23, 2011 15:17 Walter Bright wrote: > On 8/23/2011 3:09 PM, Jonathan M Davis wrote: > > 40 characters is disgustingly narrow. We may need to cut examples to that > > sort of length for the sake of e-books, but I'm willing to bet that > > something like 3/4 of the examples would have to be wrapped because of > > that. It's a serious downgrade for anyone reading them on a computer. > > It's not that bad. I did it for the Digital Mars C examples. > > I just want to make the point that the Phobos implementation code will > necessarily follow a different formatting style than the example code. It's > just a fact of life, and it isn't just for ebooks. Take a look at any > programming book, magazine article, etc. > > Vertical space is also at a premium for example code.
Well, I've been keeping documentation (including examples) to a hard limit of 80 characters, whereas the actual code only has a soft limit of 80 characters. I understand if examples have to have a shorter line limit due to how they're presented, but the shorter the limit, the more restrictive and annoying it gets. - Jonathan M Davis