Copyright: Copyright ©


Changing the File or Directory Destinations

When you copy or unwrap a document with the SW Document Manager, you can choose the destination of the document and its associated files.

To change a file or directory destination

1.	From the files or directory panel, select the files or directory for which you want to change the destination.

2.	Choose Change Destination.

The default file destination appears in the Folders box.

3.	To choose an existing directory, double-click its name.

4.	To create a new directory, choose Create, name the new directory, and choose OK.

5.	Choose OK.

Related topics

Copying a Document

Unwrapping a Document


Cleaning up Document Files

From time to time you should delete the files that are generated when you compile, preview or print a document.  The Cleanup operation in the SW Document Manager deletes auxiliary files, such as those with the extensions .aux, .blg, .dvi, .idx, .ilg, .lis, lof, .lot, and .toc, and all but the latest file with the extension .aaa-.aaz.

To delete auxiliary files

1.	Start the SW Document Manager.

2.	In the File Selection box, select the document for which you want to clean up the auxiliary files.

3.	Choose Cleanup

4.	From the Cleanup dialog box, exclude any files that you don't want to delete.

5.	Choose OK.

A message area indicates when the cleanup operation is complete

6.	Choose Close.

Related topics

Cleaning Up Document Files

Renaming a Document

Unwrapping a Document

Viewing a Document

Wrapping a Document


Command Line Arguments

Use these commands to wrap and unwrap documents from DOS.

To wrap a document use:

docman /w documentfile [/o wrapfile] [+g | -g] [+s | -s] [/q] [/md macrodirectory] [/sd styledirectory]

/w	Filename and path of document to be wrapped.

/o	Filename and path of output wrapfile.  If not specified the document filename with extension .msg is used.

+g	Include graphics (default).

-g	Exclude graphics.

+s	Include macros and styles.

-s	Exclude macros and styles (default).

/q	Quiet mode with no dialog interaction.

/md	Source path of TeX macros directory.

/sd	Source path of SW styles directory.

To unwrap a document use:

docman /u wrapfile [/f] [+g | -g] [+s | -s] [/q] [/dd documentdirectory] [/md macrodirectory] [/sd styledirectory]

/w	Filename and path of source wrapfile.

/f	Flatten the directory structure.  All files will be unwrapped to the document directory.

+g	Include graphics (default).

-g	Exclude graphics.

+s	Include macros and styles.

-s	Exclude macros and styles (default).

/q	Quiet mode with no dialog interaction.

/dd	Destination path of the master document.

/md	Destination path of TeX macros directory.

/sd	Destination path of SW styles directory.


Contents
The SW Document Manager

Contents

What is the SW Document Manager?

Starting the SW Document Manager

Copying a Document

Renaming a Document

Deleting a Document

Cleaning Up Document Files

Wrapping a Document

Unwrapping a Document

Viewing a Document

To see a list of keywords, and to go to a topic using a keyword, click the Search button at the top of this window.


Copying a Document

Use the SW Document Manager to copy a document and all its associated files to a new location.

To copy a document

1.	Start the SW Document Manager.

2.	Select the document you want to copy.

The document file must have a .tex extension.

3.	Choose Copy.

4.	In the Copy To box, select the destination for the document

If you're working on a network, you may need to specify a network file destination.

5.	If you want to create a new directory to contain the copied document, choose Create and specify the directory name.

The program will create the new directory as a subdirectory in the currently selected directory.

6.	Choose OK.

7.	In the Copy dialog box, exclude any associated document and graphics files you don't want to copy.

8.	If you want to change the destination of any associated documents, graphics, and style files, choose Change Destination, change the destination,.and then choose OK.

9.	Choose OK to begin the operation

If the destination directory contains a file of the same name as one of the files being copied, the program asks if you want to overwrite it. 	A message window indicates when the copy operation is complete.

10.	Choose Close.

Related topics

Cleaning Up Document Files

Renaming a Document

Unwrapping a Document

Viewing a Document

Wrapping a Document


Deleting a Document

When you no longer need a document, delete it and its associated files with the Delete operation in the SW Document Manager.

To delete a document

1.	Start the SW Document Manager.

2.	Select the document you want to delete in the File Selection box.

3.	Choose Delete.

4.	From the tab sheets in the Delete dialog box, exclude any files you don't want to delete.

5.	Choose OK.

6.	Choose Close.

Related topics

Cleaning up a Document

Copying a Document

Renaming a Document

Unwrapping a Document

Wrapping a Document


Including and Excluding Files

The dialog boxes for the SW Document Manager Operations have tab sheets for including and excluding document, graphics, and style files.

The Document, Graphics, and Style tab sheets have two panels, one listing directories and one listing files. When you select a directory from the left-hand panel, the right-hand panel shows all files in that directory that are associated with the file on which the Document Manager operation will be performed.  By default, all possible files associated with the selected document are included in each SW Document Manager operation, but you can exclude files from the operation.

The checkboxes in the directory and file panels reflect whether files are included or excluded from the operation.  The checkboxes in the file panel reflect the selection status of the files themselves. The checkboxes in the directory panel reflect the selection status of all associated  files in the directory.

Description	Directory panel	File panel

Checked	All files in directory are	File is included

included	in operation

Partially checked	Some files in subdirectories	Not used

are included

Unchecked	All files in directory are	File is excluded

excluded	excluded

Graphics that have been pasted to the clipboard but left unnamed and plots snapshots are stored in temporary files.  Their names are not listed in the files section of the G graphics tab sheets, but you can exclude them from the operation by unchecking the boxes next to Clipboard Pasted Pictures and Plot Snapshots on the Graphics tab sheet.

To exclude a file from a Document Manager operation

Uncheck the checkbox next to the file name.

or

Select the file and choose Exclude.

To exclude all files in a directory

Uncheck the checkbox next to the directory name.

or

Select the directory and choose Exclude.

To exclude all files listed on a tab sheet

Check Exclude All.

Related topics

Copying a Document

Cleaning Up Document Files

Renaming a Document

Unwrapping a Document

Wrapping a Document

Viewing a Document


Mailing files

Use the Wrap and Unwrap operations in the SW Document Manager to streamline the process of sending LaTeX documents by e-mail or disk.


Renaming a Document

Use the Rename operation of the SW Document Manger to change the name of a file.

To rename a file

1.	Start the SW Document Manager.

2.	Select the document containing the file you want to rename.

3.	Choose Rename.

4.	Select the associated document or graphics file you want to rename.

5.	Choose Rename.

6.	Specify a new name for the file.

7.	Choose OK.

8.	Choose OK to start the operation.

9.	Choose Close to leave the SW Document Manager.

Related topics

Cleaning Up Document Files

Copying a Document

Unwrapping a Document

Viewing a Document

Wrapping a Document


Sending Documents by E-mail

You can use the Wrap/Unwrap operation in the SW Document Manager to simplify sending SW LaTeX documents via e-mail.

Use the Wrap operation to gather together a single text file all the files that must accompany the primary document file.  Use the Unwrap operation to break the text file into separate files again.

Related topics

Mailing Documents


Sending a File on Disk

To send a wrapped document on disk

1.	Wrap the document.

2.	Exit SW.

3.	Open the Windows File Manager.

4.	Open the directory containing the wrapped document.

5.	Check that the size of the wrapped document does not exceed the capacity of your disk.

6.	Use the commands in the Windows File Manager to copy the wrapped document to your disk.

Important	Wrapping a document that contains graphics can create an .msg file that exceeds the capacity of a diskette. You may need to use a compression utility that permits breaking a file across more than one disk.


Specifying a Document File

To specify a document

In the File Selection box, enter the complete path name of the document file.

or

Press Browse to display the Open dialog box, then use the boxes in the dialog box to select the drive, directory, and name of the document file.

Related topic

Specifying a Document Manager Operation


Specifying an Operation

To specify a Document Manager operation

Click the button for the operation you want.

or

Select the button for the operation you want, then press enter.

Related topics

Copying a Document

Renaming a Document

Deleting a Document

Cleaning Up Document Files

Wrapping a Document

Unwrapping a Document

Viewing a Document


Starting the SW Document Manager

To start the SW Document Manager

From the File menu, choose Document Manager (ALT+F, M).

or

Click the Document Manager icon in the SW program group.

The program opens the SW Document Manager window so you can specify the document and the operation you want.


Unwrapping a Document

The Wrap and Unwrap operation of the SW Document Manager streamlines the process of sending LaTeX documents by e-mail or disk.  The Wrap operation gathers together in a single text file all the files that must accompany the primary document file.  The Unwrap operation breaks the text file into separate files again.

Documents that have been wrapped can be unwrapped on an SW system or, if SW is not available, using an ASCII editor on a system that runs LaTeX, according to the information provided in the file header.

To unwrap a wrapped file with the SW Document Manager

1.	Start the SW Document Manager.

2.	Select the file you want to unwrap in the File Selection box.

3.	Choose Unwrap.

4.	Make any changes you want to the destination directories for documents, graphics, and style files.

5.	Exclude any files you don't want to unwrap with the document.

6.	Choose OK.

SW unwraps the document, placing the .tex file and its associated files in the specified destination directories.

7.	When the operation is complete, choose Close.

To unwrap a document with a text editor

1.	Open the .msg file with the text editor.

2.	Follow the instructions in the file header.

Related topics

Mailing Files

Cleaning Up Document Files

Renaming a Document

Viewing a Document

Wrapping a Document


Viewing a File

In the SW Document Manager, you can view the ASCII form of the first part of a document.

To view the ASCII form of the first part of a selected file

1.	Start the SW Document Manager.

2.	Select the file in the File Selection box.

3.	Choose View.

The program displays the ASCII form of the first part of the file in a dialog box.

Related topic

Copying a Document

Cleaning Up Document Files

Renaming a Document

Unwrapping a Document

Wrapping a Document


What is the SW Document Manager

An SW document is associated with many files in addition to the one that contains the document itself.  Some of these files may contain subdocument, graphics, or style information.  Others, such as index files and tables of contents, are generated by SW when you compile, preview or print your document.  The program retains some of the generated files for use when you next preview or print the document, and retains other files for use in maintaining information about program operation or for diagnosing problems.  Depending on the type of file, SW may not store associated files in the same directory that holds the document file.  When you need to copy, rename, delete, or send a document, you must make sure that all files associated with the document are treated correctly.

The SW Document Manager simplifies working with SW documents and their associated files.  With the SW Document Manager, you can correctly copy and rename documents and delete those files you no longer need, especially generated files.  You can properly delete documents that contain subdocuments and references to graphics files.  Further, you can wrap a document and its associated files so it can be sent by electronic mail or on disk, and you can unwrap a document that has been wrapped.

To ensure that all files associated with your SW documents are treated correctly, use the SW Document Manager to perform all SW document management operations:

Copying a Document

Renaming a Document

Deleting a Document

Cleaning Up Document Files

Wrapping a Document

Unwrapping a Document

Viewing a Document

Before you can start an operation, you must start the SW Document Manager.


Wrapping Documents

The Wrap and Unwrap operation of the SW Document Manager streamlines the process of sending LaTeX documents by e-mail or disk.  The Wrap operation gathers together in a single text file all the files that must accompany the primary document file.  The Unwrap operation breaks the text file into separate files again. The wrapped file can also be unwrapped manually according to the information provided in the file header.

To wrap a file

1.	Start the SW Document Manager.

2.	Select the file you want to wrap in the File Selection box.

3.	Choose Wrap.

4.	Exclude any files you don't want to wrap with your document.

Remember that snapshots of Maple plots can be very large. If you are sending the document to someone who has Scientific WorkPlace, you do not need to include snapshots of Maple plots in the operation. You may also want to exclude standard SW styles.

5.	Choose OK.

The SW Document Manager creates a file with the same name as your document but the extension .msg. The file contains your document, the additional files you included, and instructions for using an ASCII editor to recreate the original files.  A message area indicates when the operation is complete.

6.	Choose Close.

Related topics

Copying a Document

Cleaning Up Document Files

Mailing Files

Renaming a Document

Sending a File on Disk

Unwrapping a Document

Viewing a Document


generated files

Files generated during the compile, preview and print processes.


unwrap

To break a wrapped file file into separate files again.


wrap

To gather together in a single text file all the files that must accompany the primary document file when you send the document by e-mail or on disk.