ArborX

ted

Longname: t ed it   Open the Documentation Legend
Released: not available 
Created: not available 
Alias(es): open, edit 
See also: tdspref tkf trd wint

Summary
 Opens a document for editing. Files can also be opened when you start Arbortext APP, by including their name after typing in Arbortext APP to start the program from a command line.
Example (n/a)
 No example is available for this feature.

Syntax (SVNNA)
ted  start page:n?  file:s? (   bookmark:t?  run autoexec:n? (  load pfi:n  )  )
start page:n
Ø|0  The document will be opened either at page 1 or, if it's page position has been saved using the tdspref macro at the page it was at when last saved.
n  The page of the document to display when the document is opened. If you are using the first form of this macro and do not specify a file to edit, the edit document dialogue box will be invoked with the Page number entry box filled in with this start page.
file:s

The name of the file you want to open for editing. If the file parameter contains wildcard characters the edit document dialogue box will be invoked containing a list of matching files from which you can make a multiple selection. The wildcard can take one of three forms, e.g.

*.3d  File names only.
**.3d  File names + file size.
***.3d  File names + number of pages.
****.3d  File names + file size + number of pages.
Example

The macro shown below lists any files with the extension .3d in the current directory, showing their names, file sizes, and the number of pages they contain.

 ted "* * * *
Note that a file extension is not necessary - ted defaults to looking for files with the extension .3d:
bookmark:t

Optional instead of start page. Specifies a bookmark at which to open the document. No warning is given if the bookmark does not exist in the opened document.
run autoexec:n
0  Ignore any autoexec script when the document is opened.
Ø or 1  If the document contains an autoexec script, it will be started after the document is fully loaded.
load pfi:n

Arbortext APP stores page formatting information (pfi) related to the beginning of each page if the Save page formatting information check box is enabled in the Preferences for Saving Documents dialogue box (see tdspref). This assists faster navigation of documents, especially after they are first opened. Some versions of Arbortext APP have (unintentionally) saved pfi which is incompatible with other versions, rendering the document un-openable. This setting can be used to overcome this problem:

0  Any pfi in the file is ignored.
Ø or 1  Any pfi in the file is loaded and used to speed navigation of the document.
The function for retreiving file size and page numbers within the Open Document(s) dialogue box is only available from this dialogue and not from any other means in a stanard 3B2 function. However retreiving this information is possible by interigating the 3D file itself using a Perl script. The relevant parts are the number of fdd sections (will be one per page in the document, except in looseleaf/frozen page work) and the value of the numbers keyword in the fdpref section, this being the start page number.

Running files instead of opening
Version specific information8.13e 

You can also 'run' given filenames instead of 'editing' them using the command line '-r'.

A requirement can be to be able to start Arbortext APP with a list of macros to be performed on a one-off basis. One method is to add the macros to startupw.3ad before starting 3B2 but restoring the original content after Arbortext APP closes can be cumbersome. Another method is to simply put the filename containing macros on the command line. 3B2 automatically starts any filenames on the command line with the "edit" macro. This processes the macros nicely but always opens a blank document as a side-effect of edit.

The solution is very simple: the new -r command-line option specifies that 3B2 starts all filenames with "run" instead of edit. for example:

 3b2win -r my_macros1.3m my_macros2.3m

Document created on 08-Feb-2003 (revision 1)