diff options
author | Michael Witten <mfwitten@gmail.com> | 2011-08-25 13:21:31 -0400 |
---|---|---|
committer | Michael Witten <mfwitten@gmail.com> | 2011-08-25 17:29:55 -0400 |
commit | f11aca045c165b9d4c9c4fce29f51ec24bcf64d3 (patch) | |
tree | e64883426c54ef56d8afca676cd9557fb07eb681 /Documentation | |
parent | a78f6787a3dd7223bf185895fdcea661b408dc0a (diff) |
DocBook/drm: can -> may
Signed-off-by: Michael Witten <mfwitten@gmail.com>
Diffstat (limited to 'Documentation')
-rw-r--r-- | Documentation/DocBook/drm.tmpl | 20 |
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 & mapping resources is fairly straightforward. The | 324 | Finding & 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. |