thdltools/Jskad
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Added Javadoc files overview.html and several package.html files.

Browse source 
Added a "Quit" option to Savant's File menu.  Factored out the Close
option in doing so.

Exceptions in many action listeners are now handled by
org.thdl.util.ThdlActionListener or org.thdl.util.ThdlAbstractAction.

Many exceptions that we used to just log now optionally cause aborts.
This option is on by default for developers using 'ant savant-run'-style
targets, but it is off for users.

An erroneous CLASSPATH now causes a useful error message in almost
all situations.

Fixed some typos and bad links in Javadoc comments.

Added a simple assertion facility, but the overhead is suffered even in
release builds.

Factored out the code that sets up log files like savant.log and jskad.log.
This commit is contained in:
dchandler 2002-10-06 18:23:27 +00:00
parent 14adf0d607
commit 403f21c8db
47 changed files with 2439 additions and 1567 deletions
Download patch file Download diff file Expand all files Collapse all files

15
source/org/thdl/tib/input/DuffPane.java
View file

@ -32,6 +32,8 @@ import org.thdl.tib.text.*;
import java.io.*;
import javax.swing.text.rtf.*;
import org.thdl.util.ThdlDebug;
/**
* Enables input of Tibetan text
* using Tibetan Computer Company's free cross-platform TibetanMachineWeb fonts.
@ -764,6 +766,7 @@ class RTFSelection implements ClipboardOwner, Transferable {
newDoc.insertString(i-offset, s, as);
} catch (BadLocationException ble) {
ble.printStackTrace();
ThdlDebug.noteIffyCode();
}
}
rtfOut = new ByteArrayOutputStream();
@ -771,8 +774,10 @@ class RTFSelection implements ClipboardOwner, Transferable {
plainText = getText(offset, length);
} catch (BadLocationException ble) {
ble.printStackTrace();
ThdlDebug.noteIffyCode();
} catch (IOException ioe) {
ioe.printStackTrace();
ThdlDebug.noteIffyCode();
}
}
public void lostOwnership(Clipboard clipboard, Transferable contents) {
@ -816,6 +821,7 @@ class RTFSelection implements ClipboardOwner, Transferable {
rtfBoard.setContents(rtfSelection, rtfSelection);
} catch (IllegalStateException ise) {
ise.printStackTrace();
ThdlDebug.noteIffyCode();
}
}
if (remove)
@ -823,6 +829,7 @@ class RTFSelection implements ClipboardOwner, Transferable {
getDocument().remove(p1, p2-p1);
} catch (BadLocationException ble) {
ble.printStackTrace();
ThdlDebug.noteIffyCode();
}
}
@ -853,6 +860,7 @@ public void paste(int offset) {
doc.insertString(p1+i, s, as);
} catch (BadLocationException ble) {
ble.printStackTrace();
ThdlDebug.noteIffyCode();
}
}
} else if (contents.isDataFlavorSupported(DataFlavor.stringFlavor)) {
@ -861,12 +869,16 @@ public void paste(int offset) {
}
} catch (UnsupportedFlavorException ufe) {
ufe.printStackTrace();
ThdlDebug.noteIffyCode();
} catch (IOException ioe) {
ioe.printStackTrace();
ThdlDebug.noteIffyCode();
} catch (IllegalStateException ise) {
ise.printStackTrace();
ThdlDebug.noteIffyCode();
} catch (BadLocationException ble) {
ble.printStackTrace();
ThdlDebug.noteIffyCode();
}
}
@ -1347,6 +1359,7 @@ public void paste(int offset) {
}
catch (BadLocationException ble) {
ble.printStackTrace();
ThdlDebug.noteIffyCode();
}
}
@ -1368,6 +1381,7 @@ public void paste(int offset) {
offset++;
} catch (BadLocationException ble) {
ble.printStackTrace();
ThdlDebug.noteIffyCode();
}
} else {
TibetanDocument.DuffData[] dd = TibetanDocument.getTibetanMachineWeb(next);
@ -1444,6 +1458,7 @@ public void paste(int offset) {
}
catch (BadLocationException ble) {
ble.printStackTrace();
ThdlDebug.noteIffyCode();
}
}

94
source/org/thdl/tib/input/Jskad.java
View file

@ -32,7 +32,9 @@ import javax.swing.text.*;
import javax.swing.text.rtf.*;
import org.thdl.tib.text.*;
import org.thdl.util.TeeStream;
import org.thdl.util.ThdlDebug;
import org.thdl.util.ThdlActionListener;
/**
* A simple Tibetan text editor. Jskad editors lack most of the
@ -97,8 +99,8 @@ public class Jskad extends JPanel implements DocumentListener {
JMenuItem newItem = new JMenuItem("New");
// newItem.setAccelerator(KeyStroke.getKeyStroke(KeyEvent.VK_N,2)); //Ctrl-n
newItem.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
newItem.addActionListener(new ThdlActionListener() {
public void theRealActionPerformed(ActionEvent e) {
newFile();
}
});
@ -106,8 +108,8 @@ public class Jskad extends JPanel implements DocumentListener {
JMenuItem openItem = new JMenuItem("Open");
// openItem.setAccelerator(KeyStroke.getKeyStroke(KeyEvent.VK_O,2)); //Ctrl-o
openItem.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
openItem.addActionListener(new ThdlActionListener() {
public void theRealActionPerformed(ActionEvent e) {
openFile();
}
});
@ -115,8 +117,8 @@ public class Jskad extends JPanel implements DocumentListener {
if (parentObject instanceof JFrame) {
JMenuItem closeItem = new JMenuItem("Close");
closeItem.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
closeItem.addActionListener(new ThdlActionListener() {
public void theRealActionPerformed(ActionEvent e) {
if (!hasChanged || hasChanged && checkSave()) {
numberOfTibsRTFOpen--;
@ -134,8 +136,8 @@ public class Jskad extends JPanel implements DocumentListener {
JMenuItem saveItem = new JMenuItem("Save");
// saveItem.setAccelerator(KeyStroke.getKeyStroke(KeyEvent.VK_S,2)); //Ctrl-s
saveItem.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
saveItem.addActionListener(new ThdlActionListener() {
public void theRealActionPerformed(ActionEvent e) {
if (fileName == null)
saveAsFile();
else
@ -147,8 +149,8 @@ public class Jskad extends JPanel implements DocumentListener {
fileMenu.add(saveItem);
JMenuItem saveAsItem = new JMenuItem("Save as");
saveAsItem.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
saveAsItem.addActionListener(new ThdlActionListener() {
public void theRealActionPerformed(ActionEvent e) {
saveAsFile();
}
});
@ -162,8 +164,8 @@ public class Jskad extends JPanel implements DocumentListener {
if (parentObject instanceof JFrame || parentObject instanceof JInternalFrame) {
JMenuItem cutItem = new JMenuItem("Cut");
cutItem.setAccelerator(KeyStroke.getKeyStroke(KeyEvent.VK_X,2)); //Ctrl-x
cutItem.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
cutItem.addActionListener(new ThdlActionListener() {
public void theRealActionPerformed(ActionEvent e) {
cutSelection();
}
});
@ -171,8 +173,8 @@ public class Jskad extends JPanel implements DocumentListener {
JMenuItem copyItem = new JMenuItem("Copy");
copyItem.setAccelerator(KeyStroke.getKeyStroke(KeyEvent.VK_C,2)); //Ctrl-c
copyItem.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
copyItem.addActionListener(new ThdlActionListener() {
public void theRealActionPerformed(ActionEvent e) {
copySelection();
}
});
@ -180,8 +182,8 @@ public class Jskad extends JPanel implements DocumentListener {
JMenuItem pasteItem = new JMenuItem("Paste");
pasteItem.setAccelerator(KeyStroke.getKeyStroke(KeyEvent.VK_V,2)); //Ctrl-v
pasteItem.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
pasteItem.addActionListener(new ThdlActionListener() {
public void theRealActionPerformed(ActionEvent e) {
pasteSelection();
}
});
@ -190,8 +192,8 @@ public class Jskad extends JPanel implements DocumentListener {
JMenuItem selectallItem = new JMenuItem("Select All");
selectallItem.setAccelerator(KeyStroke.getKeyStroke(KeyEvent.VK_A,2)); //Ctrl-a
selectallItem.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
selectallItem.addActionListener(new ThdlActionListener() {
public void theRealActionPerformed(ActionEvent e) {
dp.setSelectionStart(0);
dp.setSelectionEnd(dp.getDocument().getLength());
}
@ -200,8 +202,8 @@ public class Jskad extends JPanel implements DocumentListener {
}
JMenuItem preferencesItem = new JMenuItem("Preferences");
preferencesItem.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
preferencesItem.addActionListener(new ThdlActionListener() {
public void theRealActionPerformed(ActionEvent e) {
getPreferences();
}
});
@ -213,16 +215,16 @@ public class Jskad extends JPanel implements DocumentListener {
JMenu toolsMenu = new JMenu("Tools");
JMenuItem TMWWylieItem = new JMenuItem("Convert Tibetan to Wylie");
TMWWylieItem.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
TMWWylieItem.addActionListener(new ThdlActionListener() {
public void theRealActionPerformed(ActionEvent e) {
toWylie();
}
});
toolsMenu.add(TMWWylieItem);
JMenuItem wylieTMWItem = new JMenuItem("Convert Wylie to Tibetan");
wylieTMWItem.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
wylieTMWItem.addActionListener(new ThdlActionListener() {
public void theRealActionPerformed(ActionEvent e) {
toTibetan();
}
});
@ -230,8 +232,8 @@ public class Jskad extends JPanel implements DocumentListener {
if (parentObject instanceof JFrame || parentObject instanceof JInternalFrame) {
JMenuItem importItem = new JMenuItem("Import Wylie as Tibetan");
importItem.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
importItem.addActionListener(new ThdlActionListener() {
public void theRealActionPerformed(ActionEvent e) {
importWylie();
}
});
@ -244,8 +246,8 @@ public class Jskad extends JPanel implements DocumentListener {
JMenu infoMenu = new JMenu("Info");
JMenuItem aboutItem = new JMenuItem("About");
aboutItem.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
aboutItem.addActionListener(new ThdlActionListener() {
public void theRealActionPerformed(ActionEvent e) {
JOptionPane.showMessageDialog(Jskad.this,
"Copyright 2001 Tibetan and Himalayan Digital Library\n"+
"Programmed by Edward Garrett\n\n"+
@ -275,8 +277,8 @@ public class Jskad extends JPanel implements DocumentListener {
String[] input_modes = {"Tibetan","Roman"};
final JComboBox inputmethods = new JComboBox(input_modes);
inputmethods.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
inputmethods.addActionListener(new ThdlActionListener() {
public void theRealActionPerformed(ActionEvent e) {
switch (inputmethods.getSelectedIndex()) {
case 0: //Tibetan
if (dp.isRomanMode())
@ -300,8 +302,8 @@ public class Jskad extends JPanel implements DocumentListener {
String[] keyboard_options = {"Extended Wylie","TCC Keyboard #1","TCC Keyboard #2","Sambhota Keymap One"};
final JComboBox keyboards = new JComboBox(keyboard_options);
keyboards.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
keyboards.addActionListener(new ThdlActionListener() {
public void theRealActionPerformed(ActionEvent e) {
switch (keyboards.getSelectedIndex()) {
case 0: //Extended Wylie
installKeyboard("wylie");
@ -599,9 +601,11 @@ public class Jskad extends JPanel implements DocumentListener {
hasChanged = false;
} catch (IOException exception) {
exception.printStackTrace();
ThdlDebug.noteIffyCode();
return null;
} catch (BadLocationException ble) {
ble.printStackTrace();
ThdlDebug.noteIffyCode();
}
return f_name;
}
@ -899,26 +903,12 @@ public class Jskad extends JPanel implements DocumentListener {
}
/**
* Runs Jskad.
* System output, including errors, is redirected to jskad.log.
* If you discover a bug, please send us an email, making sure
* to include the jskad.log file as an attachment.
*/
* Runs Jskad. System output, including errors, is redirected to
* jskad.log in addition to appearing on the console as per usual. If
* you discover a bug, please send us an email, making sure to include
* the jskad.log file as an attachment. */
public static void main(String[] args) {
try {
PrintStream psOut
= new TeeStream(System.out,
new PrintStream(new FileOutputStream("jskad.log")));
PrintStream psErr
= new TeeStream(System.err,
new PrintStream(new FileOutputStream("jskad.log")));
System.setErr(psErr);
System.setOut(psOut);
}
catch (Exception e) {
}
ThdlDebug.attemptToSetUpLogFile("jskad.log");
try {
UIManager.setLookAndFeel(UIManager.getSystemLookAndFeelClassName());

8
source/org/thdl/tib/input/Jskad2JavaScript.java
View file

@ -22,9 +22,11 @@ import java.applet.Applet;
import java.awt.*;
import java.awt.event.*;
import javax.swing.*;
import org.thdl.tib.text.*;
import netscape.javascript.JSObject;
import org.thdl.tib.text.*;
import org.thdl.util.ThdlActionListener;
/**
* A version of Jskad which can be embedded into
* a web page as an applet. It includes all of the functionality
@ -54,9 +56,9 @@ public class Jskad2JavaScript extends JApplet {
jskad = new Jskad(this);
panel.add("Center", jskad);
JButton submit = new JButton("Submit");
submit.addActionListener(new ActionListener()
submit.addActionListener(new ThdlActionListener()
{
public void actionPerformed(ActionEvent e)
public void theRealActionPerformed(ActionEvent e)
{
try {
TibetanDocument t_doc = (TibetanDocument)jskad.dp.getDocument();

8
source/org/thdl/tib/input/JskadConversionTool.java
View file

@ -22,9 +22,11 @@ import java.applet.Applet;
import java.awt.*;
import java.awt.event.*;
import javax.swing.*;
import org.thdl.tib.text.*;
import netscape.javascript.JSObject;
import org.thdl.tib.text.*;
import org.thdl.util.ThdlActionListener;
/**
* A version of Jskad which can be embedded into
* a web page as an applet. It includes all of the functionality
@ -54,9 +56,9 @@ public class JskadConversionTool extends JApplet {
jskad = new Jskad(this);
panel.add("Center", jskad);
JButton submit = new JButton("Submit");
submit.addActionListener(new ActionListener()
submit.addActionListener(new ThdlActionListener()
{
public void actionPerformed(ActionEvent e)
public void theRealActionPerformed(ActionEvent e)
{
try {
TibetanDocument t_doc = (TibetanDocument)jskad.dp.getDocument();

70
source/org/thdl/tib/input/package.html
View file

@ -1,35 +1,35 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!--
@(#)package.html
Copyright 2001 Tibetan and Himalayan Digital Library
This software is the confidential and proprietary information of
the Tibetan and Himalayan Digital Library. You shall use such
information only in accordance with the terms of the license
agreement you entered into with the THDL.
-->
</head>
<body bgcolor="white">
Provides classes and methods for inputting Tibetan text.
<p>
Designed for use with the Tibetan Computer
Company's free cross-platform TibetanMachineWeb fonts, this package
contains methods for inputting Tibetan using various keyboard
input methods, including true Wylie-based input, as well as
user-defined keyboards.
<p>
The package includes a simple Tibetan text editor, Jskad,
which can be run as an local application or embedded in a
web page. Jskad supports a wide range of functions, including
conversion back and forth between TibetanMachineWeb and
Extended Wylie.
<p>
<h2>Related Documentation</h2>
@see org.thdl.tib.text
</body>
</html>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!--
@(#)package.html
Copyright 2001-2002 Tibetan and Himalayan Digital Library
This software is the confidential and proprietary information of
the Tibetan and Himalayan Digital Library. You shall use such
information only in accordance with the terms of the license
agreement you entered into with the THDL.
-->
</head>
<body bgcolor="white">
Provides classes and methods for inputting Tibetan text.
<p>
Designed for use with the Tibetan Computer
Company's free cross-platform TibetanMachineWeb fonts, this package
contains methods for inputting Tibetan using various keyboard
input methods, including true Wylie-based input, as well as
user-defined keyboards.
<p>
The package includes a simple Tibetan text editor, Jskad,
which can be run as an local application or embedded in a
web page. Jskad supports a wide range of functions, including
conversion back and forth between TibetanMachineWeb and
Extended Wylie.
<p>
<h2>Related Documentation</h2>
@see <a href="../text/package-summary.html">org.thdl.tib.text</a>
</body>
</html>

5
source/org/thdl/tib/scanner/AboutDialog.java
View file

@ -36,6 +36,9 @@ class AboutDialog extends Dialog implements ActionListener, WindowListener
setSize(240,300); // the size ipaq's window.
}
/* FIXME: what happens if this throws an exception? We'll just
see it on the console--it won't terminate the program. And the
user may not see the console! See ThdlActionListener. -DC */
public void actionPerformed(ActionEvent e)
{
hide();
@ -116,4 +119,4 @@ class AboutDialog extends Dialog implements ActionListener, WindowListener
public void windowOpened(WindowEvent e)
{
}
}
}

5
source/org/thdl/tib/scanner/AppletScannerFilter.java
View file

@ -42,7 +42,7 @@ import org.thdl.tib.text.TibetanDocument;
@author Andr&eacute;s Montano Pellegrini
@see RemoteScannerFilter
@see ScannerPannel
@see ScannerPanel
*/
public class AppletScannerFilter extends JApplet implements ActionListener, FocusListener, ItemListener
{
@ -154,6 +154,9 @@ public class AppletScannerFilter extends JApplet implements ActionListener, Focu
/* mnuEdit.setEnabled(false);
objModified=null;*/
}
/* FIXME: what happens if this throws an exception? We'll just
see it on the console--it won't terminate the program. And the
user may not see the console! See ThdlActionListener. -DC */
public void actionPerformed(ActionEvent e)
{
Object clicked = e.getSource();

4
source/org/thdl/tib/scanner/DictionarySource.java
View file

@ -28,7 +28,7 @@ public class DictionarySource
{
private int dicts;
/** Last bit of word. 1 if there are more brothers.*/
/** Last bit of word; 1 if there are more brothers.*/
private static final int lastBit=32768;
private static final int allDicts=lastBit-1;
@ -134,4 +134,4 @@ public class DictionarySource
{
dicts = 0;
}
}
}

8
source/org/thdl/tib/scanner/FileSyllableListTree.java
View file

@ -19,16 +19,16 @@ package org.thdl.tib.scanner;
import java.io.*;
/** Searches the words directly in a file; not the prefered
/** Searches the words directly in a file; not the preferred
implementation. The search is too slow!
The prefered implementation is the CachedSyllableList.
The preferred implementation is the CachedSyllableListTree.
<p>The words must be stored in a binary file tree structure format.
This can be done using the BinaryFileGenerator.</p>
@author Andr&eacute;s Montano Pellegrini
@see TibetanScanner
@see CachedSyllableList
@see CachedSyllableListTree
@see BinaryFileGenerator
*/
@ -158,4 +158,4 @@ public class FileSyllableListTree implements SyllableListTree
}
return null;
}
}
}

5
source/org/thdl/tib/scanner/ScannerPanel.java
View file

@ -167,6 +167,9 @@ public abstract class ScannerPanel extends Panel implements ActionListener
}
}
/* FIXME: what happens if this throws an exception? We'll just
see it on the console--it won't terminate the program. And the
user may not see the console! See ThdlActionListener. -DC */
public void actionPerformed(ActionEvent e)
{
translate();
@ -176,4 +179,4 @@ public abstract class ScannerPanel extends Panel implements ActionListener
public abstract void clear();
public void setEnableTibetanScript(boolean enabled) {}
public void addFocusListener(FocusListener fl) {}
}
}

5
source/org/thdl/tib/scanner/WindowScannerFilter.java
View file

@ -246,7 +246,10 @@ public class WindowScannerFilter implements WindowListener, FocusListener, Actio
mnuDelete.setEnabled(false);
mnuSelectAll.setEnabled(false);
}
/* FIXME: what happens if this throws an exception? We'll just
see it on the console--it won't terminate the program. And the
user may not see the console! See ThdlActionListener. -DC */
public void actionPerformed(ActionEvent e)
{
Object clicked = e.getSource();

21
source/org/thdl/tib/scanner/package.html Normal file
View file

@ -0,0 +1,21 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!--
@(#)package.html
-->
</head>
<body bgcolor="white">
Provides classes and methods for translating Tibetan text to English.
<p>
Right now, this package scans Tibetan text, but we aim to make it parse Tibetan text.
<p>
Author: Andr&eacute;s Montano Pellegrini
<p>
<h2>Related Documentation</h2>
@see <a href="../text/package-summary.html">org.thdl.tib.text</a>
@see <a href="../input/package-summary.html">org.thdl.tib.input</a>
</body>
</html>

2559
source/org/thdl/tib/text/TibetanDocument.java
View file

File diff suppressed because it is too large Load diff

4
source/org/thdl/tib/text/package.html
View file

@ -5,7 +5,7 @@
@(#)package.html
Copyright 2001 Tibetan and Himalayan Digital Library
Copyright 2001-2002 Tibetan and Himalayan Digital Library
This software is the confidential and proprietary information of
the Tibetan and Himalayan Digital Library. You shall use such
@ -33,6 +33,6 @@ Here, you can also find methods for installing and managing Tibetan
keyboards. Four keyboards have been provided in this release,
but users may also create their own keyboards.
<h2>Related Documentation</h2>
@see org.thdl.tib.input
@see <a href="../input/package-summary.html">org.thdl.tib.input</a>
</body>
</html>