From patchwork Thu Dec 3 19:40:51 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Zanoni, Paulo R" X-Patchwork-Id: 7762761 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 DA759BEEE1 for ; Thu, 3 Dec 2015 19:42:24 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 0621A204AB for ; Thu, 3 Dec 2015 19:42:24 +0000 (UTC) Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) by mail.kernel.org (Postfix) with ESMTP id 268B2204A0 for ; Thu, 3 Dec 2015 19:42:23 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 972526E3AA; Thu, 3 Dec 2015 11:42:22 -0800 (PST) X-Original-To: intel-gfx@lists.freedesktop.org Delivered-To: intel-gfx@lists.freedesktop.org Received: from mga11.intel.com (mga11.intel.com [192.55.52.93]) by gabe.freedesktop.org (Postfix) with ESMTP id 8B5DF6E3AA for ; Thu, 3 Dec 2015 11:42:21 -0800 (PST) Received: from fmsmga001.fm.intel.com ([10.253.24.23]) by fmsmga102.fm.intel.com with ESMTP; 03 Dec 2015 11:42:21 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.20,378,1444719600"; d="scan'208";a="853378166" Received: from kldumlao-mobl3.amr.corp.intel.com (HELO panetone.amr.corp.intel.com) ([10.254.179.188]) by fmsmga001.fm.intel.com with ESMTP; 03 Dec 2015 11:42:20 -0800 From: Paulo Zanoni To: intel-gfx@lists.freedesktop.org Date: Thu, 3 Dec 2015 17:40:51 -0200 Message-Id: <1449171651-30872-2-git-send-email-paulo.r.zanoni@intel.com> X-Mailer: git-send-email 2.6.2 In-Reply-To: <1449171651-30872-1-git-send-email-paulo.r.zanoni@intel.com> References: <1449171651-30872-1-git-send-email-paulo.r.zanoni@intel.com> Subject: [Intel-gfx] [maintainer-tools PATCH 2/2] dim: add a QUICKSTART section to dim.rst 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: , MIME-Version: 1.0 Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" X-Spam-Status: No, score=-4.2 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_MED, T_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 Because just running dim help doesn't give you the greater picture of the workflow. All the text here is based on an email written by Daniel Vetter, so the credits go to him. Any mistakes were introduced by me. Credits-to: Daniel Vetter Signed-off-by: Paulo Zanoni --- dim.rst | 58 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 58 insertions(+) diff --git a/dim.rst b/dim.rst index d5ec5c8..567bcb8 100644 --- a/dim.rst +++ b/dim.rst @@ -309,6 +309,64 @@ DIM_TEMPLATE_SIGNATURE ---------------------- Path to a file containing a signature template for pull request mails. +QUICKSTART +========== + +For getting started grab the latest drm (drm-intel-maintainer) script from:: + + http://cgit.freedesktop.org/drm-intel/tree/dim?h=maintainer-tools + +There's also a sample config file for ~/.dimrc:: + + http://cgit.freedesktop.org/drm-intel/tree/dimrc.sample?h=maintainer-tools + +Plus, there's bash completion in the same directory if you feel like using that. +Run:: + + $ dim help + +for tons of details about this thing works. Adjust your .dimrc to match your +setup and then run:: + + $ dim setup + +This will also check out the latest maintainer-tools branches, so please replace +the dim you just downloaded with a symlink after this step. And by the way, if +you have improvements for dim, please submit them to intel-gfx. + +You should now have a main repository for patch application. The directory +corresponding to this repository is defined by DIM_DRM_INTEL in your .dimrc. +You should also have directories called maintainer-tools, drm-intel-nightly (for +rebuilding the tree), and drm-intel-rerere for some dim-internal book-keeping. + +Applying patches to dinq is done in the main repository with:: + + $ cat patch.mbox | dim apply-queued + +This works like a glorified version of git apply-mbox and does basic patch +checking and adds stuff like patchwork links of the merged patch. It is +preferred to use the patch email file instead of the original patch file since +it contains some interesting headers like the message ID. When you're happy +(remember that with a shared tree any mistake is permanent and there's no +rebasing) push out the new tree with:: + + $ dim push-queued + +This will also rebuild a new drm-intel-nightly integration tree. If that fails, +ask maintainers for help with resolving conflicts. One thing to note here is +that the script syncs saved git rerere conflict resolutions around. One does the +resolution, everyone has it. The drawback is, someone screws up the conflict +resolution, everyone has it... + +Note that every two weeks Daniel cuts a new drm-intel-next by tagging what's in +drm-intel-next-queued. To increase the chances that the tree isn't totally +broken, only push bug fixes for serious problems on Thu/Fri (and weekend) every +second week (at the moment the release cycle is aligned with odd work weeks, but +just check out when the last tagged happened). + +If you need to push something to drm-intel-fixes or +drm-intel-next-fixes, please quickly coordinate with Jani. + CONTRIBUTING ============