From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-9.6 required=3.0 tests=DKIM_INVALID,DKIM_SIGNED, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY, SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 23AD8C2BA2B for ; Mon, 6 Apr 2020 19:47:59 +0000 (UTC) Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 03E8620672 for ; Mon, 6 Apr 2020 19:47:59 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="EdyRoLLt" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 03E8620672 Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=ravnborg.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=dri-devel-bounces@lists.freedesktop.org Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 00A9D6E491; Mon, 6 Apr 2020 19:47:57 +0000 (UTC) Received: from mail-lj1-x243.google.com (mail-lj1-x243.google.com [IPv6:2a00:1450:4864:20::243]) by gabe.freedesktop.org (Postfix) with ESMTPS id CB5186E48E for ; Mon, 6 Apr 2020 19:47:55 +0000 (UTC) Received: by mail-lj1-x243.google.com with SMTP id r7so999265ljg.13 for ; Mon, 06 Apr 2020 12:47:55 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=pS0Bg3KnaEw3MvWpekWj9m2M2eA9fgosKuHEzyisRGE=; b=EdyRoLLtx7u9ucqH/ePqq2dxLF0xMODSoPwvc7zyzTxOmbixp2wQyEvTUq7glo9KWH JoDyOzJ1TFUFAFztYjob4OxKfnEbQgws2zKgbrnQQwUbI2OOWoexSwwhb7CBysCcyknn 6AdwFzASTPy1VvY1ES9ookFQfULlL2Hlq9vw+oe4+O4rqfqjzlBJbV4fozZJUlDBDsvs 7u47XBp6LJMc6Lo+wmeBMurV8Hyht5MXmhaERzUaXdUbNcu7Z+7mM7yVPZZqT/6cHxAn ETXS6CAmGRHP6ceZ9xO9YMew4SOuK6e0AxXRcaMD7Wdd53YnRbgcFCuriirZHmzsv/RL tcZw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:cc:subject:date:message-id :in-reply-to:references:mime-version:content-transfer-encoding; bh=pS0Bg3KnaEw3MvWpekWj9m2M2eA9fgosKuHEzyisRGE=; b=ow9nNVqgc+TXYfZbeCrypI8ZPMmpnXgQ/tSIp86HiIUdU1znCpFh6bEEJKPeZYtoXP jpy80xUwJowazcZx64qiSWKkpzT88zQYUoiCro2WswvUZQhD+Q3brS01NGA+Qx2GlEVc ngebT570inXUm+HK0xt7zL/nUMt65seiAbL1dmRZjGlTVOIr4m0QdXxuFUKxR91HRwVM G7ThuHb/8HznF8ehIVUq/9NDKgetTAvU/Sz95+DpgZFiyw8qSpRyKZQcQtEDHj2QFHpE IsSeqD15jh0Cl7N2Fev/U6xdxjM1ocPaA3fwUCqvzcdEoJpbO9AoyKLSLMQLAYI4tJGk 0pZQ== X-Gm-Message-State: AGi0PubegKLUcPMCWlzaYHnFD1piTv3PfIVzoXFoQwJLpbzHXgibZIvG tChz8hnwZ7f1XhCtP9Y6etLEOsXNJkM= X-Google-Smtp-Source: APiQypKhbdpLZrP524ONs8XuBgalwMPY6MQF2xlspGP19r8PdW7x6K1JWocGkaZQ2lO80m9ubMnCyg== X-Received: by 2002:a2e:9752:: with SMTP id f18mr555122ljj.181.1586202473995; Mon, 06 Apr 2020 12:47:53 -0700 (PDT) Received: from saturn.lan (18.158-248-194.customer.lyse.net. [158.248.194.18]) by smtp.gmail.com with ESMTPSA id b16sm10525276ljh.20.2020.04.06.12.47.52 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 06 Apr 2020 12:47:53 -0700 (PDT) From: Sam Ravnborg To: dri-devel@lists.freedesktop.org, Lyude Paul Subject: [PATCH v2 1/3] drm/vblank: Add intro to documentation Date: Mon, 6 Apr 2020 21:47:44 +0200 Message-Id: <20200406194746.26433-2-sam@ravnborg.org> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20200406194746.26433-1-sam@ravnborg.org> References: <20200406194746.26433-1-sam@ravnborg.org> MIME-Version: 1.0 X-BeenThere: dri-devel@lists.freedesktop.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Direct Rendering Infrastructure - Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Laurent Pinchart , David Airlie , Daniel Vetter , Liviu Dudau , Thomas Zimmermann , Sam Ravnborg Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" THl1ZGUgUGF1bCB3cm90ZSBhIHZlcnkgZ29vZCBpbnRybyB0byB2YmxhbmsgaGVyZToKaHR0cHM6 Ly9sb3JlLmtlcm5lbC5vcmcvZHJpLWRldmVsL2ZhZjYzZDhhOWVkMjNjMTZhZjY5NzYyZjU5ZDBk Y2E2YjJiZjA4NWYuY2FtZWxAcmVkaGF0LmNvbS9ULyNtY2U2NDgwYmU3MzgxNjBlOWQwN2M1ZDAy M2U4OGZkNzhkN2EwNmQyNwoKQWRkIHRoaXMgdG8gdGhlIGludHJvIGNoYXB0ZXIgaW4gZHJtX3Zi bGFuay5jIHNvIG90aGVycwpjYW4gYmVuZWZpdCBmcm9tIGl0IHRvby4KCnYyOgogIC0gUmV3b3Jk ZWQgdG8gaW1wcm92ZSByZWFkYWJpbGl0eSAoVGhvbWFzKQoKdjM6CiAgLSBBZGRlZCBuaWNlIGFz Y2lpIGRyYXdpbmcgZnJvbSBMeXVkZSAoTHl1ZGUpCiAgLSBBZGRlZCByZWZlcmVuZGUgdG8gaGln aC1wcmVjaXNpb24gdGltZXN0YW1wIChEYW5pZWwpCiAgLSBJbXByb3ZlZCBncmFtbWFyIChUaG9t YXMpCiAgLSBDb21iaW5lZCBpdCBhbGwgYW5kIG1hZGUga2VybmVsLWRvYyBoYXBweQogIC0gRHJv cHBlZCBhbnkgYS1iLCByLWIgZG8gdG8gdGhlIGFtb3VudCBvZiBjaGFuZ2VzCgpTaWduZWQtb2Zm LWJ5OiBTYW0gUmF2bmJvcmcgPHNhbUByYXZuYm9yZy5vcmc+CkNvLWRldmVsb3BlZC1ieTogTHl1 ZGUgUGF1bCA8bHl1ZGVAcmVkaGF0LmNvbT4KQ2M6IEx5dWRlIFBhdWwgPGx5dWRlQHJlZGhhdC5j b20+CkNjOiBUaG9tYXMgWmltbWVybWFubiA8dHppbW1lcm1hbm5Ac3VzZS5kZT4KQ2M6IERhbmll bCBWZXR0ZXIgPGRhbmllbC52ZXR0ZXJAZmZ3bGwuY2g+CkNjOiBNYWFydGVuIExhbmtob3JzdCA8 bWFhcnRlbi5sYW5raG9yc3RAbGludXguaW50ZWwuY29tPgpDYzogTWF4aW1lIFJpcGFyZCA8bXJp cGFyZEBrZXJuZWwub3JnPgpDYzogVGhvbWFzIFppbW1lcm1hbm4gPHR6aW1tZXJtYW5uQHN1c2Uu ZGU+CkNjOiBEYXZpZCBBaXJsaWUgPGFpcmxpZWRAbGludXguaWU+Ci0tLQogZHJpdmVycy9ncHUv ZHJtL2RybV92YmxhbmsuYyB8IDUzICsrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysr KwogMSBmaWxlIGNoYW5nZWQsIDUzIGluc2VydGlvbnMoKykKCmRpZmYgLS1naXQgYS9kcml2ZXJz L2dwdS9kcm0vZHJtX3ZibGFuay5jIGIvZHJpdmVycy9ncHUvZHJtL2RybV92YmxhbmsuYwppbmRl eCBiY2YzNDZiM2U0ODYuLjk2MzMwOTJjOWFkNSAxMDA2NDQKLS0tIGEvZHJpdmVycy9ncHUvZHJt L2RybV92YmxhbmsuYworKysgYi9kcml2ZXJzL2dwdS9kcm0vZHJtX3ZibGFuay5jCkBAIC00MSw2 ICs0MSw1OSBAQAogLyoqCiAgKiBET0M6IHZibGFuayBoYW5kbGluZwogICoKKyAqIEZyb20gdGhl IGNvbXB1dGVyJ3MgcGVyc3BlY3RpdmUsIGV2ZXJ5IHRpbWUgdGhlIG1vbml0b3IgZGlzcGxheXMK KyAqIGEgbmV3IGZyYW1lIHRoZSBzY2Fub3V0IGVuZ2luZSBoYXZlICJzY2FubmVkIG91dCIgdGhl IGRpc3BsYXkgaW1hZ2UKKyAqIGZyb20gdG9wIHRvIGJvdHRvbSwgb25lIHJvdyBvZiBwaXhlbHMg YXQgYSB0aW1lLgorICogVGhlIGN1cnJlbnQgcm93IG9mIHBpeGVscyBpcyByZWZlcnJlZCB0byBh cyB0aGUgY3VycmVudCBzY2FubGluZS4KKyAqCisgKiBJbiBhZGRpdGlvbiB0byB0aGUgZGlzcGxh eSdzIHZpc2libGUgYXJlYSwgdGhlcmUncyB1c3VhbGx5IGEgY291cGxlIG9mCisgKiBleHRyYSBz Y2FubGluZXMgd2hpY2ggYXJlbid0IGFjdHVhbGx5IGRpc3BsYXllZCBvbiB0aGUgc2NyZWVuLgor ICogVGhlc2UgZXh0cmEgc2NhbmxpbmVzIGRvbid0IGNvbnRhaW4gaW1hZ2UgZGF0YSBhbmQgYXJl IG9jY2FzaW9uYWxseSB1c2VkCisgKiBmb3IgZmVhdHVyZXMgbGlrZSBhdWRpbyBhbmQgaW5mb2Zy YW1lcy4gVGhlIHJlZ2lvbiBtYWRlIHVwIG9mIHRoZXNlCisgKiBzY2FubGluZXMgaXMgcmVmZXJy ZWQgdG8gYXMgdGhlIHZlcnRpY2FsIGJsYW5raW5nIHJlZ2lvbiwgb3IgdmJsYW5rIGZvcgorICog c2hvcnQuCisgKgorICogOjoKKyAqCisgKgorICogICAgcGh5c2ljYWwg4oaSICAg4o694o694o69 4o694o694o694o694o694o694o694o694o694o694o694o694o694o694o694o694o694o694o69 4o694o694o694o694o694o694o694o694o694o694o694o694o694o694o694o694o694o69Cisg KiAgICB0b3Agb2YgICAgICB8ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg IHwKKyAqICAgIGRpc3BsYXkgICAgIHwgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgfAorICogICAgICAgICAgICAgICAgfCAgICAgICAgICAgICAgIE5ldyBmcmFtZSAgICAg ICAgICAgICAgICB8CisgKiAgICAgICAgICAgICAgICB8ICAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgICAgICAgICAgIHwKKyAqICAgICAgICAgICAgICAgIHzihpPihpPihpPihpPihpPihpPi hpPihpPihpPihpPihpPihpPihpPihpPihpPihpPihpPihpPihpPihpPihpPihpPihpPihpPihpPi hpPihpPihpPihpPihpPihpPihpPihpPihpPihpPihpPihpPihpPihpPihpN8CisgKiAgICAgICAg ICAgICAgICB8fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fn5+fnwg4oaQIFNj YW5saW5lLCB1cGRhdGVzCisgKiAgICAgICAgICAgICAgICB84oaT4oaT4oaT4oaT4oaT4oaT4oaT 4oaT4oaT4oaT4oaT4oaT4oaT4oaT4oaT4oaT4oaT4oaT4oaT4oaT4oaT4oaT4oaT4oaT4oaT4oaT 4oaT4oaT4oaT4oaT4oaT4oaT4oaT4oaT4oaT4oaT4oaT4oaT4oaT4oaTfCAgIHRoZSBmcmFtZSBh cyBpdAorICogICAgICAgICAgICAgICAgfCAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgICB8ICAgdHJhdmVscyBkb3duCisgKiAgICAgICAgICAgICAgICB8ICAgICAgICAgICAg ICAgICAgICAgICAgICAgICAgICAgICAgICAgIHwgICAoInNjYW4gb3V0IikKKyAqICAgICAgICAg ICAgICAgIHwgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgfAorICogICAg ICAgICAgICAgICAgfCAgICAgICAgICAgICAgIE9sZCBmcmFtZSAgICAgICAgICAgICAgICB8Cisg KiAgICAgICAgICAgICAgICB8ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg IHwKKyAqICAgICAgICAgICAgICAgIHwgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgfAorICogICAgICAgICAgICAgICAgfCAgICAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgICAgICB8CisgKiAgICAgICAgICAgICAgICB8ICAgICAgICAgICAgICAgICAgICAgICAg ICAgICAgICAgICAgICAgIHwgICBwaHlzaWNhbAorICogICAgICAgICAgICAgICAgfCAgICAgICAg ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICB8ICAgYm90dG9tIG9mCisgKiAgICB2ZXJ0 aWNhbCAgICB84o694o694o694o694o694o694o694o694o694o694o694o694o694o694o694o69 4o694o694o694o694o694o694o694o694o694o694o694o694o694o694o694o694o694o694o69 4o694o694o694o694o69fCDihpAgZGlzcGxheQorICogICAgYmxhbmtpbmcgICAg4pSGeHh4eHh4 eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eOKUhgorICogICAgcmVnaW9uICAg4oaS ICDilIZ4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh44pSGCisgKiAgICAg ICAgICAgICAgICDilIZ4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh4eHh44pSG CisgKiAgICBzdGFydCBvZiDihpIgICDijr3ijr3ijr3ijr3ijr3ijr3ijr3ijr3ijr3ijr3ijr3i jr3ijr3ijr3ijr3ijr3ijr3ijr3ijr3ijr3ijr3ijr3ijr3ijr3ijr3ijr3ijr3ijr3ijr3ijr3i jr3ijr3ijr3ijr3ijr3ijr3ijr3ijr3ijr3ijr0KKyAqICAgIG5ldyBmcmFtZQorICoKKyAqICJQ aHlzaWNhbCB0b3Agb2YgZGlzcGxheSIgaXMgdGhlIHJlZmVyZW5jZSBwb2ludCBmb3IgdGhlIGhp Z2gtcHJlY2lzaW9uLworICogY29ycmVjdGVkIHRpbWVzdGFtcC4KKyAqCisgKiBPbiBhIGxvdCBv ZiBkaXNwbGF5IGhhcmR3YXJlLCBwcm9ncmFtbWluZyBuZWVkcyB0byB0YWtlIGVmZmVjdCBkdXJp bmcgdGhlCisgKiB2ZXJ0aWNhbCBibGFua2luZyBwZXJpb2Qgc28gdGhhdCBzZXR0aW5ncyBsaWtl IGdhbW1hLCB0aGUgaW1hZ2UgYnVmZmVyCisgKiBidWZmZXIgdG8gYmUgc2Nhbm5lZCBvdXQsIGV0 Yy4gY2FuIHNhZmVseSBiZSBjaGFuZ2VkIHdpdGhvdXQgc2hvd2luZworICogYW55IHZpc3VhbCBh cnRpZmFjdHMgb24gdGhlIHNjcmVlbi4gSW4gc29tZSB1bmZvcmdpdmluZyBoYXJkd2FyZSwgc29t ZSBvZgorICogdGhpcyBwcm9ncmFtbWluZyBoYXMgdG8gYm90aCBzdGFydCBhbmQgZW5kIGluIHRo ZSBzYW1lIHZibGFuay4KKyAqCisgKiBUaGUgdmJsYW5rIGludGVycnVwdCBtYXkgYmUgZmlyZWQg YXQgZGlmZmVyZW50IHBvaW50cyBkZXBlbmRpbmcgb24gdGhlCisgKiBoYXJkd2FyZS4gU29tZSBo YXJkd2FyZSBpbXBsZW1lbnRhdGlvbnMgd2lsbCBmaXJlIHRoZSBpbnRlcnJ1cHQgd2hlbiB0aGUK KyAqIG5ldyBmcmFtZSBzdGFydCwgb3RoZXIgaW1wbGVtZW50YXRpb25zIHdpbGwgZmlyZSB0aGUg aW50ZXJydXB0IGF0IGRpZmZlcmVudAorICogcG9pbnRzIGluIHRpbWUuCisgKgogICogVmVydGlj YWwgYmxhbmtpbmcgcGxheXMgYSBtYWpvciByb2xlIGluIGdyYXBoaWNzIHJlbmRlcmluZy4gVG8g YWNoaWV2ZQogICogdGVhci1mcmVlIGRpc3BsYXksIHVzZXJzIG11c3Qgc3luY2hyb25pemUgcGFn ZSBmbGlwcyBhbmQvb3IgcmVuZGVyaW5nIHRvCiAgKiB2ZXJ0aWNhbCBibGFua2luZy4gVGhlIERS TSBBUEkgb2ZmZXJzIGlvY3RscyB0byBwZXJmb3JtIHBhZ2UgZmxpcHMKLS0gCjIuMjAuMQoKX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18KZHJpLWRldmVsIG1h aWxpbmcgbGlzdApkcmktZGV2ZWxAbGlzdHMuZnJlZWRlc2t0b3Aub3JnCmh0dHBzOi8vbGlzdHMu ZnJlZWRlc2t0b3Aub3JnL21haWxtYW4vbGlzdGluZm8vZHJpLWRldmVsCg==