On Fri, 4 Aug 2006 12:46:48 -0700
David Brownell <[EMAIL PROTECTED]> wrote:

| On Friday 04 August 2006 12:11 pm, Greg KH wrote:
| > On Fri, Aug 04, 2006 at 03:57:45PM -0300, Luiz Fernando N. Capitulino wrote:
| > > Em Fri, 4 Aug 2006 10:09:38 -0700
| > > Greg KH <[EMAIL PROTECTED]> escreveu:
| > > 
| > > | On Fri, Aug 04, 2006 at 02:23:52PM +0000, Luiz Fernando N. Capitulino 
wrote:
| > > | > +/*
| > > | > + * usb_endpoint_dir_in - check whether the endpoint has IN direction
| > > | > + * @epd: endpoint to be checked
| > > | > + *
| > > | > + * Returns positive if the endpoint has IN direction, and zero else
| > > | > + */
| > > 
| > > | Also, please use a real sentence for the description.
| > > 
| > >  Hey, I thought my sentences were real. :)
| > > 
| > >  Could you give an example please?
| 
| "This function ...
| 
| > "Returns positive if the endpoint is of type IN, otherwise it returns
| > zero."
| 
| ... sentences need subjects.

 Well, it's quite common to have a 'implicit' subject in such
documentation. From man pages to in-kernel functions' documentation.

-- 
Luiz Fernando N. Capitulino

-------------------------------------------------------------------------
Take Surveys. Earn Cash. Influence the Future of IT
Join SourceForge.net's Techsay panel and you'll get the chance to share your
opinions on IT & business topics through brief surveys -- and earn cash
http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV
_______________________________________________
linux-usb-devel@lists.sourceforge.net
To unsubscribe, use the last form field at:
https://lists.sourceforge.net/lists/listinfo/linux-usb-devel

Reply via email to