<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">

<refentry>
  <refentryinfo>
    <date>2002-04-29</date>
  </refentryinfo>

  <refmeta>
    <refentrytitle>prcs-utils</refentrytitle>
    <manvolnum>1</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>prcs-utils</refname>
    <refpurpose>Some utilities to be used in combination with PRCS</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis>
      <command>prcspatch</>
    </cmdsynopsis>

    <cmdsynopsis>
      <command>prcspatch2</>
      <arg opt><option>-m <replaceable>log-message</></option></arg>
      <arg req><replaceable>project</></arg>
      <arg req><replaceable>version1</></arg>
      <arg req><replaceable>version2</></arg>
    </cmdsynopsis>

    <cmdsynopsis>
      <command>prcsfind</>
      <arg req repeat><replaceable>grep-argument</></arg>
    </cmdsynopsis>

    <cmdsynopsis>
      <command>prcsbranches</>
      <arg opt><replaceable>project</></arg>
    </cmdsynopsis>

    <cmdsynopsis>
      <command>prcsguess</>
    </cmdsynopsis>

    <cmdsynopsis>
      <command>prcsentry</>
      <arg req><replaceable>entry-name</></arg>
    </cmdsynopsis>

    <cmdsynopsis>
      <command>prcs_checkfiles</>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1>
    <title>Description</title>

    <variablelist>
      <varlistentry>
	<term>prcspatch</term>
	<listitem>
	  <para>Prints on stdout the diffs for not-yet-checked-in
	  changes, ignoring the project descriptor.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>prcspatch2</term>
	<listitem>
	  <para>Creates a patch file for project and revisions given on
	  command line.  Patch file contains differences between given
	  revisions and is named <filename><replaceable
	  >project</>-<replaceable >version1</>-<replaceable
	  >project</>-<replaceable >version2</>.patch</>.</para>

	  <para><option>-m</> allows to give a message log (which
	  defaults to contents of <literal>Version-Log</> entry of
	  <replaceable>version2</>).</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>prcsfind</term>
	<listitem>
	  <para>Should be used in combination with emacs's 'M-x grep'
	  replace the <literal>grep -n</> command with a call to
	  <command>prcsfind</>.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>prcsbranches</term>
	<listitem>
	  <para>Displays the different branch names of a project.  If
	  not passed as parameter, the project is found from a .prj
	  file in current directory.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>prcsguess</term>
	<listitem>
	  <para>Tries to guess the project in a certain directory.
	  result on stdout, return 1 if no successfull guess could be
	  done, 2 in case of trouble.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>prcsentry</term>
	<listitem>
	  <para>Prints the contents of an entry of the project
	  descriptor.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>prcs_checkfiles</term>
	<listitem>
	  <para>Check the file list in the prcs project file with the
	  files (not directories) in the current source tree.  Double
	  checks the populate-ignore list.</para>
	</listitem>
      </varlistentry>
    </variablelist>

  <refsect1>
    <title>See also</title>

    <para><citerefentry> <refentrytitle>prcs</> <manvolnum>1</>
      </citerefentry>.</para>
  </refsect1>

  <refsect1>
    <title>Author</title>

    <para>Hugo Cornelis <email>hugo@bbf.uia.ac.be</>.</para>

    <para>This manual page was written by Rafael Laboissiere
    <email>rafael@debian.org</>, and later translated to DocBook and
    enhanced by Yann Dirson <email>dirson@debian.org</></para>
  </refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-shorttag:t
sgml-minimize-attributes:t
sgml-always-quote-attributes:nil
End:
-->
