<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Dec 1, 2016 at 12:12 PM, Jani Nikula <span dir="ltr"><<a href="mailto:jani.nikula@linux.intel.com" target="_blank">jani.nikula@linux.intel.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><span class="gmail-">On Wed, 30 Nov 2016, Daniel Vetter <<a href="mailto:daniel@ffwll.ch">daniel@ffwll.ch</a>> wrote:<br>
> On Tue, Nov 29, 2016 at 05:00:55PM +0000, Robert Bragg wrote:<br>
</span><span class="gmail-">>> +.. kernel-doc:: drivers/gpu/drm/i915/i915_<wbr>perf.c<br>
>> +   :functions: i915_perf_init<br>
>> +.. kernel-doc:: drivers/gpu/drm/i915/i915_<wbr>perf.c<br>
>> +   :functions: i915_perf_fini<br>
>> +.. kernel-doc:: drivers/gpu/drm/i915/i915_<wbr>perf.c<br>
>> +   :functions: i915_perf_register<br>
>> +.. kernel-doc:: drivers/gpu/drm/i915/i915_<wbr>perf.c<br>
>> +   :functions: i915_perf_unregister<br>
>> +.. kernel-doc:: drivers/gpu/drm/i915/i915_<wbr>perf.c<br>
>> +   :functions: i915_perf_open_ioctl<br>
>> +.. kernel-doc:: drivers/gpu/drm/i915/i915_<wbr>perf.c<br>
>> +   :functions: i915_perf_release<br>
><br>
> One potential issue with listing everything explicitly is that if someone<br>
> ever (and this is bound to happen) adds a new function, they'll forget to<br>
> add it. Hence we just pull them all in, and if you want to refernce some<br>
> specifically, do that in the overview sections.<br>
<br>
</span>One real issue with listing everything separately is that kernel-doc<br>
parses the source file once per every kernel-doc directive.<br></blockquote><div><br>Yeah, this is unfortunate and I'd originally hoped I could pass an ordered list which could reduce how often kernel-doc is run. In practice I haven't seen a performance problem with doing this though.<br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
Also, doesn't Sphinx complain about not having a blank line to end the<br>
indented block after the directive? It might not, but I thought it<br>
might.<br></blockquote><div><br></div><div>Apparently it's ok, I've been generating and previewing the documentation and haven't seen a warning about this.<br><br></div><div>From the restructure text spec, regarding white space:<br>"Blank lines may be omitted when the markup makes element separation
unambiguous, in conjunction with indentation."<br><br></div><div>Regards,<br></div><div>- Robert<br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
BR,<br>
Jani.<br>
<span class="gmail-HOEnZb"><font color="#888888"><br>
<br>
--<br>
Jani Nikula, Intel Open Source Technology Center<br>
</font></span></blockquote></div><br></div></div>