From owner-freebsd-testing@FreeBSD.ORG Thu Aug 7 02:28:40 2014 Return-Path: Delivered-To: freebsd-testing@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 1035D1E9 for ; Thu, 7 Aug 2014 02:28:40 +0000 (UTC) Received: from mail-ie0-f182.google.com (mail-ie0-f182.google.com [209.85.223.182]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id D0F9B2F9E for ; Thu, 7 Aug 2014 02:28:39 +0000 (UTC) Received: by mail-ie0-f182.google.com with SMTP id y20so3915218ier.41 for ; Wed, 06 Aug 2014 19:28:38 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:sender:in-reply-to:references:from :date:message-id:subject:to:cc:content-type; bh=Y/ipHJh+QVmVcON2/h9FJCm2ZZV/w1SlMn/0U1IJxpM=; b=Pm4cger4tizhX0RIaYrZOWcO7THpYoD/fFWlsPhhLZjUpOEaSysC3xuAANpHvWVMrj tI7Ky64InHUPuoxmiTz7KzDjjVXzKS7e8n1ux+JPcyLE7UNx/PvDD85IOkYOxXe0YhAq Vw6zT7P8f78XtFbXlf5bW7F8bHwB+Jg64bugb/+qIPpccH3H1w0fAvKJZBN4ev/R/sIv wyQlmrNOwE7mubGUPBuh7VfdMKBdwFBTKN1oaNOA0KCNem7EvP/68Qm0cTZZFJd9NPrL 8gQto22IEf329vYgQG7EbM2vRLcyTPgIOeG/BdSbSu3Yet/4192pRXBvQlizRYH4/vHL 3r8g== X-Gm-Message-State: ALoCoQmmEX6ZDaAWbiS4T0P/vwjD7lBrx7FleRSPBODigw3lDREMIYZTRk+d6Wvr80TbqcBtZuFR X-Received: by 10.50.142.99 with SMTP id rv3mr24257182igb.48.1407378518611; Wed, 06 Aug 2014 19:28:38 -0700 (PDT) MIME-Version: 1.0 Sender: jmmv@meroh.net Received: by 10.107.33.209 with HTTP; Wed, 6 Aug 2014 19:28:18 -0700 (PDT) X-Originating-IP: [184.153.117.174] In-Reply-To: References: From: Julio Merino Date: Wed, 6 Aug 2014 22:28:18 -0400 X-Google-Sender-Auth: EKZ3B5HcLKKMMb5SJFQiUkmxNEo Message-ID: Subject: Re: Best place to learn how to write tests which work under kyua? To: Craig Rodrigues Content-Type: text/plain; charset=UTF-8 Cc: "freebsd-testing@freebsd.org" X-BeenThere: freebsd-testing@freebsd.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Testing on FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 07 Aug 2014 02:28:40 -0000 On Mon, Aug 4, 2014 at 2:54 PM, Craig Rodrigues wrote: > On Thu, Jul 24, 2014 at 1:02 PM, Julio Merino wrote: >> >> >> What kind of text would help you most? A step-by-step tutorial maybe? >> Big parts of the process may be tied to the build system you use >> though, and I only know the BSD build systems and Automake/autoconf... > > > I need a step-by-step tutorial for how to write a Kyuafile. I am > not going to be using any of the FreeBSD Makefile infrastructure > for running tests, so I don't need that info. I am going to be > migrating some existing tests into a form that can be run under kyua, > so that I can do: "kyua report-junit". > > In future, where is the central source for kyua documentation going to live? The authoritative documentation is in the manual pages, but that's more of a reference manual than an introduction. Introductory text and assorted articles should either be in the project's wiki or linked from it. > I see docs are scattered across: > > > http://wiki.netbsd.org/kyua/ > https://wiki.freebsd.org/TestingFreeBSD > https://wiki.freebsd.org/TestSuite > https://github.com/jmmv/kyua/wiki I have started collecting a list in the wiki, including the links you provided and others. I have some plans that will make things simpler and in turn will make the process of documentation easier, but details on those will come once I have cut a new release (hopefully this week). I'm also long overdue in writing a from-scratch tutorial, which is much necessary. In the meantime, don't hesitate to shoot questions at kyua-discuss@