General installation

How do I install the package that I downloaded?

If you downloaded the .tgz version, unpack it on the command line with "tar -xzf file_name.tgz", switch to root (easiest via sudo), and then run the install script included in the package. (The uninstall script will remove the program.)

If you downloaded the .rpm version, unpack it on the command line with "tar -xzf file_name.tgz", switch to root (easiest via sudo), and then install the package(s) with "rpm -i --force file_name.rpm". If the installation fails because it cannot find the appropriate version of libstdc++, run "rpm -i --force --nodeps *.rpm".

If you downloaded the .deb version, switch to root (easiest via sudo), and then install the package(s) with "dpkg -i file_name.deb". If the .deb does not work with your version of Debian, use the tar package instead.

I just downloaded and installed the rpm. Where is the binary?

Run "rpm -qlp" on the .rpm file to list the files that it installed.

The binary that I downloaded doesn't work on my system. Does this mean that I have to obtain the source?

General configuration

Where is the Meta key?

On Linux-Intel, it is usually labeled Alt. The default on Debian Linux running on a UK keyboard apparently maps Meta to the Windows Logo key. On other UNIX machines, Meta is sometimes labelled with a diamond. If you can't find it by trying the various strangely labelled keys on your keyboard, please ask your system administrator.

Why don't the Meta menu shortcuts work?

Add the following command to your ~/.xinitrc file:

xmodmap -e "keysym Alt_L = Meta_L Alt_L"

If you are using TightVNC, run vncserver with the -compatiblekbd option.

Why doesn't Meta-click work?

Your window manager is probably grabbing the mouse click so the program never gets it. Most window managers provide a configuration file that you can change so the mouse click isn't grabbed. If your window manager doesn't allow this, ask the developers to add this feature!

If you are using Enlightenment, holding down both Meta and Control will get around this problem.

With KDE, go to their control panel LookNFeel/Window Behavior/Actions and set "Modifier Key + Left button" to "nothing".

Why does the backspace key delete the character to the right instead of the character to the left?

This is a problem with your X server configuration. Somehow, your backspace key is generating Delete instead of BackSpace. On UNIX, the problem can be solved by adding

xmodmap -e "keycode 22 = BackSpace"

to your ~/.xinitrc file. If you are using an X server for Microsoft Windows®, please consult the appropriate documentation.

Why do I see messages like sh: warning: setlocale: LC_ALL: cannot change locale (en_US)?

Some distributions, notably Ubuntu, have this problem. Put the following in ~/.xsessionrc:

export LC_ALL=C

Note: Unfortunately, Ubuntu 9.10 ignores ~/.xsessionrc. To work around this, add the above line to your ~/.profile (assuming you are using the Bourne shell) and then log out and log back in. If you are using a variant of csh, then put setenv LC_ALL C in ~/.login.

When I use XVision, the Meta key doesn't work. How do I fix this?

Make a copy of the appropriate XVision key mapping file in <XVision installation directory>\System\keymap and then modify it to change the description on the first line (DESC) and to map the desired Windows virtual key code (usually VK_MENU) to the X keycode "0xffe7 (Meta_L)". Save this file and then run <XVision installation directory>\Xkg.exe. From this application's File menu, open the key mapping file you just created. This compiles your .txt file into an .xkg file. Choose "Save" from the File menu and quit the application. Now open the XVision properties dialog and choose the Devices tab. Your new keymap should appear in the Keyboard Map drop down list, based on the change you made to the first line of the .txt file. Select it and then let XVision restart.

Thanks to Ian Wakeling for figuring this out.

On OS X, I don't want to display the location of files using System G. How do I get it to use Finder?

Code Crusader configuration

When I start Code Crusader, I get a Save dialog asking to save a project. How do I avoid this?

See the answer to the next question.

I set the preferences to use an external editor and now I can't get it to do anything. How do I get out of this?

Run it with a project file as a command line argument and then change the settings in the Miscellaneous Preferences dialog.

If you don't have any project files, then you must have been using it only as an editor. In this case, run it with the command line option --turn-off-external-editor and then change the settings in the Miscellaneous Preferences dialog.

Editor

How do I create a file that I can use as a template for creating many files with a similar structure? (e.g. a skeleton source file for programming)

Create the file and then use the "Save as template..." item on the File menu.

Can I display all the text files in a single window to reduce the clutter on my screen?

Yes. Right-click on the docktab at the left of the menu bar and select "Dock all windows in default configuration."

Why doesn't Code Crusader support emacs' indenting style?

Code Crusader does not aim to enforce any particular coding standard. Its auto-indent feature only remembers the indent from the previous line.

You can use Character Actions (in the Macro Editor dialog) to enforce any indenting style you want.

Why isn't context-sensitive highlighting working on my files?

Check that the file suffix that you use is listed in the File Types dialog window and is set to the appropriate type.

Why aren't comments in preprocessor directives styled correctly?

It's too much trouble for too little gain. Currently, they are styled as part of the preprocessor directive, and this is technically correct, because the preprocessor is the one which sees them and removes them.

Why doesn't the Functions menu appear in my source files?

Project

Why doesn't it save my project file?

Make sure that the .jcc file is writable. Code Crusader does not save the project file if it is write protected because this would annoy users who share the project file over CVS.

When I try to compile, it complains that it can't find makemake. How do I fix this?

makemake is part of the standard distribution. Make sure that it is on your execution path.

When I try to compile, it complains that it can't find make. How do I fix this?

make may be called something else on your machine. Try creating a symbolic link ~/bin/make that points to your version of make, and make sure that ~/bin/ is at the front of your execution path.

When I try to compile, it complains that it can't find my header files. How do I fix this?

You need to add the directories to SEARCHDIRS in Make.header.

The directories that you specify in the Search Paths dialog are not passed to the compiler, both because different compilers require different command line options about which Code Crusader cannot know, and because you may want to include files in the C++ class tree that are not directly part of your program or visa versa.

When I try to compile my C++ program, I get linker errors. How do I fix this?

You have to edit Make.header. Check the on-line tutorial for more information.

How do I compile code for Qt/KDE?

Create a project that uses qmake.

How do I configure the project to work with GTK+?

Change Make.header to do the following:

CFLAGS    := ${shell gtk-config --cflags}
LOADLIBES := ${shell gtk-config --libs}

My program requires bison. How do I tell make to compile the source files that depend on lex.yy.h after running bison?

Create a build target that runs "makecheck my_bison_file.y" before performing the actual build.

It is also useful to modify the default rule for .y to the following:

%.c : %.y
	@if test -e $*.tab.h; then mv $*.tab.h $*.tab.h_old; fi
	@if ! ${YACC} ${YFLAGS} $<; then \
       if test -e $*.tab.h_old; then mv $*.tab.h_old $*.tab.h; fi; \
       false; fi
	@if test -e $*.tab.h_old -a -z "`diff $*.tab.h $*.tab.h_old 2> /dev/null`"; \
     then mv $*.tab.h_old $*.tab.h; fi

This avoids changing the modification time of the .tab.h file unless its content changes, thereby avoiding unnecessary recompilation of other source files.

How do I put my source files in a directory other than the source directory?

C++ class tree

Why don't my C++ classes show up in the class tree?

Java class tree

Why don't my Java classes show up in the class tree?

Mouse and key bindings

Why doesn't Meta-click work in the C/C++ Styles and HTML Styles dialogs?

Why doesn't Meta-drag initiate Drag-and-Drop in the Editor windows?

Your window manager is probably grabbing the mouse click so Code Crusader never gets it. Most window managers provide a configuration file that you can change so the mouse click isn't grabbed. If your window manager doesn't allow this, ask the developers to add this feature!

If you are using Enlightenment, holding down both Meta and Control will get around this problem.

We agree that Code Crusader should allow you to change the bindings. This is on the list of things to do. It is worse when the window manager isn't configurable, however, because then all other programs suffer.

Why don't the Home/End keys move the caret to the beginning/end of the line?

You can change this behavior in the Editor Preferences dialog.

For those of you who don't care about the theory, the on-line help explains all the key shortcuts, including that Meta-left/right-arrow moves the caret to the beginning/end of the line.

The reason that this is this default is simple consistency. Home/End scrolls every other widget that has a scrollbar. The arrow keys are already designated as the keys that move the caret, so modified arrow keys should provide useful shortcuts.

Also, since the Page Up/Down keys affect the scrollbar, the Home/End keys should also affect the scrollbar, since they are grouped together, at least on Macintosh® and PC keyboards.

As usual, the Macintosh® got it right and Windows®/Motif got it wrong.

Why doesn't the caret follow when I scroll the text?

You can change this behavior in the Editor Preferences dialog.

For those of you who don't care about the theory, the on-line help explains all the key shortcuts, including that Ctrl-up/down-arrow moves the caret to the top/bottom of the visible text.

The reason that this is the default is that it can be very useful to have the caret stay where it is. If you scroll somewhere (e.g. via a scrolltab!) to peek at something, you can get back to where you were by simply pressing any arrow key.

Window manager issues

Which window manager do you recommend using?

Miscellaneous

Can I change the default font size?

You can change the default menu font size by creating the file ~/.jx/menu_font with the following format:

font_name
font_size

Does the program support themes?