--- toast 2003/11/02 20:36:31 1.235 +++ toast 2003/11/02 21:59:05 1.236 @@ -4819,20 +4819,24 @@ =item S<B<--autoclean> | B<--noautoclean>> -When B<autoclean> is enabled, B<toast build> performs an implicit B<toast -clean> on every newly created non-broken build. Default: enabled. +When B<autoclean> is enabled, commands that create a new build for a +package (such as B<toast rebuild>) implicitly remove any pre-existing +broken builds from that package before creating the new build; also, +whenever a new build succeeds, it is implicitly cleaned as if by B<toast +clean>. Note that newly created broken builds will not be immediately +cleaned or removed, even if this option is enabled, so as to make it +easier to diagnose build problems. Default: enabled. =item S<B<--autopurge> | B<--noautopurge>> -When B<autopurge> is enabled, B<toast build> performs an implicit -B<toast purge> on every package with a newly created non-broken build. -Default: disabled. +When B<autopurge> is enabled, an implicit B<toast purge> will be performed +on a package as soon as it is successfully built. Default: disabled. =item S<B<--autoarm> | B<--noautoarm>> -When B<autoarm> is enabled, B<toast build> performs an implicit B<toast -arm> on every newly created non-broken build whose package already -contains another armed build. Default: enabled. +When B<autoarm> is enabled, B<toast upgrade> and B<toast rebuild> perform +an implicit B<toast arm> on every newly created non-broken build whose +package already contains another armed build. Default: enabled. =item S<B<--autodisarm> | B<--noautodisarm>> @@ -4844,16 +4848,19 @@ =item S<B<--autodemolish> | B<--noautodemolish>> -When B<autodemolish> is enabled, B<toast build> performs an implicit -B<toast demolish> on every other build belonging to the same package -as a newly-created, non-broken build. Default: disabled. +When B<autodemolish> is enabled, B<toast rebuild> performs an implicit +B<toast demolish> on every other build belonging to the same package as +a newly-created, non-broken build. If B<crossversion> is also enabled, +other packages with the same name will also be demolished. Default: +disabled. =item S<B<--autoremove> | B<--noautoremove>> When both B<autoremove> and B<crossversion> are enabled, B<toast build> performs an implicit B<toast remove> on every other package with the same name as the package containing a newly-created, non-broken build. -Default: disabled. +If B<crossversion> is disabled, this option has no effect. Default: +disabled. =item S<B<--crossversion> | B<--nocrossversion>>