Received: by 2002:a05:6a10:8c0a:0:0:0:0 with SMTP id go10csp2452044pxb; Fri, 5 Feb 2021 19:45:24 -0800 (PST) X-Google-Smtp-Source: ABdhPJxvyvnlZkJTtPdKmhIyPllm2kzFW/c9E3nQmboe0yqMgNho7X7xnIcWHoFC/qoG68aOHpIM X-Received: by 2002:a17:906:dbd0:: with SMTP id yc16mr7111109ejb.524.1612583124085; Fri, 05 Feb 2021 19:45:24 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1612583124; cv=none; d=google.com; s=arc-20160816; b=BGqgZnRytmMRbq6lpC9YkvnKwfgzarFf8cG7wU4zdgH0yuiGf6OnqUznMSBmeLgNjD p/GC137wM1WzdIztNMWcZMdV/fpabUqmks2sxaEi7sH1CR733xJjeSRffwtFG7Mc9Rvf QsVjHB2+VKe9HvtjnoN4wgZCbeO3ofENO0LSwjZdx4CY78GAQsKB/harT9A34Kv78PG9 gOD+JJagXSoArIZwiH5MX8ImOBPjTLi8iNPoPtacqncx3j1OaDXGoRg6+W7relJqpvbu RFVwMYl1DwFE4jWf1rDAKFzzrqqXm90ersFVGhYyAFTWz0p6yM8P0G0wvCTuhn1Ll/qP 6sgg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:cc:to:subject:message-id:date:from:in-reply-to :references:mime-version:dkim-signature; bh=s6dnZT0AcF3u1j3oEwTbCmRj7PTLoCDXEB/52wfg7Ko=; b=g+uaxKR9N4phWGwY6LyyFgDmwYHa+OY1hmmxmcvxOlANFHddtLZLtWaIKJN13+THZM jmqsZDE8ndBuwNFhT8NPeIIBc9ZqrwiSbqrlTBZnvz+nHQ0FTI03siA8l2KCK8pFc211 pnoL/BVLI9f3KsYLgjpAVG2l3FIPkm2fHF/XxgTep5q49MA0QB9QwjlbSEjnQlVds90J pbEuR27JBkCZt4eZQw3nFFPrl1ZbcWC1npxeDOB5lihZ1hahPM+jVOz2n9QCAkjdQ4rs NKgxJSN2bbkK2pBKlbxxsFIATfokZf3w6cYTO76ZpeyxUDXQYcFsEWvYTNvk886DA45P LaEg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@google.com header.s=20161025 header.b=BW2izEZ8; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=google.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id k5si6295387edq.211.2021.02.05.19.45.00; Fri, 05 Feb 2021 19:45:24 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@google.com header.s=20161025 header.b=BW2izEZ8; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=google.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229566AbhBFDly (ORCPT + 99 others); Fri, 5 Feb 2021 22:41:54 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:37418 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229824AbhBFCbz (ORCPT ); Fri, 5 Feb 2021 21:31:55 -0500 Received: from mail-pl1-x633.google.com (mail-pl1-x633.google.com [IPv6:2607:f8b0:4864:20::633]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 86BF9C08ED7F for ; Fri, 5 Feb 2021 15:33:01 -0800 (PST) Received: by mail-pl1-x633.google.com with SMTP id s15so4333971plr.9 for ; Fri, 05 Feb 2021 15:33:01 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=s6dnZT0AcF3u1j3oEwTbCmRj7PTLoCDXEB/52wfg7Ko=; b=BW2izEZ8LP+1njzJY9aNjX5evbtE58IbhhK7JSi0xeTGnONbNRFM9ZCWsUjmxn/m13 x0f7/Mx2WizyC82kCsYi2JOw7KVDbA22TMEOQCIxNiVpMuH5KZiRR+Fdfm1k/cifJP/t FTtR8+pIl96NDvTamKCO3EVv3II5bc4DIHCD1xLQ4gdrWgVOQexL7kkMQnxtlxlaiyIh KzOIazyT6wK5RAYDBQIdbyHr/OLCOrHge7x3RaU7oRB2qTe/H7baPdXHgdVb/xxUSntW HNytB27A/n5xi1BuBtHgaxvAQQRZARz5XTqoHnps2kp4K0+4Pg4zZ23tHpB9ba83IFDA 5+dw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=s6dnZT0AcF3u1j3oEwTbCmRj7PTLoCDXEB/52wfg7Ko=; b=KswasoEK7o6i7mXWdUSzFrPtdScbGwnxj2gVL2EK0+gXsi6vacKQDOwuKqz8swbbaT oKIu3I2G/GA59JcPDQK49vj7gx+1tjW3EG6//5qZ4HTKXN7LmYAbn6P6VCkb3H5LzSqj CmMrI0cp+uxFkjjn2rsir0fTjnQXBpTuym+0lkmJJxkdO749cBV+YbYms41cN/zuqMQh 5XrYvfA9tNGXKRgiuMYgDd94+pD/eb08EqM0LLw9MPZ2S9ctFwfQEUrJ5KCqeCtXvsAL sSkvL7C52/teWmNhTyHbt/RXuGuKf5N2eE7cUd3sechxmQfWWcZDyTigPlV4Zmyj/nX4 Ibtw== X-Gm-Message-State: AOAM5320EjG1bc9LvQngLNDRDpBi016iRlLv7aetCVkSiyXZXXNw7XKb tNWG7UhD/b/pryl36nqi4e558OKidfiW0Ckg+q0m+g== X-Received: by 2002:a17:902:f686:b029:de:18c7:41f8 with SMTP id l6-20020a170902f686b02900de18c741f8mr6235898plg.65.1612567980954; Fri, 05 Feb 2021 15:33:00 -0800 (PST) MIME-Version: 1.0 References: <20210125185333.3337463-1-dlatypov@google.com> In-Reply-To: <20210125185333.3337463-1-dlatypov@google.com> From: Brendan Higgins Date: Fri, 5 Feb 2021 15:32:50 -0800 Message-ID: Subject: Re: [PATCH] Documentation: kunit: add tips.rst for small examples To: Daniel Latypov Cc: David Gow , Linux Kernel Mailing List , "open list:KERNEL SELFTEST FRAMEWORK" , Shuah Khan Content-Type: text/plain; charset="UTF-8" Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Mon, Jan 25, 2021 at 10:53 AM Daniel Latypov wrote: > > ./usage.rst contains fairly long examples and explanations of things > like how to fake a class and how to use parameterized tests (and how you > could do table-driven tests yourself). > > It's not exactly necessary information, so we add a new page with more > digestible tips like "use kunit_kzalloc() instead of kzalloc() so you > don't have to worry about calling kfree() yourself" and the like. > > Change start.rst to point users to this new page first and let them know > that usage.rst is more of optional further reading. > > Signed-off-by: Daniel Latypov Reviewed-by: Brendan Higgins