Diff for /wikisrc/kyua/import.mdwn between versions 1.1 and 1.3

version 1.1, 2012/09/01 19:23:37 version 1.3, 2012/09/01 19:58:18
Line 17  plan should be executed well in advance  Line 17  plan should be executed well in advance 
 ensure there is enough time in NetBSD-current to flesh out any major  ensure there is enough time in NetBSD-current to flesh out any major
 problems.  problems.
   
 Before moving on, please read the  **Before moving on, please read the
 [Kyua: An introduction for NetBSD users](kyua) page.  You should be  [[Kyua: An introduction for NetBSD users|/kyua]] page.  You should be
 familiar with the structure of Kyua and its major components to be able to  familiar with the structure of Kyua and its major components to be able to
 review this plan.  review this plan.**
   
 # Proposed changes  # Proposed changes
   
Line 58  across two major releases: Line 58  across two major releases:
 * Removal of the backwards compatibility `atf-run` and `atf-report`  * Removal of the backwards compatibility `atf-run` and `atf-report`
   scripts, as well as the supporting `atf2kyua` tool.    scripts, as well as the supporting `atf2kyua` tool.
   
 # Why now?  # Why?
   
   As mentioned in [[another page|/kyua]], Kyua should be seen as ATF 2.x even
   though it carries a different name.  It is the evolution of the previous
   ATF tools (*the tools only*), but written in a more modular and flexible
   way, and with a more reliable codebase.  Therefore, you should consider
   this project as the update of ATF to a newer version.
   
   The `atf-run` and `atf-report` tools have effectively been in maintenance
   mode for over a year already.  None of the desired features (see the list
   of open PRs) have been implemented on top of them, mostly because doing so
   is building upon a broken implementation.  Additionally, several developers
   have had to implement their own test results dashboards due to
   defficiencies in `atf-report`, effectively reinventing the wheel.
   
   This update will permit the real removal of the obsolete tools, thus
   allowing us to build additional features on top of Kyua without having to
   worry about being compatible with `atf-run` (and thus adjusting this tool
   to behave in the same manner).
   
   Some possible answers to "Why not?" can be found later in this page.
   
   ## And why now?
   
 Kyua has existed for almost 3 years already, so you may be wondering why  Kyua has existed for almost 3 years already, so you may be wondering why
 this import is being proposed now.  The major reasons are:  this import is being proposed now.  The major reasons are:
Line 116  that should be made before the plan can  Line 138  that should be made before the plan can 
   
 ## Import Kyua into src  ## Import Kyua into src
   
 As the [introductory page to Kyua](kyua) describes, Kyua has been available  As the [[introductory page to Kyua|/kyua]] describes, Kyua has been
 in pkgsrc for a while and can be readily installed and used to run the  available in pkgsrc for a while and can be readily installed and used to
 tests from `/usr/tests`.  run the tests from `/usr/tests`.
   
 However, because ATF lives in src, and because NetBSD aims to provide the  However, because ATF lives in src, and because NetBSD aims to provide the
 best environment for testing "out of the box", Kyua should be imported into  best environment for testing "out of the box", Kyua should be imported into
Line 164  worked-around by setting `MKATF=no`). Line 186  worked-around by setting `MKATF=no`).
   
 ## Update documentation  ## Update documentation
   
 The [Kyua: An introduction for NetBSD users](kyua) wiki page will be  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  updated to explain how Kyua is bundled in NetBSD and how to use the bundled
 version.  version.
   
 The [Creating atf-based tests for NetBSD src](atf) wiki page will be  The [[Creating atf-based tests for NetBSD src|/tutorials/atf]] wiki page
 updated to account for the differences in test programs execution with Kyua  will be updated to account for the differences in test programs execution
 instead of ATF.  with Kyua instead of ATF.
   
 The afterboot(8) and tests(7) manpages will be adjusted to mention `kyua`  The afterboot(8) and tests(7) manpages will be adjusted to mention `kyua`
 instead of the ATF tools.  instead of the ATF tools.

Removed from v.1.1  
changed lines
  Added in v.1.3


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