1 # Copyright (c) 2009 Symbian Foundation Ltd

     2 # This component and the accompanying materials are made available

     3 # under the terms of the License "Eclipse Public License v1.0"

     4 # which accompanies this distribution, and is available

     5 # at the URL "http://www.eclipse.org/legal/epl-v10.html".

     6 #

     7 # Initial Contributors:

     8 # Symbian Foundation Ltd - initial contribution.

     9 #

    10 # Contributors:

    11 # mattd <mattd@symbian.org>

    12 #

    13 # Description:

    14 # DBR intro - displays some introductory information

    15 

    16 def run(args):

    17   help()

    18 

    19 def help():  

    20   l1 ='\nDBR tools are simply a way of checking what has been changed in the build you are using.' 

    21   l2 ='\n\nUnlike CBRs, they intentionally make no attempt at understanding components,'

    22   l3 ='and subsequently they do not have the restrictions that CBRs require.'

    23   l4 ='\n\nGenerally speaking all developers work from builds of the whole platform,'

    24   l5 ='and developers want to change the build, and know what they have changed,'

    25   l6 ='what has changed between builds, or what they have different to other developers'

    26   l7 ='with as little hastle as possible.'

    27   

    28   l8 ='\nThere is a patching mechanism for developer providing patches to eachother for the short-term,'

    29   l9 ='but the idea is that patches are short-lived, unlike CBRs where they can live forever.'

    30   l10 ='\n\nIn short, you get most of the benefits of CBRs without the hastle.'  

    31   print l1,l2,l3,l4,l5,l6,l7,l8,l9,l10  

    32 

    33   s1='\nHow To use\n\n'

    34   s2='Starting Method 1:\n'

    35   s3='\t1. Unpack all your zips on to a clean drive\n'

    36   s4='\t2. Ensure you\'ve extracted the MD5s into epoc32/relinfo\n'

    37   s5='\t3. Run \'dbr checkenv\' to generate a database\n\n'

    38   s6='Starting Method 2:\n'

    39   s7='\t1. Run \'dbr getenv <build_location>\' to install a full build and configure the database\n\n'

    40   s8='If you want to know what you\'ve changed, run \'dbr checkenv\'\n'

    41   s9='If you want to clean the environment run \'dbr cleanenv\'\n'

    42   s10='If you want to compare two baselines run \'dbr diffenv <env1> <env2>\'\n'

    43   

    44   

    45   print s1,s2,s3,s4,s5,s6,s7,s8,s9, s10

    46