# Copyright (c) 2009 Symbian Foundation Ltd
# This component and the accompanying materials are made available
# under the terms of the License "Eclipse Public License v1.0"
# which accompanies this distribution, and is available
# at the URL "http://www.eclipse.org/legal/epl-v10.html".
#
# Initial Contributors:
# Symbian Foundation Ltd - initial contribution.
#
# Contributors:
# mattd <mattd@symbian.org>
#
# Description:
# DBR intro - displays some introductory information

def run(args):
  help()

def help():  
  l1 ='\nDBR tools are simply a way of checking what has been changed in the build you are using.' 
  l2 ='\n\nUnlike CBRs, they intentionally make no attempt at understanding components,'
  l3 ='and subsequently they do not have the restrictions that CBRs require.'
  l4 ='\n\nGenerally speaking all developers work from builds of the whole platform,'
  l5 ='and developers want to change the build, and know what they have changed,'
  l6 ='what has changed between builds, or what they have different to other developers'
  l7 ='with as little hastle as possible.'
  
  l8 ='\nThere is a patching mechanism for developer providing patches to eachother for the short-term,'
  l9 ='but the idea is that patches are short-lived, unlike CBRs where they can live forever.'
  l10 ='\n\nIn short, you get most of the benefits of CBRs without the hastle.'  
  print l1,l2,l3,l4,l5,l6,l7,l8,l9,l10  

  s1='\nHow To use\n\n'
  s2='Starting Method 1:\n'
  s3='\t1. Unpack all your zips on to a clean drive\n'
  s4='\t2. Ensure you\'ve extracted the MD5s into epoc32/relinfo\n'
  s5='\t3. Run \'dbr checkenv\' to generate a database\n\n'
  s6='Starting Method 2:\n'
  s7='\t1. Run \'dbr getenv <build_location>\' to install a full build and configure the database\n\n'
  s8='If you want to know what you\'ve changed, run \'dbr checkenv\'\n'
  s9='If you want to clean the environment run \'dbr cleanenv\'\n'
  s10='If you want to compare two baselines run \'dbr diffenv <env1> <env2>\'\n'
  
  
  print s1,s2,s3,s4,s5,s6,s7,s8,s9, s10
  

def summary():
  return "Brief introduction"

def smoketest():
  print 'OK'