ADEPTPUB(1)

NAME

adeptpub: an SGML-based electronic publishing system for workstations.

SYNOPSIS

adeptpub [-copy | -sample]
   [-e docname | -n doctype]
   [-fosi name] [-subtype typename]
   [-cc | -nocc] [-r] [-u]
   [-c ’commandlist’] [-C ’commandlist’] [-nocmd]
   [-b] [-h] [-N priority] [-p port] [-S] [-q]
   [-t | [-v ’previewargs’] [winargs]]
   [docname]

DESCRIPTION

ADEPT Publisher is an electronic publishing system developed by ArborText, Inc. ADEPT Publisher components include an Edit window, a Command line window, a WYSIWYG equation editor, an interactive table editor, and a Preview window. It has both previewing and printing capabilities. ADEPT Publisher is based on Standardized General Markup Language (SGML), an international standard (ISO 8879) for marking up documents. ADEPT Publisher combines the benefits of a structured system with an easy-to-use tagged environment and a powerful command language. Note: Where a vertical bar appears between options, only one or the other option can be used.

OPTIONS

-copybrings up the Copy Document Panel, which prompts for a new document name and provides a list of existing documents in the current directory.

-sample
brings up the Sample Document Panel, which lists available sample documents to select.

-e docname
followed first by a new document name and second by an existing document name, opens a new document by copying the named existing document to the new document name. For example:
adeptpub -e newdoc existingdoc

-n doctype
followed by a document type is a request to start a new document of the given type. This option lets you bypass the New Document Panel if you supply all the information required. If the document type name contains blanks, the name must be enclosed in single quotes. The document type must be typed exactly as it appears on the New Document Panel; case is significant. You must supply a document name unless you specify a sample document (-sample), named PubSample by default. If -sample is not specified, a new document is assumed.

For example:
adeptpub -n ’Report’ -sample
adeptpub -n ’ATI MIL-M-38784C’ mydoc

-fosi name
specifies that a different FOSI be used for the Editor view of the document instead of the default associated with the document type. name is the pathname of a .fos file, or if a simple name, that is, not containing slashes, is the basename of the FOSI file. In the latter case, the file name.fos is loaded from the doctype directory.

-subtype typename
specifies the subtype name for a document type, if one exists. The typename is the subtype name, which is the middle field (of three) separated by vertical bars in the entity.map file. The purpose of document subtypes is to let more than one document type directory share the same PUBLIC ID while maintaining a way to make each directory unique. If the document you list in the adeptpub or adeptedit command has a subtype but you do not specify it, the system will find and use the first document subtype found matching the PUBLIC ID specified.

-ccforces the Editor to do a completeness check of your document if your document was created with ADEPT Editor or ADEPT Publisher. (By default, a completeness check will not be done upon start-up if the document was saved by the Editor.) This option is recommended when opening documents that were created in The ADEPT Series but were later edited elsewhere and may no longer be normalized or complete.

-nocccauses ADEPT Publisher not to do a completeness check when starting up docname. In this case, the file must be fully normalized.

-rmakes ADEPT Publisher open a document as read-only.

-uforces the Editor to treat the file as an untagged ASCII file. SGML codes, if any, will not be interpreted as Editor tags.

-c ’commandlist’
executes the specified ADEPT Publisher commands on your document without starting up the Editor. Only commands in terminal mode are legal to use here. Multiple commands must be separated by semicolons.

-C ’commandlist’
executes the specified ADEPT Publisher commands on your document after the system Pubrc command file is read but before any user .pubrc or document pubrc files are read in.

-nocmd
suppresses the command line on the main Edit window. This might be used by a custom application that wishes to prevent users from entering Editor commands directly.

-bguarantees that any conditions that may require an interactive response from the user will instead terminate execution with an exit code, indicating the condition encountered. This is especially useful when running ADEPT from a script where interactive prompting is not desired and the exit code is used to dictate further processing.

-hdisplays a usage message with all options listed.

-N priority
followed by a number is the UNIX nice level, which is used to determine the priority of formatting. The default is 1. The higher the value, the lower the priority of allocating CPU for formatting. Raising the value gives better response to other programs at the expense of formatting.

-p port
is used with the ADEPT Series Applications Program Interface (the API) to specify the TCP/IP port number on which ADEPT Publisher is to listen for requests from an API client. If the -S flag is also specified, ADEPT Publisher will operate in API server mode with no window or terminal input allowed.

-Sis used when you want input only accepted from the API client and output is sent to the standard output and standard error.

-qcauses ADEPT Publisher to start up without reading the user’s .pubrc file.

-truns ADEPT Publisher in terminal mode. From the adeptpub> prompt, you can enter commands that are legal at the Command line window. This is useful for running ADEPT Publisher documents from an ASCII terminal. Most commands are legal in -t mode.

Commands not legal in -t mode:
choosedirectory
insert_graphicinsert_equation
insert_tableinvoke_processor
menu link
outlineoptions
previewwindow

The caret command does not support absolute row or column numbers in its location argument in terminal mode. The command variables $currentline, $currentcolumn, and $topline do not have meaningful values in terminal mode.

-v ’previewargs’
passes any valid window arguments to the Preview window. Arguments must be inside a pair of single quotes; multiple arguments must be separated by semicolons. The options most likely to be passed are the window system options that would determine the size and position of the Preview window.

winargs
represents the standard window arguments that allow you to control the placement and appearance of the Edit and Preview windows. Arguments need not be delimited or separated by semicolons. If you are using the -c, -s, or -t options, winargs cannot be used. To see a list of window arguments, enter the command:
adeptpub -h

docname
is the name of your document.

EXAMPLES

To start a new ADEPT Publisher document called "salesreport" as a copy of an existing document called "feb-sales," enter the command:

adeptpub salesreport -e feb-sales