Diff for /wikisrc/kyua/import.mdwn between versions 1.5 and 1.6

version 1.5, 2012/09/03 22:37:28 version 1.6, 2012/09/10 14:39:54
Line 150  keyword.  In particular, the following a Line 150  keyword.  In particular, the following a
 the review:  the review:
   
 * [Issue 40](http://code.google.com/p/kyua/issues/detail?id=40): Provide  * [Issue 40](http://code.google.com/p/kyua/issues/detail?id=40): Provide
   manpages instead of an info document.    manpages instead of an info document.  **DONE**
   
 ## Import Kyua into src  ## Import Kyua into src
   
Line 177  The specific steps to perform this impor Line 177  The specific steps to perform this impor
    binary in `/usr/bin`, a lot of test programs in `/usr/tests/kyua-cli`     binary in `/usr/bin`, a lot of test programs in `/usr/tests/kyua-cli`
    (around 100) and some auxiliary files in `/usr/share/kyua`.     (around 100) and some auxiliary files in `/usr/share/kyua`.
   
 1. Protect all products of Lutok and Kyua with a new `MKKYUA` knob.  Once  1. Protect all products of Lutok and Kyua with a new `MKKYUA` knob.  **Set
    the ATF tools are removed, the existence of both the `MKATF` and     `MKKYUA=no` by default.**  Once the ATF tools are removed, the existence
    `MKKYUA` knows will probably be confusing.  When that happens, we can     of both the `MKATF` and `MKKYUA` knows will probably be confusing.  When
    revisit this decision by possibly replacing both with an `MKTESTS`.     that happens, we can revisit this decision by possibly replacing both
      with an `MKTESTS`.
   
 1. Update `bsd.test.mk` to generate `Kyuafile`s *in addition to*  1. Update `bsd.test.mk` to generate `Kyuafile`s *in addition to*
    `Atffile`s.     `Atffile`s.
   
 There is no real need to do this import in a branch given that this import  There is no real need to do this import in a branch given that this import
 only adds new functionality without touching existing stuff.  only adds new functionality without touching existing stuff, and the new
   code is disabled by default.
   
 All the preparatory work for the import can be done offline (in about two  All the preparatory work for the import can be done offline (in about two
 weeks at most, given that I have mot of this ready).  Aside from the code  weeks at most, given that I have mot of this ready).  Aside from the code
Line 197  consider that some other tricky architec Line 199  consider that some other tricky architec
   
 The submission step to CVS, once all the code changes are ready locally,  The submission step to CVS, once all the code changes are ready locally,
 and any post-commit validation checks will take a few hours.  Any build  and any post-commit validation checks will take a few hours.  Any build
 breakage should be addressed in a timely manner (and can possibly be  breakage should be addressed in a timely manner, but these should be very
 worked-around by setting `MKKYUA=no`).  limited in scope and risk because the default will still be `MKKYUA=no` at
   this point.
 ## Update documentation  
   
 The [[Kyua: An introduction for NetBSD users|/kyua]] wiki page will be  
 updated to explain how Kyua is bundled in NetBSD and how to use the bundled  
 version.  
   
 The [[Creating atf-based tests for NetBSD src|/tutorials/atf]] wiki page  
 will be updated to account for the differences in test programs execution  
 with Kyua instead of ATF.  
   
 The afterboot(8) and tests(7) manpages will be adjusted to mention `kyua`  
 instead of the ATF tools.  
   
 ## Adjust continuous testing systems to use Kyua  ## Adjust continuous testing systems to use Kyua
   
Line 237  reimport (as has often been done in ATF) Line 227  reimport (as has often been done in ATF)
 This step can take a few weeks of time, mostly due to the back and forth  This step can take a few weeks of time, mostly due to the back and forth
 between different people in different timezones.  between different people in different timezones.
   
   ## Flip MKKYUA to yet
   
   The previous steps imported Kyua but didn't enable its build by default so
   that proper testing can be performed by the only people that care.  Once
   basic testing (particularly build testing on a variety of platforms) is
   performed, flip `MKKYUA=yes`.
   
   ## Update documentation
   
   The [[Kyua: An introduction for NetBSD users|/kyua]] wiki page will be
   updated to explain how Kyua is bundled in NetBSD and how to use the bundled
   version.
   
   The [[Creating atf-based tests for NetBSD src|/tutorials/atf]] wiki page
   will be updated to account for the differences in test programs execution
   with Kyua instead of ATF.
   
   The afterboot(8) and tests(7) manpages will be adjusted to mention `kyua`
   instead of the ATF tools.
   
 ## User validation period  ## User validation period
   
 At this stage, **at least one month shall be given to the community** to  At this stage, **at least one month shall be given to the community** to

Removed from v.1.5  
changed lines
  Added in v.1.6


CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb