XML format for Acrobat JavaScript

Question

Hi,
This is my first posting to any Adobe forum, so please bear with me...
I'm interested in the XML format for Acrobat JavaScript.  I'll be using an external editor (UltraEdit).  When I do (in Acrobat 8) Advanced-->Document Processing-->Edit All JavaScripts, UltraEdit starts off with this:
//-----------------Do not edit the XML tags--------------------
Interesting, but not very useful.  If I look at some existing PDF files containing JavaScript, I see things like:
//-----------------Do not edit the XML tags--------------------
//<Document-Level>
//<ACRO_source>DocOpen</ACRO_source>
//<ACRO_script>
/*********** belongs to: Document-Level:DocOpen ***********/
OK, this is better.  In fact, if I look at enough existing PDF files containing JavaScript, I could probably figure out the XML format by myself, including the XML format of tags like <Page-Actions>,  <AcroForm>, etc.  However, it would be far easier to get the specification of the JavaScript XML format -- for example, what is the format of the text following the "belongs to:" string within the various types of XML tags?
I *presume* this is documented somewhere but I couldn't find it.  If someone has the Acrobat JavaScript XML format specification, it would be greatly appreciated.
Thanks.
Dave
P.S. Another possible approach would be to create JavaScripts myself using Advanced-->Document Processing-->Document JavaScripts, and then see what XML is created based on the code I enter into the GUI, e.g. form code, functions, etc. This also seems somewhat inefficient, presuming again that the JavaScript XML format is already documented.

Answer 1

Thanks for the additional information.
I played with JavaScript some more, using my preferred editor, UltraEdit, which I attached to Acrobat.  I thought I would be able to take a JavaScript program from one PDF file (source file) and do a copy & paste into another PDF file (destination file).  While I can do the paste (again, via UltraEdit) into the destination file and can do an UltraEdit Save, when I go back into UltraEdit via Advanced --> Document Processing --> Edit All JavaScripts, the JavaScript I pasted from the source file to the destination file isn't there in the destination file.
From this, I concluded that I'll need to create the Document-level JavaScript and the form field Javascripts (e.g. a JavaScript triggered by a "Mouse Down" in a button) via the Acrobat GUI's.  Acrobat doesn't seem to like it if I bypass the GUIs and just attempt to paste the code directly into the PDF file via an editor.  By not using the GUI and just doing the cut & paste as I did, I'm probably missing some part of the code setup/creation process that Acrobat needs to know about.
This is why I originally asked about the syntax for the pseudo-XML, thinking I could just copy the pseudo-XML/JavaScript code from one PDF file to another, and then modify the code to reflect the needs of the destination PDF.  Now I understand the need you mentioned to use the Acrobat GUIs to set up the initial XML/JavaScript structure.
Once I have the XML structure set up in the destination file (e.g. a JavaScript triggered by a "Mouse Down" in a button), I can obviously copy code snippets into that <AcroForm> sections, I just can't *create* the original "Mouse Down" <AcroForm> sections via the editor.
Another approach I could follow would be to make a copy of the original source file and change the name of the copy to the desired destination file name, and then start modifying the code in the new (destination) file -- presuming that's the easiest path to get the desired functionality created.  This way, I wouldn't have to manually (via the Acrobat GUI) create all of the <Document-Level> and <AcroForm> sections.
Thanks for your (and others') help, let me know if I'm missing anything.
Dave