steve
/
factor
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
factor/doc/jedit/index.html

162 lines
5.2 KiB
HTML
Raw Normal View History

better plugin docs
2004-08-31 23:42:30 -04:00
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head><title>Factor plugin</title>
<style>
.fancy-heading { background: #c0d0ff; border: 1px solid #2040ff; }
div.fancy-heading { padding: 1px; margin: 0px 0px 3px 0px; }
.nice-box {
padding: 4px;
border-width: 1px;
border-style: dashed;
}
.syntax0 {
color: #000000;
}
.syntax1 {
color: #cc0000;
}
.syntax2 {
color: #ff8400;
}
.syntax3 {
color: #6600cc;
}
.syntax4 {
color: #cc6600;
}
.syntax5 {
color: #ff0000;
}
.syntax6 {
color: #9966ff;
}
.syntax7 {
background: #ffffcc;
color: #ff0066;
}
.syntax8 {
color: #006699;
font-weight: bold;
}
.syntax9 {
color: #009966;
font-weight: bold;
}
.syntax10 {
color: #0099ff;
font-weight: bold;
}
.syntax11 {
color: #66ccff;
font-weight: bold;
}
.syntax12 {
color: #02b902;
}
.syntax13 {
color: #ff00cc;
}
.syntax14 {
color: #cc00cc;
}
.syntax15 {
color: #9900cc;
}
.syntax16 {
color: #6600cc;
}
.syntax17 {
color: #0000ff;
}
.syntax18 {
color: #000000;
font-weight: bold;
}
.gutter {
background: #dbdbdb;
color: #000000;
}
.gutterH {
background: #dbdbdb;
color: #666699;
}
</style>
</head>
<body>
<h1 align="center">Factor plugin</h1>
removed style framework
2005-03-18 19:38:27 -05:00
<p>Factor is a programming language with postfix syntax. The Factor plugin for <a href="http://www.jedit.org">jEdit</a> makes for a more pleasant development experience. It provides many time-saving features for working with Factor code. This document only explains the plugin. For information on Factor itself, including extensive documentation in PDF format, see the Factor web site: <a href="http://factor.sourceforge.net">http://factor.sourceforge.net</a>. <p>
better plugin docs
2004-08-31 23:42:30 -04:00
<h2 class="fancy-heading">Introduction</h2>
removed style framework
2005-03-18 19:38:27 -05:00
The <code>Factor.jar</code> file shipped with the Factor distribution can then be placed in <code>$HOME/.jedit/jars/</code> and loaded by jEdit.<p>
better plugin docs
2004-08-31 23:42:30 -04:00
removed style framework
2005-03-18 19:38:27 -05:00
<h2 class="fancy-heading">Communication with an external Factor instance</h2>
better plugin docs
2004-08-31 23:42:30 -04:00
removed style framework
2005-03-18 19:38:27 -05:00
<p>The Factor plugin needs to communicate with a running instance of a Factor runtime for most features to work. To set up the external instance, go to <b>Plugins</b>&gt;<b>Plugin Options</b>&gt;<b>Factor</b>. You will need to supply a full path to the Factor runtime, as well as a path to the image file.</p>
better plugin docs
2004-08-31 23:42:30 -04:00
removed style framework
2005-03-18 19:38:27 -05:00
<h2 class="fancy-heading">Embedded listener</h2>
better plugin docs
2004-08-31 23:42:30 -04:00
removed style framework
2005-03-18 19:38:27 -05:00
<p>The embedded listener can be accessed by selecting the <b>Factor</b> shell in the Console plugin. The <b>Run current file</b> and <b>Evaluate selection</b> commands can be used to send text from jEdit to the listener.<p>
better plugin docs
2004-08-31 23:42:30 -04:00
<img class="nice-box" src="listener.png">
removed style framework
2005-03-18 19:38:27 -05:00
<h2 class="browsing">Browsing</h2>
better plugin docs
2004-08-31 23:42:30 -04:00
removed style framework
2005-03-18 19:38:27 -05:00
<p>The <b>See word at caret</b> command displays a popup showing the word definition at the caret.</p>
better plugin docs
2004-08-31 23:42:30 -04:00
removed style framework
2005-03-18 19:38:27 -05:00
<img class="nice-box" src="see.png">
better plugin docs
2004-08-31 23:42:30 -04:00
removed style framework
2005-03-18 19:38:27 -05:00
<p>The <b>Edit word at caret</b> command opens the source file containing the definition of the word at the caret.</p>
better plugin docs
2004-08-31 23:42:30 -04:00
<p>The <b>Edit word</b> command opens a dialog box where the name of a word can be typed -- while the word is being typed, the possible completions is instantly updated, and selecting one opens the source file containing the definition of that word:</p>
<img class="nice-box" src="edit-word.png">
<p>To be able to edit definitions of standard library words, add a phrase like the following to your <code>$HOME/.factor-rc</code>:</p>
<pre class="nice-box"><SPAN CLASS="syntax13">&quot;</SPAN><SPAN CLASS="syntax13">/home/slava/Factor/</SPAN><SPAN CLASS="syntax13">&quot;</SPAN> <SPAN CLASS="syntax13">&quot;</SPAN><SPAN CLASS="syntax13">resource-path</SPAN><SPAN CLASS="syntax13">&quot;</SPAN> set
</PRE>
removed style framework
2005-03-18 19:38:27 -05:00
<h2 class="fancy-heading">Cross-referencing</h2>
better plugin docs
2004-08-31 23:42:30 -04:00
<p>The <b>Word usages at caret</b> command displays a list of words that refer to the word at the caret in the Factor listener window. Clicking on words in the listener shows a popup menu with various useful actions.</p>
<img class="nice-box" src="usages.png">
removed style framework
2005-03-18 19:38:27 -05:00
<p>Here we see the result of selecting <b>See</b>.</p>
better plugin docs
2004-08-31 23:42:30 -04:00
<img class="nice-box" src="describe.png">
<h2 class="fancy-heading">Error checking</h2>
<p>Factor files are parsed in a background thread and checked for errors, using the framework provided by the SideKick plugin. Errors are underlined in the text area (and listed in the <b>ErrorList</b> plugin window).</p>
<img class="nice-box" src="error.png">
gc fix
2004-09-01 21:04:16 -04:00
<p>A common error is a missing <code>USE:</code> declaration. The <b>Use word at caret</b> command searches for the word at the caret in all vocabularies, and adds a <code>USE:</code> declaration for the vocabulary to the start of the source file -- in this case, <code>ifte</code> is found in the <code>combinators</code> vocabulary, and the parse error instantly goes away:</p>
better plugin docs
2004-08-31 23:42:30 -04:00
<img class="nice-box" src="word-use.png">
<h2 class="fancy-heading">Completion and browsing</h2>
<p>The stack effect of the word at the caret is shown in the status bar.</p>
<img class="nice-box" src="status.png">
<p>Invoking <b>Plugins</b>&gt;<b>SideKick</b>&gt;<b>Show Completion Popup</b> displays a popup of possible completions for the word at the caret -- bind this to <code>C+SPACE</code> for quick access:</p>
<img class="nice-box" src="complete.png">
<p>The <b>Plugins</b>&gt;<b>SideKick</b>&gt;<b>Structure Browser</b> displays a list of all words defined in the current buffer:</p>
<img class="nice-box" src="word-list.png">
</body>
</html>