docs: how to spell "bitbake", and docbook semantic markup for user input
Robert P. J. Day
just perusing the documentation in my typically pedantic fashion and
a couple questions about style. first, is the proper spelling
"Bitbake" or "BitBake" since the doc source seems to bounce back and
forth and it really should be consistent.
and second, this just doesn't seem right as semantic docbook markup:
"When the <filename>bitbake</filename> command completes ..."
in that context, bitbake is not a filename, it's "userinput". is
there a reason all user input like that is marked up as "filename"?
rday
--
========================================================================
Robert P. J. Day Ottawa, Ontario, CANADA
http://crashcourse.ca
Twitter: http://twitter.com/rpjday
LinkedIn: http://ca.linkedin.com/in/rpjday
========================================================================
a couple questions about style. first, is the proper spelling
"Bitbake" or "BitBake" since the doc source seems to bounce back and
forth and it really should be consistent.
and second, this just doesn't seem right as semantic docbook markup:
"When the <filename>bitbake</filename> command completes ..."
in that context, bitbake is not a filename, it's "userinput". is
there a reason all user input like that is marked up as "filename"?
rday
--
========================================================================
Robert P. J. Day Ottawa, Ontario, CANADA
http://crashcourse.ca
Twitter: http://twitter.com/rpjday
LinkedIn: http://ca.linkedin.com/in/rpjday
========================================================================