file

Once you've edited a blank template (or obtained an issue to edit using the cat command), you can use the file command to refile the issue. Note: if you obtain an issue via "cat" and change the "yaktrackid" of the root element, you will overwrite the issue with the new "yaktrackid"!. Yaktrack uses the "yaktrackid" to identify issues and define where they should be kept, so never change this value. The semantics of this are slightly different from those of the command-line version; here, simply send the message with a subject line of "file" and the body of the message containing the text of the issue to be filed. Send the message in plain text format; don't send it as HTML, RTF, or anything else!

In our next example, the user is filing the same defect as he did in the command-line example:

[vputz@yak_prime temp]$ mail yaktrack
Subject: file
<?xml version="1.0"?>
<!DOCTYPE defect SYSTEM "defect">

<defect yaktrackid='defect2' confidential='no' test='new_value'>
  <submitterid>vputz@wingedyak.com</submitterid>
  <originator>Winged Yak Productions testing facility</originator>
  <synopsis>New version's installation program highly unstable; addresses hardware detonator registers in an unsafe manner</synopsis>
</defect>
(presses control-D to terminate message)
Cc: (presses return)
[vputz@yak_prime temp]$ mail
Mail version 8.1 6/6/93.  Type ? for help.
"/var/spool/mail/vputz": 1 message 1 new
>N  1 yaktrack@yak_prime.w  Tue May  9 10:27  12/473  
& 1
Message 1:
From yaktrack@yak_prime.wingedyak.com  Tue May  9 10:27:29 2000
Date: Tue, 9 May 2000 10:27:29 -0600
From: yaktrack@yak_prime.wingedyak.com
To: vputz@yak_prime.wingedyak.com

Was stored successfully with id defect2