Table of Contents

Preface

What's in this manual

The Razor documentation set

Other documents

Conventions

Typographic/stylistic

Directory diagrams

Getting help

By e-mail

By phone or fax

Feedback

1: Overview of Razor

Product trilogy

A view from the top

Architecture

Razor and the network

Used as a tool suite

Used as independent pieces

Tower's approach

The database

Record everything

UNIX and more UNIX

A day in the life

Scenario 1

Scenario 2

Scenarios 3, 4, 5, 6...

Product basics

Using mouse buttons

Scrolling list behavior

Keyboard accelerators

Ok, Apply, and Cancel buttons

Hidden menus

2: Installation and
General Administration

Overview

System requirements

Before you get started...

A suggested organization

What you'll need to know

Obtaining a copy of the software

Via the World Wide Web

Via ftp

Via CDROM

Installing the software

General guidelines

Sample installation

License keys

Installing product upgrades

Databases, groups, and attributes

Creating databases

Injecting existing SCCS/RCS investments

Making additional file control groups

Making additional issues groups

Making additional custom groups

Starting Razor

License manager

Database server

Razor tools

Automatic start-up at boot time

Remote client password

Password file entries

Remote guest account

Batch entry of passwords

Handling mixed environments

Heterogeneous environments

OpenLook vs. Motif (Sun only)

X terminals, etc.

PC Clients

Remote UNIX Clients

Web Clients

Rearranging things later

Moving where the release resides

Moving a database to new location

See also...

3: Using Issues

The main display

Header/footer

Menu bar

Tool bar

Main list

The sections of an issue form

The attribute section

Text panes

Creating new issues

Viewing/modifying existing issues

Checking on related file activity

Recording your modifications

Controlling your view

Additional information on the main display

Filtering the collection

Sorting the collection

Saving and recalling sort/filter combinations

Searching for matching text strings

Getting more insight and output

Printer setup

Printing issues

Running reports

Running commands

Subscribing to databases & issues groups

See also...

4: Using Versions

The primary display

Header/footer

Menu bar

Action buttons

Main list

Subscribing to groups

Working with files/folders

Creating folders

Introducing new files

Renaming files / moving to new folders

Handling binary files

Injecting existing SCCS/RCS investments

Setting initial attributes via scripts

Checking files out for edit

Filling in comments

Associating issues to editing activity

Checking files back in

Checking in multiple files

Forcing files to be changed on check-in

Parallel development

Performing a branch

Terminating a branch

Merging files

File selection

Difference display

Interactive merging, a walk-through

Resolving conflicts

Saving merged output

Controlling the merge view

Changing attributes of files

Promoting specific versions

Looking at files

Getting read-only copies

Browsing files

Reviewing history

Seeing how versions/files differ

Changing your mind

Uncheck-out files

Reverting files

Using custom commands/utilities

Adding serial commands

Adding batch commands

Running commands

Controlling your view

Displaying modification dates

Filtering the display

Setting personal preferences

See also...

5: Using Threads

Themes and concepts

The main threads display

Header/footer

Menu bar

Main list

Edit Thread display

Header/footer

Menu bar

File/folder list

Creating and editing threads

Importing an existing thread

File by file decisions

Including the latest version of every file in a thread

Blanket selections

Defining threads by related issues

Trunks vs. branches

Saving it back to the database

Extracting threads & generating thread scripts

Thread rules

Changing how files are extracted

Running commands

Comparing threads

Projects: Thread of threads

The project editor

Defining the collection of threads

Controlling your view

Date information

Filtering the display

See also...

6: Command Line
Functionality

The "razor" program

Administrative functions

Discovering which version of Razor you have

Determining Razor usage

Displaying system id

Modifying/reviewing the license information

Starting and stopping the license manager

Starting and stopping a database server

Password functions

Creating/Modifying password information

Displaying password information

Checking files in and out

Getting a read-only copy of a file

Checking a file out for edit &
checking it back in again

Introducing a new file

Un-checking a file

Creating a folder

Renaming a file or folder

Incrementing the major version of a file

Obtaining a full text copy of an issue

Branching a file

Comparing file attributes

Changing promotion level / state by command line

Promoting files and threads

Promoting issue states

Bringing up issue forms by command line

Removing things from the database

Deleting files

Deleting folders

Deleting threads

Deleting issues

Working with threads

Creating a thread

Generating thread scripts

Duplicating a thread

Modifying a project / thread

Comparing two versions of a thread

Formatting text

Time related functions

See also...

7: Special Features

E-mail entry of issues

Installation and set up

Setting initial attribute values on e-mail submission

Filling the second text pane on e-mail submission

Modifying e-mail entry behavior

Licensing considerations

Global tracking of issues

How it works

Installation and set up

Things to be aware of

Remote access via e-mail

How it works

Controlling access

E-mail commands

8: Customization &
Personalization

Containers: databases, groups, and folders

Databases

Groups

Folders

Basics: defining the terminology

The Attributes file

Attribute types defined

Customizing the Attributes file

Controls

Access controls

Definable roles

Options

Configuring the issues program

Conditional attributes (sensitivity)

Issue STATEs (permissions)

Controlling the issues state string

E-mail notification on state changes

Associating glyphs to attributes

Pre-loading information into the text panes

Controlling form layout

Colors

General suggestions

File and thread attributes

File and thread STATEs

Defining who may promote files/threads

Associating glyphs to file attributes

Miscellanea

Printing customization

E-mail composition script

Changing the compression engine

Custom help files

General suggestions

See also...

9: Writing Your Own
Shell Scripts

Using rz_utils

Using rz_html_utils

Using rz_toolbox

Utility routines

Parsing for attributes

Filtering by script

Using the system_setup script

Customizing printouts of issues

Writing report scripts for issues

The batch method

The serial method

Automatic printing of reports

Issues form values as environment variables

Attaching scripts to buttons

Versions & threads

Issues

Informing the user from attached scripts

Simple notification - Razor_notice file

Interactive notification - rz_notice (local, UNIX only)

Pre-loading an issues form

Scripts which receive and process e-mail

Debugging suggestions

Appendix A:
Razor Directory Layouts

$RAZOR_HOME
Where the release is stored

$RAZOR_UNIVERSE_DIR
How a database lays out

$RAZOR_LICENSE_DIR
Where the license is stored

Appendix B:
Razor File Formats

Administration files

$RAZOR_UNIVERSE_DIR

$RAZOR_LICENSE_DIR

Database files

An Activity file (issues only)

A History file

An Info file

A Latest file (issues only)

Configuration files

Universe-level files

Group-level files

Personal files

Appendix C:
X Resources

X resources / Razor databases

The Xdefaults.sample file

General foreground and background colors

Fonts for Razor GUI's

Widths and heights

Initial filter and display options

Special control over text widgets

Window titles and icon labels

Diff window rows/columns

Issues miscellanea

Versions miscellanea

Threads miscellanea

E-mail back to Tower Concepts

Occam the Icon

Appendix D:
Regular Expressions

Appendix E:
PC Client Application

System requirements

Obtaining a copy of the software

Installing the software

Starting Razor

Logging in

Getting help

Logging off

See also...

Appendix F:
Remote UNIX Client Applications

System requirements

Obtaining a copy of the software

Installing the software

Making a remote distribution

Installation guidelines

Starting the remote client

Logging in

Temporarily disconnecting

See also...

Appendix G:
NT Server

System requirements

Before you get started...

General comments

The Razor program group

Obtaining a copy of the software

Unload the release on your system and install it

General guidelines

Prior to installing...

Doing the install

Database creation - an overview

Razor administration via Razor Admin

Starting Razor Admin

The main display

Installing license keys

Creating Razor databases

Starting Razor

Razor passwords

Creating new groups

Administering databases

Razor administration via scripts

Installing license keys

Starting the programs

Database creation

Starting the database server

Razor passwords

Administering databases

See also...

Appendix H:
Potpourri

When bad things happen

When good things happen

Environment variables

The name `Razor'

Occam's Razor

Common questions, common answers

General

Database-related

Server-related

License manager-related

Issues-related

Versions-related

X-related

Glyphs; supplied & exposed!

Drawing your own glyph bitmaps

Glossary

Index

(Part 1 of 1 for this section) (Generated 09/13/99 at 17:36:11)