Document 1

Known problems with Version 2.x

Version: 2.x - Scientific WorkPlace & Scientific Word

From time to time, we come across problems that managed to slip past us and into our released software. We're working hard to fix them. In the meantime, we want you to know what to do if you encounter any of these problems.

SWP/SW Version 2.5

Problem

Tilde over bold math character prints as an overbar.

Explanation

The source of the problem is unknown at this time.

Solution

We hope to correct this small problem in a future release. In the meantime, we can suggest a way to work around the problem.

Problem

If Build 478 of SW is running under Windows 95, some pull-down menus in the Maple Settings dialog box don't display all selections, but no scroll bar is displayed to indicate that other selections are available.

Explanation

The selections are available but the menu is consistently one slot too small.

Solution

Use the arrow keys to scroll through the menu.

Problem

When a document containing references to markers placed within custom theorem labels is saved and reloaded, a \QTSN reference is inserted into the TeX file. The reference isn't recognized when the document is compiled.

Explanation

The source of this problem is unknown at this time.

Solution

Place the marker immediately after the theorem tag, rather than within it.

Problem

In SW versions 2.0 and 2.5, using lettered equation numbering in equation arrays can cause problems with new section markers and with section numbering.

Explanation

When you specify lettered equation numbering in equation arrays, SW doesn't place the \end{mathletters} command directly after the \end{eqnarray} command but rather before the next \begin {equation}. The placement is correct according to our design. However, it does seem to cause problems for some users, so we will look at the issue again.

Problem

When SW 2.5 documents containing PCX graphics are printed on an HP LaserJet 5MP printer in PostScript mode, the PCX graphics are completely garbled.

Explanation

There is apparently a conflict between SW 2.5 and the printer driver specific to the HP LaserJet 5MP (Adobe PostScript driver version 2.1.2).

Solution

Download the version 3.0.1 driver from our FTP site. Your PCX graphics will print correctly, but you won't be able to set the printer defaults directly from the PostScript driver, as you would with the Printer Control Language (PCL) driver.

Problem

The List of Figures and List of Tables aren't created correctly for documents created with Style Editor styles.

Solution

Modify the *.sty file for the document style:

  1. Using an ASCII editor, open the .sty file for the style you're using.

    The file is located in the sw25\tex\macros\styledit directory.

  2. Modify the entry for the List of Figures:

    1. Find the string that reads figure@toc.

    2. Move down several lines to the line that reads \MakeTOCEntry{false}.

    3. Change the entry to \MakeTOCEntry{true}.

  3. Modify the entry for the List of Tables:

    1. Find the string that reads table@toc.

    2. Move down several lines to the line that reads \MakeTOCEntry{false}.

    3. Change the entry to \MakeTOCEntry{true}.

  4. Save and close the file.

SW will create the List of Figures and List of Tables correctly.

Problem

The Angstrom letter (Å) previews and prints correctly in Text but not in Math.

Explanation

We're not sure of the source of the problem at this time.

Solution

We suggest that you create the Angstrom letter in Text and then apply the italics tag to the letter. Unlike the rest of your mathematics, the letter won't appear in red on your screen, but it will produce the preview and print image you want.

Problem

Documents won't print on a PostScript Printer.

Explanation

The printer most likely has insufficient memory or the Windows printer driver settings for printer memory are not correct.

Solution

Check the memory in the printer and the memory settings in the Windows printer driver. If changing the Windows driver settings does not help, you may be able to fix the problem with one of the newer PostScript printer drivers from the manufacturer. We have placed a new PostScript driver from Hewlett Packard on our ftp site. In our experience, this new driver manages memory much more efficiently than previous versions and solves most out-of-memory problems.

Problem

Some characters (including Math: not equal symbol and Math: maps to symbol) print incorrectly on PostScript printers. Other characters (including Math: less than or equal to symbol and ") print incorrectly on HP LaserJet printers.

Explanation

Some Windows printer drivers have bugs that change the characters printed. Richard Kinch of Kinch Computer Systems, the supplier of the TrueTeX system used in SW, has included special workarounds in the previewer/printer to cure many of these problems.

Solution

If you experience these problems, use a replacement driver. The PostScript drivers developed by Adobe Systems can cure the PostScript problems, although some of our testers have reported that, on some printers, these drivers produce horizontal lines that are too thick. These drivers are available directly from Adobe Systems or from our ftp site.

Problem

Blue characters appear on the preview screen.

Explanation

The internal Windows font selection scheme automatically switches to the Small fonts when character sizes fall below a certain threshold. When this happens, the TrueTeX previewer displays the characters in blue to alert you that the font that Windows chose is not the font requested.

Solution

Choose Fonts from the Windows Control Panel and remove the Small fonts.

Problem

The spacing in the blackboard bold, calligraphic and slant fonts is incorrect on screen.

Solution

While these fonts don't appear as nicely as we'd like in the SW window, they do print correctly. We're sorry for this inconvenience.

Problem

Markers, footnotes, and \newline commands create problems in section headings.

Explanation

Certain public domain styles cannot handle markers and footnotes in section headings. The difficulties are caused by the TeX macros that deal with the generation of a table of contents, headers and footers.

Solution

If you need to set markers for section headings, we recommend that you put section markers in the text immediately following the headings. If you need to insert a \newline command or a footnote, we recommend that you create a short version of the heading so the table of contents, headers and footers are created correctly.

Problem

SW ignores the Number of Points setting in Plots.

Explanation

Maple uses a default of 49 points in any given plot. However, due to Maple's adaptive plotting scheme, Maple may plot a larger number of points depending upon the plot expression.

Solution

Currently, the Maple setting determines the number of plot points.

Problem

ODE Numeric causes an error message in some situations. If you set the number of digits used in computation to 40, then try to solve a differential equation using ODE Numeric, Maple will return a function. However, if you try to use that function, Maple will work for a considerable time and then display an error message.

Solution

Before you try again to obtain a numeric solution for a differential equation, clear the definitions.

Problem

SW either has installation problems or locks up on starting if you have PCTCP drivers installed.

Explanation

A number of users have reported conflicts between SW and PCTCP, another vendor's TCP/IP product for DOS.

Solution

At this time, the problem is unresolved. We suggest you disable PCTCP when you want to run SW.

Problem

With Build 454 of SW version 2.5, if you choose the Maple Settings options to display the plot dialog box before plotting, SW crashes when you attempt to plot.

Solution

Instead of highlighting the expression, place the insertion point somewhere inside the expression, then plot. This problem has been corrected in Build 478.

Problem

Defining x prevents the plotting of constants. Specifically, error messages result if you follow these steps to plot:

  1. Define Math: x=99.

  2. Move the insertion point to the next line.

  3. Toggle to Math.

  4. Type 5.

  5. From the Maple menu, choose Plot 2D and then choose Rectangular.

Explanation

SW is inadvertently using x in this process. Because x has been defined, SW tries to use the constant as a variable.

Solution

Undefine x, then plot again.

Problem

REVTeX styles don't support bold Greek characters.

Explanation

Version 2.5 of SW uses {\bf \character}, a construct that isn't supported by REVTeX.

Solution

To enter a bold Greek character in a document created with a REVTeX style,

  1. Place the insertion point where you want the character to appear.

  2. Insert a TeX field.

  3. In the TeX field, enter \bbox{\character} where character is the Greek character you want.

  4. Choose OK.

Problem

The Style Editor doesn't necessarily reflect the font scheme that's currently selected.

Explanation

The portion of the code that deals with the list of available font schemes doesn't differentiate between different sizes of the same font.

Solution

When you select a font scheme for a Style Editor style using the Advanced/Font Scheme dialog box, actively select the font scheme you want, even if it already appears to be selected in the font list.

Problem

Fixed-width table cells can't be deleted.

Explanation

The cause of this problem is unknown.

Solution

Select the fixed-width cells you want to delete, change them from fixed width to automatic width, then delete them.

Problem

The Edit menu commands Insert Rows and Insert Columns are not available if the insertion point is in a table cell that contains text.

Explanation

The cause of the problem is unknown.

Solution

Place the insertion point to the right of the table before activating the Edit menu.

Problem

In the Miscellaneous section of the Edit tab in the User Setup dialog box, changes to the settings for Horizontal Mouse Scrolling and Automatic Substitution are reversed after the document has been saved and reloaded.

Explanation

When SW saves these settings in the .ini file, it stores the opposite values from those you chose. This problem was resolved in Build 478 of SW version 2.5.

Solution

We suggest you reverse the settings for these two fields, choose OK, save the document, then exit and restart SW.

Problem

Accented characters in section headings don't appear in the section list in the Navigate bar.

Explanation

This is a limitation of the current implementation of SW.

Solution

No action is recommended.

Problem

SW creates vertical space in your document even if you choose Cancel to leave the Vertical Space dialog box.

Explanation

This problem is unresolved.

Solution

Until we can resolve the problem, we suggest you delete the unwanted vertical space. We're sorry for the inconvenience.

Problem

The Poisson distribution does not accept a fractional parameter.

Explanation

This problem is unresolved.

Solution

At this time, we have no solution to this problem. The same limitation existed with SW version 2.01.

Problem

Subscripted definitions do not work correctly if they are highlighted before they are defined.

Explanation

This procedure causes the problem:

  1. Enter the expression you want to define, such as Math: a (subscript n)=n+1.

  2. Highlight the expression.

  3. From the Maple menu, choose Define and then choose New Definition.

  4. Move the insertion point to a new line.

  5. Enter the subscripted variable and type a value for the subscript, such as Math: a (subscript 3)

  6. Evaluate the expression. The answer that is returned (Math: a3 in this example) is incorrect.

Solution

Do not highlight the expression before you define it. Instead, place the insertion point in the expression. Then, from the Maple menu, choose Define and then choose New Definition.

Problem

Maple's Extrema function doesn't work if floating point numbers are contained in the equation.

Explanation

Solution

Use integer equivalents to the floating point numbers, such as 7/100 instead of .07.

Problem

During installation, Drive Not Shared or Can't Find Drive messages occur.

Explanation

The installation program installs vshare.386 but doesn't look first to see if a share statement is already in the autoexec.bat file. Thus, two shares may be running at the same time.

Solution

Remove share.exe from your autoexec.bat and config.sys files, then reboot your computer.

Problem

Bad or blank disks, especially disks 2, 6, 9 and 11, have been shipped with some systems.

Explanation

Some problems occurred when the disks were duplicated.

Solution

Please contact us immediately for replacement disks.

Problem

Including a character in blackboard bold in the caption of a figure causes TeX to give a DVI Not Created message when the document is previewed or printed.

Explanation

SW doesn't recognize that the AMSYMB package is needed if the only occurrences of blackboard bold or any other AMS characters are in figure captions.

Solution

If you use a blackboard bold character or any other AMS character anywhere else in your document as well as in a figure caption, your document will compile. If you use a blackboard bold character or any other AMS character only in a figure caption, your document won't compile. If you must have the character in the caption and you don't want an AMS character anywhere else in the document, insert into the caption a TeX field containing the command \Bbb{character} where character is the character you want in blackboard bold. Then, highlight the gray TeX button in your document and toggle it to math.

Problem

Revising a double, triple or quadruple integral can cause TeX to give an Undefined Control Sequence error when the document is previewed or printed.

Explanation

The root of this problem is unknown, but you can cause it this way:

  1. Insert a double, triple or quadruple integral in your document.

  2. Revise the integral.

  3. In the Limit Position area, choose Above, Below.

  4. In the Size area, leave the selection as Auto.

  5. Choose OK.

  6. Enter a subscript for the integral.

  7. Preview your document.

  8. TeX will give an Unidentified Control Sequence error.

Solution

When you revise the integral, choose Big or Small, not Auto, from the Size area of the dialog box.

Problem

Function key assignments for certain item tags don't hold if the document is closed and then reopened. Further, the yellow tag that used to appear next to the item is gone and the item tag is missing from the item tag list.

Explanation

In SW 2.5, when you assign a function key to an environment such as Exercise, Remark or Example (shown in the list of item tags associated with your document style), the assignment doesn't hold unless the environment is defined in its own section of the .cst file.

Solution

Modify the .cst file associated with your document.

Problem

Greek subscripts appear properly on the screen but preview and print as full-size characters on the main line of text, rather than in the subscript position.

Explanation

When we corrected a problem involving bold Greek letters, we inadvertently created a problem with Greek superscripts. We've now corrected the superscript problem and included the correction in the latest version of tcilatex.tex, which is available from our ftp site.

Solution

Download the file from our ftp site and copy it to \swp25\tex\macros\tci\tcilatex.tex.

Problem

The bibliography feature doesn't work for REVTeX styles.

Explanation

Some settings were removed by mistake from the Document Information dialog box for REVTeX styles. We've developed a way for you to work around this problem.

Solution

Follow these steps to enable BibTeX features for your REVTeX document.

  1. Start SW.

  2. If the default document uses a REVTeX style, create a new document that doesn't use a REVTeX style.

  3. From the File menu, choose Document Info.

  4. Choose the Bib Choice tab.

  5. Choose Bib TeX.

  6. Choose OK.

  7. Open your REVTeX document.

The BibTeX features should be available for your document.

SW Version 2.01

Some settings were removed by mistake from the Document Information dialog box for REVTeX styles. We've developed a way for you to work around this problem.

Problem

Multiline formulas in a proposition or a lemma are adjusted to the right. Adding an alignment sign solves the problem but only temporarily.

Explanation

This problem is currently unresolved. We are working to reproduce the problem consistently, but so far without success.

Solution

As soon as we find a solution, we'll publish it here.

Problem

The Poisson distribution does not accept a fractional parameter.

Explanation

This problem is unresolved.

Solution

At this time, we have no solution to this problem.

Revised 08/07/96, 06/19/02, 10/29/02

This document was created with Scientific WorkPlace 4.0.