User Manual table of contents

Command-Line Operation of pop!siteTM

On this Page
Command-Line Operation
Overview of Operation
Command-Line Switches


Quick Reference
Object Types
System Properties
System Methods
Binary Operators

Command-Line Operation

When building static pages, you'll probably be using the pop!site integration with the Windows shell. On Windows NT 3.51, however, the new shell is not available, so you must invoke pop!site using the command-line. Additionally, there are some powerful, site-management features of pop!site that can only be used if you use the command-line interface.

Overview of Operation

pop!site performs its operation in two phases: scanning and processing. During scanning, files that need processing are identified. During the processing phase, operations are actually performed on the files identified during scanning.

Most of the time, pop!site is used to convert pop!talkTM documents into HTML documents, but it can also be used to copy files from one place to another -- useful when you have a large tree of pop!talk documents and other files such .GIF images. pop!site determines what processing it will perform on a file based on the file's extension. By default, all files are interpreted as pop!talk. The -p and -c switches (below) can be used to override these defaults.

pop!site's command line invocation is pt [switches] [inputfile], where [x] denotes an optional element. Switches with arguments must be invoked with a space between the switch name and the argument.

Command-Line Switches

The switches are:

Switch Description
-c extensionlist Comma-separated list of extensions which identifies the types of files that pop!site will copy, unchanged from the input to the output area.
-cl configlist Comma-separated list of "configurations." Each input file will be processed once for each configuration listed. Each time the file is processed, the variable &(config) is defined as the name of the configuration being processed. Used with -ce, -cs or -cm. For more information, see Multiple Configuration.
-cs,-ce,-cm Used with multiple configurations (-cl). Inserts the configuration name as a directory into the output path. -cs inserts the configuration directory at the front of the output path, -ce inserts it at the end and -cm inserts it in the middle. For more information on using these switches, see Multiple Configurations.
-e file Identifies the file to which all errors will be written. If -e is not specified, all error output goes to stderr (usually the screen).
-h file Identifies an additional include file, to be included before the input file. If -h is not specified, no additional file will be included.
-i file Identifies the input file. Wildcards are allowed. If -i is not specified, then [inputfile] is used.
-istdin Causes input to be read from stdin (usually the keyboard) instead of a file.
-l Don't display the copyright message.
-n Only process input files which are newer than their output files.
-ncd Don't create directories for output files. Normally, pop!site will create subdirectories as needed to hold output files.
-o file Identifies the output file. May specify a directory (with the trailing slash). If -o is not specified, all output goes to a file with the same name as the input file, but with .html as the extension.
-ostdout Causes all output to be written to stdout (usually the screen).
-ox extension Specifies the output extension for files processed as pop!talk.
-p extensionlist Comma-separated list of extensions which identifies the types of files that pop!site treats as pop!talk for direct processing. Default is '*' (i.e., all file extensions)
-r Process files in all subdirectories that match the pattern specified in the -i option.
-s Only scan files. Don't process them.
-xc Enable verbose include scanning. This is a debugging option that reports directory change operations as pop!site executes. It is typically only used by support personnel.
-xf Enable verbose file scanning. As files are scanned, pop!site reports which files are to be processed and how they are to be processed.
-xt Show timings for file processing.
-v Verifies and reports information about the pop!site license currently in use.


powered by pop!site Copyright 1995-1997. Pragmatica, Inc. All Rights reserved.
Pragmatica, pop!site and pop!talk are trademarks of Pragmatica, Inc.
Modified: 29 January, 1997 22:28:16

Page Feedback
Webmaster Contact