<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
                   "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<!-- lifted from troff+man by doclifter -->
<refentry id='chgdesc1'>
<!--  @(#)chgdesc.1 2001/04/02 NIST -->
<!--  I Image Group -->
<!--  G. T. Candela &amp; Craig I. Watson -->

<refmeta>
<refentrytitle>CHGDESC</refentrytitle>
<manvolnum>1A</manvolnum>
<refmiscinfo class='date'>02 April 2001</refmiscinfo>
<refmiscinfo class='source'>NIST</refmiscinfo>
<refmiscinfo class='manual'>NFIS Reference Manual</refmiscinfo>
</refmeta>
<refnamediv id='name'>
<refname>chgdesc</refname>
<refpurpose>changes the description string of a PCASYS data file.</refpurpose>
</refnamediv>
<!-- body begins here -->
<refsynopsisdiv id='synopsis'>
<cmdsynopsis>
  <command>chgdesc</command>    
    <arg choice='plain'><replaceable>&lt;datafile&gt;&lt;new_desc&gt;</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>


<refsect1 id='description'><title>DESCRIPTION</title>
<para><emphasis remap='B'>Chgdesc</emphasis>
replaces the existing description string of a PCASYS data file with
the provided string.</para>

<para>The new description can be of any length, but it must not contain
embedded newline characters.  If it contains spaces, tabs, or shell
metacharacters that are not to be expanded, then it should be quoted.
To delete a file's description string, i.e. to replace it with the
empty string, use '' (quoted empty string) as the string argument.</para>

<para>The command makes, and then removes, a temporary version of the data
file, in the same directory as the original file; its filename is the
original filename with _chgdesc&lt;pid&gt; appended, where &lt;pid&gt; is the
process id of the chgdesc command instance.  (In the unlikely event
that a file of this name already exists, chgdesc exits with an error
message, rather than replacing that file.)  If the original data file
is large, then make sure, before running chgdesc, that the disk
partition where the original file lives has enough room for the
temporary copy.</para>
</refsect1>

<refsect1 id='options'><title>OPTIONS</title>
<variablelist remap='TP'>
  <varlistentry>
  <term><emphasis remap='I'>&lt;datafile&gt;</emphasis></term>
  <listitem>
<para>Data file whose description field is to be changed.</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis remap='I'>&lt;new_desc&gt;</emphasis></term>
  <listitem>
<para>The new description string.</para>
  </listitem>
  </varlistentry>
</variablelist>
</refsect1>

<refsect1 id='examples'><title>EXAMPLE(S)</title>
<para>From <emphasis remap='I'>test/pcasys/execs/chgdesc/chgdesc.src</emphasis>:</para>

<!-- .RS -->
<para><emphasis remap='B'>% chgdesc fv1.acl 'fv1.cls'</emphasis>
<!-- .br -->
Puts the string fv1.cls in the description field of the
file fv1.acl.</para>
</refsect1>

<refsect1 id='see_also'><title>SEE ALSO</title>
<para>datainfo (1A)</para>

</refsect1>

<refsect1 id='author'><title>AUTHOR</title>
<para>NIST/ITL/DIV894/Image Group</para>
</refsect1>
</refentry>

