On Thu, 2009-03-05 at 15:19 -0800, Randy Dunlap wrote: > Do we have a document style guide? The comments in Documentation/CodingStyle > apply to documentation text files also, AFAIK. Maybe that needs to be > stated explicitly. I guess you could assume it applies, but I don't think it's content can really be applied to Documents.. Since it speaks specifically to code. > As for other docs that don't conform: we typically don't go around just > fixing 80-column rule infractions, but when a file is being modified anyway, > we prefer that other parts of it also be updated. I don't have a problem fixing it, but it would be nice to have any other rules layed out. Like the "No ascii art rule" (if it exists) or whatever other style guidelines there are. For example the 80 line limit can't apply to absolutely everything. I mean what about diagrams or /proc output samples? Most of that is over 80 (way over). Daniel -- To unsubscribe from this list: send the line "unsubscribe linux-tip-commits" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
|