On Fri, Dec 16, 2011 at 12:52, Josh Durgin <josh.durgin@xxxxxxxxxxxxx> wrote: > I've been documenting the librados C api, and would like to get some > feedback on the format being used. For each function, the format is > generally: > > /** > * Short description > * Personally I've never been crazy about the "*" prefix on every line, it looks just like extra work without value to me. Doxygen itself is perfectly happy with just /** Short description blah blah */ But whatever makes sense for you guys. -- To unsubscribe from this list: send the line "unsubscribe ceph-devel" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html