Describe the role of tags and mapping objects as abstractions.
Describe static vs dynamic transaction types and give a brief overview
of the set of functions and object life cycles used for static vs
dynamic.
While here, fix a few other typos.
Differential D16652
Add an overview section to bus_dma.9. jhb on Aug 9 2018, 6:59 PM. Authored by Tags None Referenced Files
Details
Describe the role of tags and mapping objects as abstractions. While here, fix a few other typos.
Diff Detail
Event TimelineComment Actions Other than an inconsistency in how you're adding newlines after , I like it.
Comment Actions I'm not a fan of the lines-terminating-at-commas style but it's not an issue. Thanks for writing this.
Comment Actions Hmm, I'll defer to the @wblock or the like on ASCII ()'s. In general I prefer to let the markup pick how it wants to render markup instead of doing the rendering directly (so prefer to use tags than not), but I do think there might be something different there for parentheses.
Comment Actions
Comment Actions
This might be a bit much (and it ended up being quite a bit long), but Comment Actions Seems kind of long. It's unfortunate we don't really have an existing pattern for manual page examples. One option that might be too "cute" would be to dump the code in sys/dev/helloworld, annotate in helloworld.4, and refer to that (with slightly more context than just bare .Xr) from this page. The straightforward thing might be adding a bus_dma_example.9? Comment Actions I'll see if maybe there's a good place for the extended example in the developer handbook. |