WOLFRAM

Legacy Documentation

Publicon® (2004)

This is documentation for an obsolete product.
Current products and services

Documentation / Publicon / User Guide / Getting Started / Troubleshooting /

Troubleshooting on Linux

Check the Technical Support web pages for further assistance at support.wolfram.com/publicon.

If you do not find the information you need, please contact Technical Support. Include your license number in all correspondence.

You must be a registered customer to receive technical support.

Installation difficulties

If the installation fails or for late-breaking news, check the FAQ for your platform at support.wolfram.com/publicon/systems.

If you need to contact Technical Support about installation, be sure to have your license number and a copy of the installation manifest.

Help files

If Publicon is unable to locate information in the Help Browser, make sure that the documentation has been installed. By default, a minimal installation will not load help files.

Preferences

Preferences, such as the names of recent palettes and style sheets or the locations of recently opened and saved files, are stored in the FrontEnd\init.m file within the Publicon preferences directory: ~/.Publicon.

The most convenient way to reset the front end preferences to their default values is to use the command

publicon -cleanStart

This will cause the initialization file to be rebuilt automatically.

The preferences directory may also contain a number of other files and directories that store configuration data and customized files, such as palettes and style sheets, and they must be discarded to restore Publicon to its original configuration. The cleanest way to restore all preferences is to discard the entire preferences directory.

Caches

Information about your Publicon system layout, such as the locations of text resource files and Help Browser files, are stored in caches within the preferences directory.

A corrupt preference file cache may cause the front end to produce an error or quit immediately on start up. The most convenient way to reset the caches to their default values is to use cleanStart at start up. This will cause the caches and the initialization file to be rebuilt automatically. If starting Publicon by clicking on the executable icon, holding down ShiftKey immediately after clicking the icon during start up will cause the caches (including the help browser index) to be rebuilt automatically.

Graphics

Bitmap caches are created for graphics to allow for quick retrieval of images. If you change the display settings for your monitor, graphics in your notebook may appear strange. To rerender all graphics after changing any setting to your monitor, select the graphics and choose Format RightTriangle Graphics RightTriangle Rerender.

If the front end is using a private colormap, the screen will flicker as you move your mouse from the front end to other applications. This is normal.

Keyboard settings

If you are having trouble with the MOD1 or MOD2 key, you will need to find out which keys represent MOD1 and MOD2 and reset the key assignment.

To change MOD1 and MOD2 keys, you need to use the xmodmap command.

Fonts

If you see the error message xset:bad font path element, check to see if the fonts included with Publicon are on the font path for the server and are accessible. See man xset for more details on how to set up your font path.

Display errors

If you see the error message XPublicon: can't open display, you need to make sure that you have the DISPLAY environment variable set correctly.

Window managers

Some window managers use keyboard shortcuts for special commands that conflict with Publicon's menu shortcuts. An example of this is fvwm and ControlKeyLeftModifiedRightArrowRightModified. If this occurs, you must access the menu command with the pointer.

Other window managers bind keysyms when holding down the MOD1 or MOD2 and another key. In order for some front end keybindings to work correctly, the front end option -pureKeys may need to be set. See Front end resources for more information.

In some window managers, NUMLOCK turns the cursor into a hand when it passes over the window. When you click in the window, all you can do is drag the window.

Publicon is a very complex program that makes sophisticated use of standards-conforming window managers. For this reason, use of prerelease versions of window managers may cause problems.

Front end resources

The standard X resources that control colors, fonts, sizes, and so on are supported by the X front end. For a list of such resources, see the X Window System User's Guide from O'Reilly & Associates.

The X front end also has the following specialized resources:

Bullet *applicationDepth. Sets the color depth for the front end.

Bullet *background. Sets the menu and dialog box background colors (a standard X toolkit option).

Bullet *backgroundTaskDelay. Typically set to 200 milliseconds; this is the time the front end will wait for background events, such as typing, until doing tasks like PostScript rendering. When running the front end over a network, this number may need to be increased to a figure such as 300 or 400.

Bullet *cleanStart. If specified, this tells the front end to ignore caches stored in the user's home directory.

Bullet *Menu*fontlist. Sets the fonts to be used in the menus.

Bullet *mod1KeySym. Specifies which key will represent MOD1.

Bullet *mod2KeySym. Specifies which key will represent MOD2.

Bullet *preferencesDirectory. Specifies the location where preferences are stored.

Bullet *printCommand. Gives the command that will send the file to the printer, such as lpr or lp. This command will appear in the Print dialog box.

Bullet *pureKeys. When set to True, the front end prevents manufacturer keycodes from being modified by anything except the ShiftKey key. For example, some systems may have ControlKeyLeftModified6RightModified mapped to the onequarter keysym, and this will not work with the X front end.

Bullet *singleLaunch. This resource takes values True, False, and Query. It allows only one copy of the front end to exist per DISPLAY setting if set to True, and allows multiple front ends to run if set to False. Setting this resource to Query will cause the front end to ask if you wish to have each file opened by a separate front end.

Bullet *standardColormap. This defines what colormap should be used.

Bullet *tileWidth. If lines appear in dithered graphics, try setting this to 8 or 16.

Bullet *usePrivateColormap. If set to True, this will cause a private colormap to be established.

Bullet *useStandardColormaps. This gives control over colormaps. If this is set to True, the front end will use a standard colormap if available. If the *standardColormap resource is set, it will try to use that one first. Otherwise, for color visuals it searches for (in order): RGB_DEFAULT_MAP, RGB_BEST_MAP, and RGB_GRAY_MAP. For grayscale visuals it searches for (in order): RGB_GRAY_MAP and RGB_DEFAULT_MAP.

Bullet *visualClass. This should be set to one of the following: PseudoColor, TrueColor, DirectColor, StaticColor, StaticGray, or GrayScale.
Bullet *visualID. This allows the selection of a specific visualID on a DISPLAY connection.

Front end command-line options

Bullet -appHelper. Combines the options -querySingleLaunch and -forceSaveAs. This option is typically used when configuring Publicon as a helper application for web browsers.

Bullet -backgroundTaskDelay. Specifies the time the front end delays background tasks like PostScript rendering when waiting for input. The delay is measured in milliseconds; the default setting is 100.

Bullet -best. Asks the front end to use an optimal visual, depth, and colormap combination.

Bullet -cleanStart. Tells the front end to ignore caches stored in the user's preferences directory. This option can also be abbreviated as -clean.

Bullet -copyright. Tells the front end to display copyright information from the command line.

Bullet -font. Specifies the font that the front end uses in menus, buttons, and so on. The X program xfontsel can be used to obtain a fontname. The fontname may be expressed as either an X Logical Font Description or as a valid font alias.

Bullet -forceSaveAs. Forces the front end to open the Save dialog box when closing a file passed to it on the command line. This option is typically used when configuring Publicon as a helper application for web browsers.

Bullet -help. Prints a listing of all available command-line options.

Bullet -lmverbose. Prints diagnostic information to stderr on connecting to the license manager. This is useful for diagnosing problems related to the license server.

Bullet -nosingleLaunch. Allows multiple front ends to be running on the same display. This is the default.

Bullet -noSplashScreen. Prevents the splash screen from being displayed on start up.

Bullet -nostderrWindow. Tells the front end not to display stderr messages in a pop-up window.

Bullet -nowatchCLIPBOARD. If specified, the X front end will not watch the CLIPBOARD property for change in ownership. The CLIPBOARD property allows items to be shared between X applications via Copy and Paste commands. If this option is specified, you can only paste items within Publicon; items pasted into the CLIPBOARD from other applications are ignored.

Bullet -preferencesDirectory. Allows you to specify the location where preferences are stored. By default, this is set to ~/.Publicon.

Bullet -primaryModifierMask. Specifies the modifier mask to use as the command key. The default is Mod1Mask.

Bullet -printCommand. Takes one argument that should be a command that sends the file to the printer, such as lpr or lp. This command appears in the Print dialog box. If the -printCommand option has been used before and it is used again without first clearing the "Print To" field in the Print dialog box, the option will not work. If Publicon is started with the -cleanStart option, the -printCommand option will work again.

Bullet -pureKeys. Disables keybindings involving modifier keys that are defined by the operating system. This option may need to be given in order for some front end keyboard commands to work correctly. For example, some systems may reserve ControlKeyLeftModified6RightModified for internal use and then the front end cannot use this to typeset superscripts. Keybindings involving the ShiftKey key are not disabled by this option.

Bullet -pwfile. Tells the front end to get its password from the specified file.

Bullet -pwpath. Tells the front end to search along the specified path for a mathpass file containing a valid password.

Bullet -querySingleLaunch. Opens a dialog box to ask the user if a file specified on the command line should be opened in the currently running front end. The dialog box appears only if the current front end was also launched with the -querySingleLaunch option.

Bullet -screenXResolution. Specifies the horizontal screen resolution of the notebook display in dots per inch. For example, if the default screen resolution is 75 dpi, setting the option to 150 causes the contents of the notebook window to scale horizontally by a factor of two.

Bullet -screenYResolution. Specifies the vertical screen resolution of the notebook display in dots per inch. For example, if the default screen resolution is 75 dpi, setting the option to 150 causes the contents of the notebook window to scale vertically by a factor of two.

Bullet -secondaryModifierMask. Gives the modifier mask to use as the option key. The default is Mod2Mask.

Bullet -singleLaunch. Allows only one copy of the front end to exist per display. Multiple launches are prevented only if the currently running front end was launched with the -singleLaunch or -querySingleLaunch option.

Bullet -topDirectory. Specifies the directory where Publicon is installed.

Bullet -version. Prints the version number of the front end from the command line.

Bullet -visualChooser. Starts the front end by first putting up the Visual Chooser. This is a dialog box that allows you to specify system parameters such as visual ID, depth, and colormap.

Bullet -watchCLIPBOARD. Tells the front end to watch the CLIPBOARD property for a change in ownership. This is the default. The CLIPBOARD property allows items to be shared between X applications. If this option is set, then you can paste items into Publicon from other applications.

Bullet -wwwBrowser. Gives the command to execute when opening URL links from the front end. The command can include a %s format argument that is replaced with the URL.