Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 6 Aug 2014 22:28:18 -0400
From:      Julio Merino <jmmv@freebsd.org>
To:        Craig Rodrigues <rodrigc@freebsd.org>
Cc:        "freebsd-testing@freebsd.org" <freebsd-testing@freebsd.org>
Subject:   Re: Best place to learn how to write tests which work under kyua?
Message-ID:  <CAFY7cWDxSZ_FjJ%2BFEfQEmUYMo%2BnVNod%2Be5GD0x-OBf_arECReg@mail.gmail.com>
In-Reply-To: <CAG=rPVcr7eujVBtqr9PDOmHtjkSbZ2o=ce8jh4gxKPyHaCc6uQ@mail.gmail.com>
References:  <CAG=rPVd8JBGoPg9F%2BwkRZ63m4nKgO-uWybD=hPSpCaPh_ZH3Uw@mail.gmail.com> <CAFY7cWDNyujpy3aWxO3F0bE9PwApnvxr3Df7nyVR_ziO6wTOaw@mail.gmail.com> <CAG=rPVcr7eujVBtqr9PDOmHtjkSbZ2o=ce8jh4gxKPyHaCc6uQ@mail.gmail.com>

next in thread | previous in thread | raw e-mail | index | archive | help
On Mon, Aug 4, 2014 at 2:54 PM, Craig Rodrigues <rodrigc@freebsd.org> wrote:
> On Thu, Jul 24, 2014 at 1:02 PM, Julio Merino <jmmv@freebsd.org> 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@



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAFY7cWDxSZ_FjJ%2BFEfQEmUYMo%2BnVNod%2Be5GD0x-OBf_arECReg>