[yocto] docs: how to spell "bitbake", and docbook semantic markup for user input

[Rifenbark, Scott M]

Agreed that BitBake is the correct spelling.  I will be sure to make a sweep through our Yocto manuals and make sure that when we are referring to the tool and not indicating the command they say "BitBake".

Thanks,
ScottR

-----Original Message-----
From: Richard Purdie [mailto:richard.purdie at linuxfoundation.org] 
Sent: Thursday, July 14, 2011 3:02 AM
To: Robert P. J. Day
Cc: Darren Hart; yocto at yoctoproject.org; Rifenbark, Scott M
Subject: Re: [yocto] docs: how to spell "bitbake", and docbook semantic markup for user input

On Thu, 2011-07-14 at 05:46 -0400, Robert P. J. Day wrote:
> On Wed, 13 Jul 2011, Darren Hart wrote:
> 
> > On 07/13/2011 03:48 PM, Joshua Lock wrote:
> > > On Wed, 2011-07-13 at 06:57 -0400, Robert P. J. Day wrote:
> > >> 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.
> > >
> > > I believe it's the latter, at least that's what I've always use.
> > >
> >
> > Agreed:
> >
> > The man page:
> > BitBake - simple tool for the execution of tasks
> >
> > The user manual:
> > BitBake User Manual
> >
> > Those seem like the two lines of documentation that are most likely to
> > be correct :-) So unless Richard or Chris pipe up, I'd go with BitBake.
> 
>   i thought as much, i'm going with that.  not high on any list of
> priorities but while i'm perusing the docs, i might as well make notes
> of what can change, and submit patches for the more obvious stuff.
> 
>   are the small changes i've posted here in acceptable format?  do
> they get ACKed at some point so i can verify they were accepted?

The pieces in poky's documentation directory are part of the yocto-docs
repo which is maintained by Scott (cc'd). Scott is a tech writer rather
than a developer and loves git, er, I mean we might need to help him get
the patches in ;-). Please do send them and we'll figure that bit out
though and will send an acknowledgement when they're merged.

Cheers,

Richard