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.