# The MIT License
#
# Copyright (c) 2004-2010, Sun Microsystems, Inc., Alan Harder
#
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in
# all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
# THE SOFTWARE.

blurb.1=\
  When there are changes in how data is stored on disk, Jenkins uses the following strategy: \
  data is migrated to the new structure when it is loaded, but the file is not resaved in the \
  new format.  This allows for downgrading Jenkins if needed.  However, it can also leave data \
  on disk in the old format indefinitely.  The table below lists files containing such data, \
  and the Jenkins version(s) where the data structure was changed.
blurb.2=\
  Sometimes errors occur while reading data (if a plugin adds some data and that plugin is \
  later disabled, if migration code is not written for structure changes, or if Jenkins is \
  downgraded after it has already written data not readable by the older version). \
  These errors are logged, but the unreadable data is then skipped over, allowing Jenkins to \
  startup and function properly.
blurb.3=\
  The form below may be used to resave these files in the current format.  Doing so means a \
  downgrade to a Jenkins release older than the selected version will not be able to read the \
  data stored in the new format.  Note that simply using Jenkins to create and configure jobs \
  and run builds can save data that may not be readable by older Jenkins releases, even when \
  this form is not used.  Also if any unreadable data errors are reported in the right side \
  of the table above, note that this data will be lost when the file is resaved.
blurb.4=\
  Eventually the code supporting these data migrations may be removed.  Compatibility will be \
  retained for at least 150 releases since the structure change.  Versions older than this are \
  in bold above, and it is recommended to resave these files.
blurb.5=\
  (downgrade as far back as the selected version may still be possible)
blurb.6=\
  It is acceptable to leave unreadable data in these files, as Jenkins will safely ignore it. \
  To avoid the log messages at Jenkins startup you can permanently delete the unreadable data \
  by resaving these files using the button below.
