Subversion Repositories DevTools

Rev

Rev 359 | Rev 3559 | Go to most recent revision | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 359 Rev 361
Line 885... Line 885...
885
#   Documentation
885
#   Documentation
886
#
886
#
887
 
887
 
888
=pod
888
=pod
889
 
889
 
-
 
890
=for htmltoc    SYSUTIL::
-
 
891
 
890
=head1 NAME
892
=head1 NAME
891
 
893
 
892
jats_rewrite - Rewrite a build.pl file
894
jats_rewrite - Rewrite a build.pl file
893
 
895
 
894
=head1 SYNOPSIS
896
=head1 SYNOPSIS
Line 986... Line 988...
986
 
988
 
987
This option is used internally, by JATS, to indicate that the utility is being
989
This option is used internally, by JATS, to indicate that the utility is being
988
used to perform controlled rewrite operations. Currently only a value of 1 is
990
used to perform controlled rewrite operations. Currently only a value of 1 is
989
supported. This will:
991
supported. This will:
990
 
992
 
991
=over 8
993
=over 4
-
 
994
 
-
 
995
=item *
-
 
996
 
-
 
997
Suppress warnings about unused packages. The config file may is expected to
-
 
998
contain many more packages than required by the rewrite.
-
 
999
 
-
 
1000
=item *
-
 
1001
 
-
 
1002
Suppress warnings about badly formatted config entries.
992
 
1003
 
993
* Suppress warnings about unused packages. The config file may is expected to contain
-
 
994
  many more packages than required by the rewrite.
1004
=item *
995
 
1005
 
-
 
1006
Will reuse an auto.pl or auto.xml file if its present. Allows user changes to be
996
* Suppress warnings about badly formatted config entries.
1007
made to made to working copies of the build files.
997
 
1008
 
998
* Will reuse an auto.pl or auto.xml file if its present. Allows user changes
-
 
999
to be made to made to working copies of the build files.
1009
=item *
1000
 
1010
 
1001
* Will use build.pl as a template if it is newer than auto.pl. Allows user
1011
Will use build.pl as a template if it is newer than auto.pl. Allows user changes
1002
changes to be made to build.pl.
1012
to be made to build.pl.
1003
 
1013
 
-
 
1014
=item *
-
 
1015
 
1004
* Will not modify the packages own version number, or the previous version number.
1016
Will not modify the packages own version number, or the previous version number.
1005
Only the package dependencies will be modified.
1017
Only the package dependencies will be modified.
1006
 
1018
 
-
 
1019
=item *
-
 
1020
 
1007
* Package-Version that are not in the Release will not be treated as an error.
1021
Package-Version that are not in the Release will not be treated as an error.
-
 
1022
 
-
 
1023
=item *
1008
 
1024
 
1009
* Package-Versions that are in dpkg_archive will generate a warning
1025
Package-Versions that are in dpkg_archive will generate a warning
1010
 
1026
 
1011
=back
1027
=back
1012
 
1028
 
1013
=back
1029
=back
1014
 
1030
 
Line 1040... Line 1056...
1040
=over 8
1056
=over 8
1041
 
1057
 
1042
=item Assigned Items
1058
=item Assigned Items
1043
 
1059
 
1044
These are of the form: B<tag = value> and are used to specify the value of
1060
These are of the form: B<tag = value> and are used to specify the value of
1045
the following B<special> properties:
1061
the following special properties:
1046
 
1062
 
1047
=over 8
1063
=over 8
1048
 
1064
 
1049
=item releasemanager.projectname
1065
=item releasemanager.projectname
1050
 
1066
 
Line 1064... Line 1080...
1064
Specifies the version of a package to use as two, space separated words of the
1080
Specifies the version of a package to use as two, space separated words of the
1065
form C<package_name package_version> where package version is of the form:
1081
form C<package_name package_version> where package version is of the form:
1066
 
1082
 
1067
=over 8
1083
=over 8
1068
 
1084
 
-
 
1085
=item   *
-
 
1086
 
1069
=item   * nn.nn.nnnn.aaa
1087
nn.nn.nnnn.aaa
-
 
1088
 
-
 
1089
=item   *
-
 
1090
 
-
 
1091
nn.nn.nnnn
1070
 
1092
 
1071
=item   * nn.nn.nnnn
1093
=item   *
1072
 
1094
 
1073
=item   * Other
1095
Other
1074
 
1096
 
1075
=back
1097
=back
1076
 
1098
 
1077
=item LinkPkgArchive or BuildPkgArchive
1099
=item LinkPkgArchive or BuildPkgArchive
1078
 
1100
 
Line 1101... Line 1123...
1101
This is the version of the package. It can be rewritten by this program. This
1123
This is the version of the package. It can be rewritten by this program. This
1102
property is mandatory.
1124
property is mandatory.
1103
 
1125
 
1104
=item	releasemanager.projectname
1126
=item	releasemanager.projectname
1105
 
1127
 
1106
If this property is found the value will be replaced with an B<Assigned Item> of the
1128
If this property is found the value will be replaced with an
1107
same name.
1129
L<assigned item|Assigned_Items> of the same name.
1108
 
1130
 
1109
=item	releasemanager.releasename
1131
=item	releasemanager.releasename
1110
 
1132
 
1111
If this property is found the value will be replaced with an B<Assigned Item> of the
1133
If this property is found the value will be replaced with an
1112
same name.
1134
L<assigned item|Assigned_Items> of the same name.
1113
 
1135
 
1114
=back
1136
=back
1115
 
1137
 
1116
Properties that are not B<special> will be treated as the name of a package and
1138
Properties that are not special will be treated as the name of a package and
1117
the value will be updated to reflect the required version of the package.
1139
the value will be updated to reflect the required version of the package.
1118
 
1140
 
1119
The XML rewrite process does not, and cannot handle, instances of packages
1141
The XML rewrite process does not, and cannot handle, instances of packages
1120
that have the same name, but different project suffixes. This is a limitation of
1142
that have the same name, but different project suffixes. This is a limitation of
1121
the ERG ANT build system and not a limitation of this utility.
1143
the ERG ANT build system and not a limitation of this utility.