| Message ID | 20161114115825.22050-3-daniel.vetter@ffwll.ch (mailing list archive) |
|---|---|
| State | New, archived |
| Headers | show |
On Mon, Nov 14, 2016 at 12:58:17PM +0100, Daniel Vetter wrote: > Would be great if everony could add everyone > $ make DOCBOOKS="" htmldocs > > to their build scripts to catch these. 0day should also report them, > not sure why it failed to spot this. "make IGNORE_DOCBOOKS=1 SPHINXOPTS=-W htmldocs" is that outdated? I don't often run it since it is too slow when checking hundreds of patches. Any chance of an incremental patch checker? > Fixes: b42fe9ca0a1e ("drm/i915: Split out i915_vma.c") > Cc: Tvrtko Ursulin <tvrtko.ursulin@intel.com> > Cc: Chris Wilson <chris@chris-wilson.co.uk> > Cc: Joonas Lahtinen <joonas.lahtinen@linux.intel.com> > Signed-off-by: Daniel Vetter <daniel.vetter@intel.com> Reviewed-by: Chris Wilson <chris@chris-wilson.co.uk> (I'm not even going to ask how it appears three times in the docs and how that all works :) -Chris
On Tue, Nov 15, 2016 at 10:44:29AM +0000, Chris Wilson wrote: > On Mon, Nov 14, 2016 at 12:58:17PM +0100, Daniel Vetter wrote: > > Would be great if everony could add > > everyone > > > $ make DOCBOOKS="" htmldocs > > > > to their build scripts to catch these. 0day should also report them, > > not sure why it failed to spot this. > > "make IGNORE_DOCBOOKS=1 SPHINXOPTS=-W htmldocs" is that outdated? IGNORE_DOCBOOKS=1 was renamed to DOCBOOKS="". And incremental builds (at least in my experience here) are really fast with sphinx (a few seconds at most). So should be good enough for a git rebase -x type checking. > I don't often run it since it is too slow when checking hundreds of > patches. Any chance of an incremental patch checker? As long as you make sure you entirely avoid the old docbook horror show, incremental builds should be real fast. The initial build can take a while, but again if you avoid docbook it's reasonable fast imo. Full kernel rebuilds are still much worse. > > Fixes: b42fe9ca0a1e ("drm/i915: Split out i915_vma.c") > > Cc: Tvrtko Ursulin <tvrtko.ursulin@intel.com> > > Cc: Chris Wilson <chris@chris-wilson.co.uk> > > Cc: Joonas Lahtinen <joonas.lahtinen@linux.intel.com> > > Signed-off-by: Daniel Vetter <daniel.vetter@intel.com> > Reviewed-by: Chris Wilson <chris@chris-wilson.co.uk> > > (I'm not even going to ask how it appears three times in the docs and > how that all works :) The follow-up paramaters are crucial: First one pulls in function kernel-docs only, other 2 pull in specific DOC: comment sections. -Daniel
On Tue, Nov 15, 2016 at 10:44:29AM +0000, Chris Wilson wrote: > On Mon, Nov 14, 2016 at 12:58:17PM +0100, Daniel Vetter wrote: > > Would be great if everony could add > > everyone > > > $ make DOCBOOKS="" htmldocs > > > > to their build scripts to catch these. 0day should also report them, > > not sure why it failed to spot this. > > "make IGNORE_DOCBOOKS=1 SPHINXOPTS=-W htmldocs" is that outdated? IGNORE_DOCBOOKS=1 was renamed to DOCBOOKS="". And incremental builds (at least in my experience here) are really fast with sphinx (a few seconds at most). So should be good enough for a git rebase -x type checking. > I don't often run it since it is too slow when checking hundreds of > patches. Any chance of an incremental patch checker? As long as you make sure you entirely avoid the old docbook horror show, incremental builds should be real fast. The initial build can take a while, but again if you avoid docbook it's reasonable fast imo. Full kernel rebuilds are still much worse. -Daniel > > Fixes: b42fe9ca0a1e ("drm/i915: Split out i915_vma.c") > > Cc: Tvrtko Ursulin <tvrtko.ursulin@intel.com> > > Cc: Chris Wilson <chris@chris-wilson.co.uk> > > Cc: Joonas Lahtinen <joonas.lahtinen@linux.intel.com> > > Signed-off-by: Daniel Vetter <daniel.vetter@intel.com> > Reviewed-by: Chris Wilson <chris@chris-wilson.co.uk> > > (I'm not even going to ask how it appears three times in the docs and > how that all works :) > -Chris > > -- > Chris Wilson, Intel Open Source Technology Centre > _______________________________________________ > dri-devel mailing list > dri-devel@lists.freedesktop.org > https://lists.freedesktop.org/mailman/listinfo/dri-devel
diff --git a/Documentation/gpu/i915.rst b/Documentation/gpu/i915.rst index ba83b7d88f1f..117d2ab7a5f7 100644 --- a/Documentation/gpu/i915.rst +++ b/Documentation/gpu/i915.rst @@ -258,19 +258,19 @@ Global GTT views GTT Fences and Swizzling ------------------------ -.. kernel-doc:: drivers/gpu/drm/i915/i915_gem_fence.c +.. kernel-doc:: drivers/gpu/drm/i915/i915_gem_fence_reg.c :internal: Global GTT Fence Handling ~~~~~~~~~~~~~~~~~~~~~~~~~ -.. kernel-doc:: drivers/gpu/drm/i915/i915_gem_fence.c +.. kernel-doc:: drivers/gpu/drm/i915/i915_gem_fence_reg.c :doc: fence register handling Hardware Tiling and Swizzling Details ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.. kernel-doc:: drivers/gpu/drm/i915/i915_gem_fence.c +.. kernel-doc:: drivers/gpu/drm/i915/i915_gem_fence_reg.c :doc: tiling swizzling details Object Tiling IOCTLs
Would be great if everony could add $ make DOCBOOKS="" htmldocs to their build scripts to catch these. 0day should also report them, not sure why it failed to spot this. Fixes: b42fe9ca0a1e ("drm/i915: Split out i915_vma.c") Cc: Tvrtko Ursulin <tvrtko.ursulin@intel.com> Cc: Chris Wilson <chris@chris-wilson.co.uk> Cc: Joonas Lahtinen <joonas.lahtinen@linux.intel.com> Signed-off-by: Daniel Vetter <daniel.vetter@intel.com> --- Documentation/gpu/i915.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-)