aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation
diff options
context:
space:
mode:
authorMichael Witten <mfwitten@gmail.com>2011-08-25 13:21:31 -0400
committerMichael Witten <mfwitten@gmail.com>2011-08-25 17:29:55 -0400
commitf11aca045c165b9d4c9c4fce29f51ec24bcf64d3 (patch)
treee64883426c54ef56d8afca676cd9557fb07eb681 /Documentation
parenta78f6787a3dd7223bf185895fdcea661b408dc0a (diff)
DocBook/drm: can -> may
Signed-off-by: Michael Witten <mfwitten@gmail.com>
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/DocBook/drm.tmpl20
1 files changed, 10 insertions, 10 deletions
diff --git a/Documentation/DocBook/drm.tmpl b/Documentation/DocBook/drm.tmpl
index 0527ff2be37e..b9079386040d 100644
--- a/Documentation/DocBook/drm.tmpl
+++ b/Documentation/DocBook/drm.tmpl
@@ -32,7 +32,7 @@
32 The Linux DRM layer contains code intended to support the needs 32 The Linux DRM layer contains code intended to support the needs
33 of complex graphics devices, usually containing programmable 33 of complex graphics devices, usually containing programmable
34 pipelines well suited to 3D graphics acceleration. Graphics 34 pipelines well suited to 3D graphics acceleration. Graphics
35 drivers in the kernel can make use of DRM functions to make 35 drivers in the kernel may make use of DRM functions to make
36 tasks like memory management, interrupt handling and DMA easier, 36 tasks like memory management, interrupt handling and DMA easier,
37 and provide a uniform interface to applications. 37 and provide a uniform interface to applications.
38 </para> 38 </para>
@@ -293,12 +293,12 @@
293 can be used for tracking various device specific bits of 293 can be used for tracking various device specific bits of
294 information, like register offsets, command buffer status, 294 information, like register offsets, command buffer status,
295 register state for suspend/resume, etc. At load time, a 295 register state for suspend/resume, etc. At load time, a
296 driver can simply allocate one and set drm_device.dev_priv 296 driver may simply allocate one and set drm_device.dev_priv
297 appropriately; at unload the driver can free it and set 297 appropriately; at unload the driver can free it and set
298 drm_device.dev_priv to NULL. 298 drm_device.dev_priv to NULL.
299 </para> 299 </para>
300 <para> 300 <para>
301 The DRM supports several counters which can be used for rough 301 The DRM supports several counters which may be used for rough
302 performance characterization. Note that the DRM stat counter 302 performance characterization. Note that the DRM stat counter
303 system is not often used by applications, and supporting 303 system is not often used by applications, and supporting
304 additional counters is completely optional. 304 additional counters is completely optional.
@@ -323,7 +323,7 @@
323 <para> 323 <para>
324 Finding &amp; mapping resources is fairly straightforward. The 324 Finding &amp; mapping resources is fairly straightforward. The
325 DRM wrapper functions, drm_get_resource_start() and 325 DRM wrapper functions, drm_get_resource_start() and
326 drm_get_resource_len() can be used to find BARs on the given 326 drm_get_resource_len() may be used to find BARs on the given
327 drm_device struct. Once those values have been retrieved, the 327 drm_device struct. Once those values have been retrieved, the
328 driver load function can call drm_addmap() to create a new 328 driver load function can call drm_addmap() to create a new
329 mapping for the BAR in question. Note you probably want a 329 mapping for the BAR in question. Note you probably want a
@@ -335,12 +335,12 @@
335 <para> 335 <para>
336 if compatibility with other operating systems isn't a concern 336 if compatibility with other operating systems isn't a concern
337 (DRM drivers can run under various BSD variants and OpenSolaris), 337 (DRM drivers can run under various BSD variants and OpenSolaris),
338 native Linux calls can be used for the above, e.g. pci_resource_* 338 native Linux calls may be used for the above, e.g. pci_resource_*
339 and iomap*/iounmap. See the Linux device driver book for more 339 and iomap*/iounmap. See the Linux device driver book for more
340 info. 340 info.
341 </para> 341 </para>
342 <para> 342 <para>
343 Once you have a register map, you can use the DRM_READn() and 343 Once you have a register map, you may use the DRM_READn() and
344 DRM_WRITEn() macros to access the registers on your device, or 344 DRM_WRITEn() macros to access the registers on your device, or
345 use driver specific versions to offset into your MMIO space 345 use driver specific versions to offset into your MMIO space
346 relative to a driver specific base pointer (see I915_READ for 346 relative to a driver specific base pointer (see I915_READ for
@@ -440,7 +440,7 @@
440 provide a pool for buffer object allocation by clients and the 440 provide a pool for buffer object allocation by clients and the
441 kernel itself. The type of this object should be TTM_GLOBAL_TTM_BO, 441 kernel itself. The type of this object should be TTM_GLOBAL_TTM_BO,
442 and its size should be sizeof(struct ttm_bo_global). Again, 442 and its size should be sizeof(struct ttm_bo_global). Again,
443 driver specific init and release functions can be provided, 443 driver specific init and release functions may be provided,
444 likely eventually calling ttm_bo_global_init and 444 likely eventually calling ttm_bo_global_init and
445 ttm_bo_global_release, respectively. Also like the previous 445 ttm_bo_global_release, respectively. Also like the previous
446 object, ttm_global_item_ref is used to create an initial reference 446 object, ttm_global_item_ref is used to create an initial reference
@@ -483,7 +483,7 @@
483<!--!Edrivers/char/drm/drm_memrange.c--> 483<!--!Edrivers/char/drm/drm_memrange.c-->
484 </para> 484 </para>
485 <para> 485 <para>
486 Once the memory manager has been set up, we can allocate the 486 Once the memory manager has been set up, we may allocate the
487 command buffer. In the i915 case, this is also done with a 487 command buffer. In the i915 case, this is also done with a
488 GEM function, i915_gem_init_ringbuffer(). 488 GEM function, i915_gem_init_ringbuffer().
489 </para> 489 </para>
@@ -572,7 +572,7 @@ void intel_crt_init(struct drm_device *dev)
572 devices with PC-style architectures (i.e. a set of display planes 572 devices with PC-style architectures (i.e. a set of display planes
573 for feeding pixels to encoders which are in turn routed to 573 for feeding pixels to encoders which are in turn routed to
574 connectors). Devices with more complex requirements needing 574 connectors). Devices with more complex requirements needing
575 finer grained management can opt to use the core callbacks 575 finer grained management may opt to use the core callbacks
576 directly. 576 directly.
577 </para> 577 </para>
578 <para> 578 <para>
@@ -637,7 +637,7 @@ void intel_crt_init(struct drm_device *dev)
637 a client calls the vblank wait ioctl above. 637 a client calls the vblank wait ioctl above.
638 </para> 638 </para>
639 <para> 639 <para>
640 Devices that don't provide a count register can simply use an 640 Devices that don't provide a count register may simply use an
641 internal atomic counter incremented on every vertical blank 641 internal atomic counter incremented on every vertical blank
642 interrupt, and can make their enable and disable vblank 642 interrupt, and can make their enable and disable vblank
643 functions into no-ops. 643 functions into no-ops.