From patchwork Tue Aug 25 09:26:45 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Graham Whaley X-Patchwork-Id: 7070351 Return-Path: X-Original-To: patchwork-intel-gfx@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork2.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.136]) by patchwork2.web.kernel.org (Postfix) with ESMTP id E38B1C05AC for ; Tue, 25 Aug 2015 09:28:18 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id A799B2081C for ; Tue, 25 Aug 2015 09:28:16 +0000 (UTC) Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) by mail.kernel.org (Postfix) with ESMTP id E42A820570 for ; Tue, 25 Aug 2015 09:28:13 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 6119B6EB5A; Tue, 25 Aug 2015 02:28:13 -0700 (PDT) X-Original-To: intel-gfx@lists.freedesktop.org Delivered-To: intel-gfx@lists.freedesktop.org Received: from mga09.intel.com (mga09.intel.com [134.134.136.24]) by gabe.freedesktop.org (Postfix) with ESMTP id C3F5A6EB57; Tue, 25 Aug 2015 02:28:11 -0700 (PDT) Received: from orsmga002.jf.intel.com ([10.7.209.21]) by orsmga102.jf.intel.com with ESMTP; 25 Aug 2015 02:28:12 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.15,744,1432623600"; d="scan'208";a="790462980" Received: from gwhaley-mobl1.ger.corp.intel.com ([10.252.24.136]) by orsmga002.jf.intel.com with ESMTP; 25 Aug 2015 02:28:09 -0700 From: Graham Whaley To: daniel.vetter@intel.com, jani.nikula@linux.intel.com, intel-gfx@lists.freedesktop.org, dri-devel@lists.freedesktop.org Date: Tue, 25 Aug 2015 10:26:45 +0100 Message-Id: <1440494805-13325-6-git-send-email-graham.whaley@linux.intel.com> X-Mailer: git-send-email 2.4.3 In-Reply-To: <1440494805-13325-1-git-send-email-graham.whaley@linux.intel.com> References: <1440494805-13325-1-git-send-email-graham.whaley@linux.intel.com> MIME-Version: 1.0 Cc: Graham Whaley , danilo.cesar@collabora.co.uk, corbet@lwn.net Subject: [Intel-gfx] [PATCH 5/5] Documentation: drm: Unify quoting methods X-BeenThere: intel-gfx@lists.freedesktop.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Intel graphics driver community testing & development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" X-Spam-Status: No, score=-5.5 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_MED, RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP There is a mixture of ", " and extended character quotes through the document - unify on ". Note, the extended character quotes caused pdfdoc build errors such as: jade:/Documentation/DocBook/drm.xml:34432:20:E: non SGML character number 128 jade:/Documentation/DocBook/drm.xml:34432:21:E: non SGML character number 156 Signed-off-by: Graham Whaley --- Documentation/DocBook/drm.tmpl | 320 ++++++++++++++++++++--------------------- 1 file changed, 160 insertions(+), 160 deletions(-) diff --git a/Documentation/DocBook/drm.tmpl b/Documentation/DocBook/drm.tmpl index e5bfdd8..3bd5936 100644 --- a/Documentation/DocBook/drm.tmpl +++ b/Documentation/DocBook/drm.tmpl @@ -2604,14 +2604,14 @@ void intel_crt_init(struct drm_device *dev) DRM Generic - “rotation” + "rotation" BITMASK - { 0, "rotate-0" }, - { 1, "rotate-90" }, - { 2, "rotate-180" }, - { 3, "rotate-270" }, - { 4, "reflect-x" }, - { 5, "reflect-y" } + { 0, "rotate-0" }, + { 1, "rotate-90" }, + { 2, "rotate-180" }, + { 3, "rotate-270" }, + { 4, "reflect-x" }, + { 5, "reflect-y" } CRTC, Plane rotate-(degrees) rotates the image by the specified amount in degrees in counter clockwise direction. reflect-x and reflect-y @@ -2620,35 +2620,35 @@ void intel_crt_init(struct drm_device *dev) Connector - “EDID” + "EDID" BLOB | IMMUTABLE 0 Connector Contains id of edid blob ptr object. - “DPMS” + "DPMS" ENUM - { “On”, “Standby”, “Suspend”, “Off” } + { "On", "Standby", "Suspend", "Off" } Connector Contains DPMS operation mode value. - “PATH” + "PATH" BLOB | IMMUTABLE 0 Connector Contains topology path to a connector. - “TILE” + "TILE" BLOB | IMMUTABLE 0 Connector Contains tiling information for a connector. - “CRTC_ID” + "CRTC_ID" OBJECT DRM_MODE_OBJECT_CRTC Connector @@ -2656,77 +2656,77 @@ void intel_crt_init(struct drm_device *dev) Plane - “type” + "type" ENUM | IMMUTABLE - { "Overlay", "Primary", "Cursor" } + { "Overlay", "Primary", "Cursor" } Plane Plane type - “SRC_X” + "SRC_X" RANGE Min=0, Max=UINT_MAX Plane Scanout source x coordinate in 16.16 fixed point (atomic) - “SRC_Y” + "SRC_Y" RANGE Min=0, Max=UINT_MAX Plane Scanout source y coordinate in 16.16 fixed point (atomic) - “SRC_W” + "SRC_W" RANGE Min=0, Max=UINT_MAX Plane Scanout source width in 16.16 fixed point (atomic) - “SRC_H” + "SRC_H" RANGE Min=0, Max=UINT_MAX Plane Scanout source height in 16.16 fixed point (atomic) - “CRTC_X” + "CRTC_X" SIGNED_RANGE Min=INT_MIN, Max=INT_MAX Plane Scanout CRTC (destination) x coordinate (atomic) - “CRTC_Y” + "CRTC_Y" SIGNED_RANGE Min=INT_MIN, Max=INT_MAX Plane Scanout CRTC (destination) y coordinate (atomic) - “CRTC_W” + "CRTC_W" RANGE Min=0, Max=UINT_MAX Plane Scanout CRTC (destination) width (atomic) - “CRTC_H” + "CRTC_H" RANGE Min=0, Max=UINT_MAX Plane Scanout CRTC (destination) height (atomic) - “FB_ID” + "FB_ID" OBJECT DRM_MODE_OBJECT_FB Plane Scanout framebuffer (atomic) - “CRTC_ID” + "CRTC_ID" OBJECT DRM_MODE_OBJECT_CRTC Plane @@ -2734,106 +2734,106 @@ void intel_crt_init(struct drm_device *dev) DVI-I - “subconnector” + "subconnector" ENUM - { “Unknown”, “DVI-D”, “DVI-A” } + { "Unknown", "DVI-D", "DVI-A" } Connector TBD - “select subconnector” + "select subconnector" ENUM - { “Automatic”, “DVI-D”, “DVI-A” } + { "Automatic", "DVI-D", "DVI-A" } Connector TBD TV - “subconnector” + "subconnector" ENUM - { "Unknown", "Composite", "SVIDEO", "Component", "SCART" } + { "Unknown", "Composite", "SVIDEO", "Component", "SCART" } Connector TBD - “select subconnector” + "select subconnector" ENUM - { "Automatic", "Composite", "SVIDEO", "Component", "SCART" } + { "Automatic", "Composite", "SVIDEO", "Component", "SCART" } Connector TBD - “mode” + "mode" ENUM - { "NTSC_M", "NTSC_J", "NTSC_443", "PAL_B" } etc. + { "NTSC_M", "NTSC_J", "NTSC_443", "PAL_B" } etc. Connector TBD - “left margin” + "left margin" RANGE Min=0, Max=100 Connector TBD - “right margin” + "right margin" RANGE Min=0, Max=100 Connector TBD - “top margin” + "top margin" RANGE Min=0, Max=100 Connector TBD - “bottom margin” + "bottom margin" RANGE Min=0, Max=100 Connector TBD - “brightness” + "brightness" RANGE Min=0, Max=100 Connector TBD - “contrast” + "contrast" RANGE Min=0, Max=100 Connector TBD - “flicker reduction” + "flicker reduction" RANGE Min=0, Max=100 Connector TBD - “overscan” + "overscan" RANGE Min=0, Max=100 Connector TBD - “saturation” + "saturation" RANGE Min=0, Max=100 Connector TBD - “hue” + "hue" RANGE Min=0, Max=100 Connector @@ -2841,14 +2841,14 @@ void intel_crt_init(struct drm_device *dev) Virtual GPU - “suggested X” + "suggested X" RANGE Min=0, Max=0xffffffff Connector property to suggest an X offset for a connector - “suggested Y” + "suggested Y" RANGE Min=0, Max=0xffffffff Connector @@ -2856,159 +2856,159 @@ void intel_crt_init(struct drm_device *dev) Optional - “scaling mode” + "scaling mode" ENUM - { "None", "Full", "Center", "Full aspect" } + { "None", "Full", "Center", "Full aspect" } Connector TBD - "aspect ratio" + "aspect ratio" ENUM - { "None", "4:3", "16:9" } + { "None", "4:3", "16:9" } Connector DRM property to set aspect ratio from user space app. This enum is made generic to allow addition of custom aspect ratios. - “dirty” + "dirty" ENUM | IMMUTABLE - { "Off", "On", "Annotate" } + { "Off", "On", "Annotate" } Connector TBD i915 Generic - "Broadcast RGB" + "Broadcast RGB" ENUM - { "Automatic", "Full", "Limited 16:235" } + { "Automatic", "Full", "Limited 16:235" } Connector TBD - “audio” + "audio" ENUM - { "force-dvi", "off", "auto", "on" } + { "force-dvi", "off", "auto", "on" } Connector TBD SDVO-TV - “mode” + "mode" ENUM - { "NTSC_M", "NTSC_J", "NTSC_443", "PAL_B" } etc. + { "NTSC_M", "NTSC_J", "NTSC_443", "PAL_B" } etc. Connector TBD - "left_margin" + "left_margin" RANGE Min=0, Max= SDVO dependent Connector TBD - "right_margin" + "right_margin" RANGE Min=0, Max= SDVO dependent Connector TBD - "top_margin" + "top_margin" RANGE Min=0, Max= SDVO dependent Connector TBD - "bottom_margin" + "bottom_margin" RANGE Min=0, Max= SDVO dependent Connector TBD - “hpos” + "hpos" RANGE Min=0, Max= SDVO dependent Connector TBD - “vpos” + "vpos" RANGE Min=0, Max= SDVO dependent Connector TBD - “contrast” + "contrast" RANGE Min=0, Max= SDVO dependent Connector TBD - “saturation” + "saturation" RANGE Min=0, Max= SDVO dependent Connector TBD - “hue” + "hue" RANGE Min=0, Max= SDVO dependent Connector TBD - “sharpness” + "sharpness" RANGE Min=0, Max= SDVO dependent Connector TBD - “flicker_filter” + "flicker_filter" RANGE Min=0, Max= SDVO dependent Connector TBD - “flicker_filter_adaptive” + "flicker_filter_adaptive" RANGE Min=0, Max= SDVO dependent Connector TBD - “flicker_filter_2d” + "flicker_filter_2d" RANGE Min=0, Max= SDVO dependent Connector TBD - “tv_chroma_filter” + "tv_chroma_filter" RANGE Min=0, Max= SDVO dependent Connector TBD - “tv_luma_filter” + "tv_luma_filter" RANGE Min=0, Max= SDVO dependent Connector TBD - “dot_crawl” + "dot_crawl" RANGE Min=0, Max=1 Connector @@ -3016,7 +3016,7 @@ void intel_crt_init(struct drm_device *dev) SDVO-TV/LVDS - “brightness” + "brightness" RANGE Min=0, Max= SDVO dependent Connector @@ -3025,23 +3025,23 @@ void intel_crt_init(struct drm_device *dev) CDV gma-500 Generic - "Broadcast RGB" + "Broadcast RGB" ENUM - { “Full”, “Limited 16:235” } + { "Full", "Limited 16:235" } Connector TBD - "Broadcast RGB" + "Broadcast RGB" ENUM - { “off”, “auto”, “on” } + { "off", "auto", "on" } Connector TBD Poulsbo Generic - “backlight” + "backlight" RANGE Min=0, Max=100 Connector @@ -3049,119 +3049,119 @@ void intel_crt_init(struct drm_device *dev) SDVO-TV - “mode” + "mode" ENUM - { "NTSC_M", "NTSC_J", "NTSC_443", "PAL_B" } etc. + { "NTSC_M", "NTSC_J", "NTSC_443", "PAL_B" } etc. Connector TBD - "left_margin" + "left_margin" RANGE Min=0, Max= SDVO dependent Connector TBD - "right_margin" + "right_margin" RANGE Min=0, Max= SDVO dependent Connector TBD - "top_margin" + "top_margin" RANGE Min=0, Max= SDVO dependent Connector TBD - "bottom_margin" + "bottom_margin" RANGE Min=0, Max= SDVO dependent Connector TBD - “hpos” + "hpos" RANGE Min=0, Max= SDVO dependent Connector TBD - “vpos” + "vpos" RANGE Min=0, Max= SDVO dependent Connector TBD - “contrast” + "contrast" RANGE Min=0, Max= SDVO dependent Connector TBD - “saturation” + "saturation" RANGE Min=0, Max= SDVO dependent Connector TBD - “hue” + "hue" RANGE Min=0, Max= SDVO dependent Connector TBD - “sharpness” + "sharpness" RANGE Min=0, Max= SDVO dependent Connector TBD - “flicker_filter” + "flicker_filter" RANGE Min=0, Max= SDVO dependent Connector TBD - “flicker_filter_adaptive” + "flicker_filter_adaptive" RANGE Min=0, Max= SDVO dependent Connector TBD - “flicker_filter_2d” + "flicker_filter_2d" RANGE Min=0, Max= SDVO dependent Connector TBD - “tv_chroma_filter” + "tv_chroma_filter" RANGE Min=0, Max= SDVO dependent Connector TBD - “tv_luma_filter” + "tv_luma_filter" RANGE Min=0, Max= SDVO dependent Connector TBD - “dot_crawl” + "dot_crawl" RANGE Min=0, Max=1 Connector @@ -3169,7 +3169,7 @@ void intel_crt_init(struct drm_device *dev) SDVO-TV/LVDS - “brightness” + "brightness" RANGE Min=0, Max= SDVO dependent Connector @@ -3178,79 +3178,79 @@ void intel_crt_init(struct drm_device *dev) armada CRTC - "CSC_YUV" + "CSC_YUV" ENUM - { "Auto" , "CCIR601", "CCIR709" } + { "Auto" , "CCIR601", "CCIR709" } CRTC TBD - "CSC_RGB" + "CSC_RGB" ENUM - { "Auto", "Computer system", "Studio" } + { "Auto", "Computer system", "Studio" } CRTC TBD Overlay - "colorkey" + "colorkey" RANGE Min=0, Max=0xffffff Plane TBD - "colorkey_min" + "colorkey_min" RANGE Min=0, Max=0xffffff Plane TBD - "colorkey_max" + "colorkey_max" RANGE Min=0, Max=0xffffff Plane TBD - "colorkey_val" + "colorkey_val" RANGE Min=0, Max=0xffffff Plane TBD - "colorkey_alpha" + "colorkey_alpha" RANGE Min=0, Max=0xffffff Plane TBD - "colorkey_mode" + "colorkey_mode" ENUM - { "disabled", "Y component", "U component" - , "V component", "RGB", “R component", "G component", "B component" } + { "disabled", "Y component", "U component" + , "V component", "RGB", "R component", "G component", "B component" } Plane TBD - "brightness" + "brightness" RANGE Min=0, Max=256 + 255 Plane TBD - "contrast" + "contrast" RANGE Min=0, Max=0x7fff Plane TBD - "saturation" + "saturation" RANGE Min=0, Max=0x7fff Plane @@ -3259,15 +3259,15 @@ void intel_crt_init(struct drm_device *dev) exynos CRTC - “mode” + "mode" ENUM - { "normal", "blank" } + { "normal", "blank" } CRTC TBD Overlay - “zpos” + "zpos" RANGE Min=0, Max=MAX_PLANE-1 Plane @@ -3276,7 +3276,7 @@ void intel_crt_init(struct drm_device *dev) i2c/ch7006_drv Generic - “scale” + "scale" RANGE Min=0, Max=2 Connector @@ -3284,52 +3284,52 @@ void intel_crt_init(struct drm_device *dev) TV - “mode” + "mode" ENUM - { "PAL", "PAL-M","PAL-N"}, ”PAL-Nc" - , "PAL-60", "NTSC-M", "NTSC-J" } + { "PAL", "PAL-M","PAL-N"}, "PAL-Nc" + , "PAL-60", "NTSC-M", "NTSC-J" } Connector TBD nouveau NV10 Overlay - "colorkey" + "colorkey" RANGE Min=0, Max=0x01ffffff Plane TBD - “contrast” + "contrast" RANGE Min=0, Max=8192-1 Plane TBD - “brightness” + "brightness" RANGE Min=0, Max=1024 Plane TBD - “hue” + "hue" RANGE Min=0, Max=359 Plane TBD - “saturation” + "saturation" RANGE Min=0, Max=8192-1 Plane TBD - “iturbt_709” + "iturbt_709" RANGE Min=0, Max=1 Plane @@ -3337,14 +3337,14 @@ void intel_crt_init(struct drm_device *dev) Nv04 Overlay - “colorkey” + "colorkey" RANGE Min=0, Max=0x01ffffff Plane TBD - “brightness” + "brightness" RANGE Min=0, Max=1024 Plane @@ -3352,49 +3352,49 @@ void intel_crt_init(struct drm_device *dev) Display - “dithering mode” + "dithering mode" ENUM - { "auto", "off", "on" } + { "auto", "off", "on" } Connector TBD - “dithering depth” + "dithering depth" ENUM - { "auto", "off", "on", "static 2x2", "dynamic 2x2", "temporal" } + { "auto", "off", "on", "static 2x2", "dynamic 2x2", "temporal" } Connector TBD - “underscan” + "underscan" ENUM - { "auto", "6 bpc", "8 bpc" } + { "auto", "6 bpc", "8 bpc" } Connector TBD - “underscan hborder” + "underscan hborder" RANGE Min=0, Max=128 Connector TBD - “underscan vborder” + "underscan vborder" RANGE Min=0, Max=128 Connector TBD - “vibrant hue” + "vibrant hue" RANGE Min=0, Max=180 Connector TBD - “color vibrance” + "color vibrance" RANGE Min=0, Max=200 Connector @@ -3403,7 +3403,7 @@ void intel_crt_init(struct drm_device *dev) omap Generic - “zorder” + "zorder" RANGE Min=0, Max=3 CRTC, Plane @@ -3412,7 +3412,7 @@ void intel_crt_init(struct drm_device *dev) qxl Generic - “hotplug_mode_update" + "hotplug_mode_update" RANGE Min=0, Max=1 Connector @@ -3421,7 +3421,7 @@ void intel_crt_init(struct drm_device *dev) radeon DVI-I - “coherent” + "coherent" RANGE Min=0, Max=1 Connector @@ -3429,7 +3429,7 @@ void intel_crt_init(struct drm_device *dev) DAC enable load detect - “load detection” + "load detection" RANGE Min=0, Max=1 Connector @@ -3437,38 +3437,38 @@ void intel_crt_init(struct drm_device *dev) TV Standard - "tv standard" + "tv standard" ENUM - { "ntsc", "pal", "pal-m", "pal-60", "ntsc-j" - , "scart-pal", "pal-cn", "secam" } + { "ntsc", "pal", "pal-m", "pal-60", "ntsc-j" + , "scart-pal", "pal-cn", "secam" } Connector TBD legacy TMDS PLL detect - "tmds_pll" + "tmds_pll" ENUM - { "driver", "bios" } + { "driver", "bios" } - TBD Underscan - "underscan" + "underscan" ENUM - { "off", "on", "auto" } + { "off", "on", "auto" } Connector TBD - "underscan hborder" + "underscan hborder" RANGE Min=0, Max=128 Connector TBD - "underscan vborder" + "underscan vborder" RANGE Min=0, Max=128 Connector @@ -3476,38 +3476,38 @@ void intel_crt_init(struct drm_device *dev) Audio - “audio” + "audio" ENUM - { "off", "on", "auto" } + { "off", "on", "auto" } Connector TBD FMT Dithering - “dither” + "dither" ENUM - { "off", "on" } + { "off", "on" } Connector TBD rcar-du Generic - "alpha" + "alpha" RANGE Min=0, Max=255 Plane TBD - "colorkey" + "colorkey" RANGE Min=0, Max=0x01ffffff Plane TBD - "zpos" + "zpos" RANGE Min=1, Max=7 Plane