[Sommaire] [Imprimer]

   1  <commands version="1.0">
   2   <package>
   3    <summary>Build Package</summary>
   4    <function>doPackage</function>
   5    <shortcut>p</shortcut>
   6    <options>
   7     <nocompress>
   8      <shortopt>Z</shortopt>
   9      <doc>Do not gzip the package file</doc>
  10     </nocompress>
  11     <showname>
  12      <shortopt>n</shortopt>
  13      <doc>Print the name of the packaged file.</doc>
  14     </showname>
  15    </options>
  16    <doc>[descfile] [descfile2]
  17  Creates a PEAR package from its description file (usually called
  18  package.xml).  If a second packagefile is passed in, then
  19  the packager will check to make sure that one is a package.xml
  20  version 1.0, and the other is a package.xml version 2.0.  The
  21  package.xml version 1.0 will be saved as &quot;package.xml&quot; in the archive,
  22  and the other as &quot;package2.xml&quot; in the archive&quot;
  23  </doc>
  24   </package>
  25   <package-validate>
  26    <summary>Validate Package Consistency</summary>
  27    <function>doPackageValidate</function>
  28    <shortcut>pv</shortcut>
  29    <options />
  30    <doc>
  31  </doc>
  32   </package-validate>
  33   <cvsdiff>
  34    <summary>Run a &quot;cvs diff&quot; for all files in a package</summary>
  35    <function>doCvsDiff</function>
  36    <shortcut>cd</shortcut>
  37    <options>
  38     <quiet>
  39      <shortopt>q</shortopt>
  40      <doc>Be quiet</doc>
  41     </quiet>
  42     <reallyquiet>
  43      <shortopt>Q</shortopt>
  44      <doc>Be really quiet</doc>
  45     </reallyquiet>
  46     <date>
  47      <shortopt>D</shortopt>
  48      <doc>Diff against revision of DATE</doc>
  49      <arg>DATE</arg>
  50     </date>
  51     <release>
  52      <shortopt>R</shortopt>
  53      <doc>Diff against tag for package release REL</doc>
  54      <arg>REL</arg>
  55     </release>
  56     <revision>
  57      <shortopt>r</shortopt>
  58      <doc>Diff against revision REV</doc>
  59      <arg>REV</arg>
  60     </revision>
  61     <context>
  62      <shortopt>c</shortopt>
  63      <doc>Generate context diff</doc>
  64     </context>
  65     <unified>
  66      <shortopt>u</shortopt>
  67      <doc>Generate unified diff</doc>
  68     </unified>
  69     <ignore-case>
  70      <shortopt>i</shortopt>
  71      <doc>Ignore case, consider upper- and lower-case letters equivalent</doc>
  72     </ignore-case>
  73     <ignore-whitespace>
  74      <shortopt>b</shortopt>
  75      <doc>Ignore changes in amount of white space</doc>
  76     </ignore-whitespace>
  77     <ignore-blank-lines>
  78      <shortopt>B</shortopt>
  79      <doc>Ignore changes that insert or delete blank lines</doc>
  80     </ignore-blank-lines>
  81     <brief>
  82      <doc>Report only whether the files differ, no details</doc>
  83     </brief>
  84     <dry-run>
  85      <shortopt>n</shortopt>
  86      <doc>Don&apos;t do anything, just pretend</doc>
  87     </dry-run>
  88    </options>
  89    <doc>&lt;package.xml&gt;
  90  Compares all the files in a package.  Without any options, this
  91  command will compare the current code with the last checked-in code.
  92  Using the -r or -R option you may compare the current code with that
  93  of a specific release.
  94  </doc>
  95   </cvsdiff>
  96   <cvstag>
  97    <summary>Set CVS Release Tag</summary>
  98    <function>doCvsTag</function>
  99    <shortcut>ct</shortcut>
 100    <options>
 101     <quiet>
 102      <shortopt>q</shortopt>
 103      <doc>Be quiet</doc>
 104     </quiet>
 105     <reallyquiet>
 106      <shortopt>Q</shortopt>
 107      <doc>Be really quiet</doc>
 108     </reallyquiet>
 109     <slide>
 110      <shortopt>F</shortopt>
 111      <doc>Move (slide) tag if it exists</doc>
 112     </slide>
 113     <delete>
 114      <shortopt>d</shortopt>
 115      <doc>Remove tag</doc>
 116     </delete>
 117     <dry-run>
 118      <shortopt>n</shortopt>
 119      <doc>Don&apos;t do anything, just pretend</doc>
 120     </dry-run>
 121    </options>
 122    <doc>&lt;package.xml&gt;
 123  Sets a CVS tag on all files in a package.  Use this command after you have
 124  packaged a distribution tarball with the &quot;package&quot; command to tag what
 125  revisions of what files were in that release.  If need to fix something
 126  after running cvstag once, but before the tarball is released to the public,
 127  use the &quot;slide&quot; option to move the release tag.
 128  </doc>
 129   </cvstag>
 130   <package-dependencies>
 131    <summary>Show package dependencies</summary>
 132    <function>doPackageDependencies</function>
 133    <shortcut>pd</shortcut>
 134    <options />
 135    <doc>
 136  List all dependencies the package has.</doc>
 137   </package-dependencies>
 138   <sign>
 139    <summary>Sign a package distribution file</summary>
 140    <function>doSign</function>
 141    <shortcut>si</shortcut>
 142    <options />
 143    <doc>&lt;package-file&gt;
 144  Signs a package distribution (.tar or .tgz) file with GnuPG.</doc>
 145   </sign>
 146   <makerpm>
 147    <summary>Builds an RPM spec file from a PEAR package</summary>
 148    <function>doMakeRPM</function>
 149    <shortcut>rpm</shortcut>
 150    <options>
 151     <spec-template>
 152      <shortopt>t</shortopt>
 153      <arg>FILE</arg>
 154      <doc>Use FILE as RPM spec file template</doc>
 155     </spec-template>
 156     <rpm-pkgname>
 157      <shortopt>p</shortopt>
 158      <arg>FORMAT</arg>
 159      <doc>Use FORMAT as format string for RPM package name, %s is replaced
 160  by the PEAR package name, defaults to &quot;PEAR::%s&quot;.</doc>
 161     </rpm-pkgname>
 162    </options>
 163    <doc>&lt;package-file&gt;
 164  
 165  Creates an RPM .spec file for wrapping a PEAR package inside an RPM
 166  package.  Intended to be used from the SPECS directory, with the PEAR
 167  package tarball in the SOURCES directory:
 168  
 169  $ pear makerpm ../SOURCES/Net_Socket-1.0.tgz
 170  Wrote RPM spec file PEAR::Net_Geo-1.0.spec
 171  $ rpm -bb PEAR::Net_Socket-1.0.spec
 172  ...
 173  Wrote: /usr/src/redhat/RPMS/i386/PEAR::Net_Socket-1.0-1.i386.rpm
 174  </doc>
 175   </makerpm>
 176   <convert>
 177    <summary>Convert a package.xml 1.0 to package.xml 2.0 format</summary>
 178    <function>doConvert</function>
 179    <shortcut>c2</shortcut>
 180    <options>
 181     <flat>
 182      <shortopt>f</shortopt>
 183      <doc>do not beautify the filelist.</doc>
 184     </flat>
 185    </options>
 186    <doc>[descfile] [descfile2]
 187  Converts a package.xml in 1.0 format into a package.xml
 188  in 2.0 format.  The new file will be named package2.xml by default,
 189  and package.xml will be used as the old file by default.
 190  This is not the most intelligent conversion, and should only be
 191  used for automated conversion or learning the format.
 192  </doc>
 193   </convert>
 194  </commands>