| 1 | <html> |
|---|
| 2 | <head> |
|---|
| 3 | <meta name="author" content="Peter Graves"> |
|---|
| 4 | <meta name="description" content="J"> |
|---|
| 5 | <meta name="keywords" content="Armed Bear, j, editor, Java, Common Lisp, open source, GPL"> |
|---|
| 6 | <link rel="stylesheet" href="armedbear.css" type="text/css"> |
|---|
| 7 | <title>J</title> |
|---|
| 8 | </head> |
|---|
| 9 | |
|---|
| 10 | <body> |
|---|
| 11 | |
|---|
| 12 | <center> |
|---|
| 13 | <h1>Armed Bear</h1> |
|---|
| 14 | <i>The right of the people to keep and arm bears shall not be infringed!</i> |
|---|
| 15 | </center> |
|---|
| 16 | |
|---|
| 17 | <hr size="2"> |
|---|
| 18 | |
|---|
| 19 | <p> |
|---|
| 20 | <font face="sans-serif" size="4"> |
|---|
| 21 | <b>About J</b> |
|---|
| 22 | </font> |
|---|
| 23 | <dl> |
|---|
| 24 | <dd> |
|---|
| 25 | J is a text editor written in Java and distributed under the |
|---|
| 26 | <a href="http://www.gnu.org/copyleft/gpl.html">GNU General Public |
|---|
| 27 | License</a>. |
|---|
| 28 | <p> |
|---|
| 29 | J runs on platforms that support Java 1.4, including Linux, |
|---|
| 30 | Windows, and Mac OS X. |
|---|
| 31 | <p> |
|---|
| 32 | J is free software and comes with ABSOLUTELY NO WARRANTY. |
|---|
| 33 | <p> |
|---|
| 34 | The latest version is 0.21.0, released September 24, 2004. |
|---|
| 35 | </dd> |
|---|
| 36 | </dl> |
|---|
| 37 | |
|---|
| 38 | <p> |
|---|
| 39 | <font face="sans-serif" size="4"> |
|---|
| 40 | <b>Screenshots</b> |
|---|
| 41 | </font> |
|---|
| 42 | <dl> |
|---|
| 43 | <dd>J 0.14.0 in Java mode, with line numbers and change marks turned on: |
|---|
| 44 | <br><br> |
|---|
| 45 | <dl> |
|---|
| 46 | <dd><a href="http://armedbear-j.sourceforge.net/j-0.14.0.png">j-0.14.0.png</a> (91816 bytes)</dd> |
|---|
| 47 | </dl> |
|---|
| 48 | </dd> |
|---|
| 49 | <p> |
|---|
| 50 | <dd>J 0.16.4 reading mail: |
|---|
| 51 | <br><br> |
|---|
| 52 | <dl> |
|---|
| 53 | <dd><a href="http://armedbear-j.sourceforge.net/j-0.16.4.png">j-0.16.4.png</a> (145493 bytes)</dd> |
|---|
| 54 | </dl> |
|---|
| 55 | </dd> |
|---|
| 56 | <p> |
|---|
| 57 | <dd>J 0.19.0 in the Java debugger: |
|---|
| 58 | <br><br> |
|---|
| 59 | <dl> |
|---|
| 60 | <dd><a href="http://armedbear-j.sourceforge.net/j-0.19.0.png">j-0.19.0.png</a> (111165 bytes)</dd> |
|---|
| 61 | </dl> |
|---|
| 62 | </dd> |
|---|
| 63 | </dl> |
|---|
| 64 | |
|---|
| 65 | <p> |
|---|
| 66 | <font face="sans-serif" size="4"> |
|---|
| 67 | <b>Download</b> |
|---|
| 68 | </font> |
|---|
| 69 | <dl> |
|---|
| 70 | <dd> |
|---|
| 71 | The latest release is available from the SourceForge |
|---|
| 72 | <a href=http://sourceforge.net/project/showfiles.php?group_id=55057>download page</a>. |
|---|
| 73 | </dd> |
|---|
| 74 | </dl> |
|---|
| 75 | |
|---|
| 76 | <p> |
|---|
| 77 | <font face="sans-serif" size="4"> |
|---|
| 78 | <b>Documentation</b> |
|---|
| 79 | </font> |
|---|
| 80 | <dl> |
|---|
| 81 | <dd> |
|---|
| 82 | Documentation is included in both source and binary distributions. |
|---|
| 83 | <p> |
|---|
| 84 | You can also view the documentation for the current release |
|---|
| 85 | <a href="http://armedbear-j.sourceforge.net/doc/contents.html">online</a>. |
|---|
| 86 | </dd> |
|---|
| 87 | </dl> |
|---|
| 88 | |
|---|
| 89 | <p> |
|---|
| 90 | <font face="sans-serif" size="4"> |
|---|
| 91 | <b>Mailing Lists</b> |
|---|
| 92 | </font> |
|---|
| 93 | <dl> |
|---|
| 94 | <dd>J's mailing list page on SourceForge is <a href="http://sourceforge.net/mail/?group_id=55057">here</a>.</dd> |
|---|
| 95 | </dl> |
|---|
| 96 | |
|---|
| 97 | <p> |
|---|
| 98 | <font face="sans-serif" size="4"> |
|---|
| 99 | <b>Reporting Bugs</b> |
|---|
| 100 | </font> |
|---|
| 101 | <dl> |
|---|
| 102 | <dd><a href="http://sourceforge.net/tracker/?func=add&group_id=55057&atid=475785">Report a bug</a>.</dd> |
|---|
| 103 | </dl> |
|---|
| 104 | |
|---|
| 105 | <p> |
|---|
| 106 | <font face="sans-serif" size="4"> |
|---|
| 107 | <b>What's New</b> |
|---|
| 108 | </font> |
|---|
| 109 | <dl> |
|---|
| 110 | <dd> |
|---|
| 111 | <b>Sep 24 2004 4:45 PM - Version 0.21.0</b> |
|---|
| 112 | <p> |
|---|
| 113 | Some minor problems that prevented j from working correctly with the Java 1.5 |
|---|
| 114 | betas are fixed in this release. |
|---|
| 115 | <p> |
|---|
| 116 | It is now possible to use drag/drop in the sidebar buffer list to reorder the |
|---|
| 117 | buffers, so that navigating between buffers using |
|---|
| 118 | <a href="http://armedbear-j.sourceforge.net/doc/commands.html#nextBuffer">nextBuffer</a> and |
|---|
| 119 | <a href="http://armedbear-j.sourceforge.net/doc/commands.html#prevBuffer">prevBuffer</a> (mapped by default to |
|---|
| 120 | Alt Right and Alt Left, respectively) is more efficient. Thanks to Mike |
|---|
| 121 | Rutter for providing the code to do this. |
|---|
| 122 | <p> |
|---|
| 123 | By request, the command |
|---|
| 124 | <a href="http://armedbear-j.sourceforge.net/doc/commands.html#wrapParagraphsInRegion">wrapParagraphsInRegion</a> |
|---|
| 125 | has been added. It is mapped by default to Ctrl Shift F12 in plain text and |
|---|
| 126 | mail composition buffers. |
|---|
| 127 | <a href="http://armedbear-j.sourceforge.net/doc/commands.html#wrapParagraphsInRegion">wrapParagraphsInRegion</a> |
|---|
| 128 | walks through the region (or the whole buffer if no region is selected) and, |
|---|
| 129 | in effect, calls <a href="http://armedbear-j.sourceforge.net/doc/commands.html#wrapParagraph">wrapParagraph</a> |
|---|
| 130 | on each paragraph. |
|---|
| 131 | <p> |
|---|
| 132 | The wrap commands should now do a better job of handling lines that break on |
|---|
| 133 | the hyphen of a hyphenated word (like "wrap-paragraph"). If the paragraph is |
|---|
| 134 | subsequently reformatted in such a way that the line break no longer falls on |
|---|
| 135 | the hyphen in question, the parts of the hyphenated word are now put back |
|---|
| 136 | together properly. In previous versions of j, you were likely to end up with |
|---|
| 137 | "wrap- paragraph", with a bogus extra space after the hyphen. |
|---|
| 138 | <p> |
|---|
| 139 | The commands |
|---|
| 140 | <a href="http://armedbear-j.sourceforge.net/doc/commands.html#pageUpOtherWindow">pageUpOtherWindow</a> and |
|---|
| 141 | <a href="http://armedbear-j.sourceforge.net/doc/commands.html#pageDownOtherWindow">pageDownOtherWindow</a> have |
|---|
| 142 | been added. They are mapped by default to Alt Page Down and Alt Page Up, |
|---|
| 143 | respectively, in all modes. These commands are helpful in a split-window |
|---|
| 144 | situation when you want to scroll the other window without switching to it. |
|---|
| 145 | <p> |
|---|
| 146 | The commmand |
|---|
| 147 | <a href="http://armedbear-j.sourceforge.net/doc/commands.html#findOccurrenceAtDotAndKillList">findOccurrenceAtDotAndKillList</a> |
|---|
| 148 | has been added. It is mapped by default to Ctrl Enter in List Occurrences |
|---|
| 149 | buffers. It works like |
|---|
| 150 | <a href="http://armedbear-j.sourceforge.net/doc/commands.html#findOccurrenceAtDot">findOccurrenceAtDot</a>, but |
|---|
| 151 | in addition it closes the List Occurrences buffer. |
|---|
| 152 | <p> |
|---|
| 153 | The commands <a href="http://armedbear-j.sourceforge.net/doc/commands.html#shellNextPrompt">shellNextPrompt</a> |
|---|
| 154 | and <a href="http://armedbear-j.sourceforge.net/doc/commands.html#shellPreviousPrompt">shellPreviousPrompt</a> |
|---|
| 155 | have been added. They are mapped by default to Ctrl Alt N and Ctrl Alt P, |
|---|
| 156 | respectively, in shell buffers and their derivatives (including Lisp shells), |
|---|
| 157 | and they help you find the next or previous prompt, starting from the current |
|---|
| 158 | location of the caret. |
|---|
| 159 | <p> |
|---|
| 160 | The command <a href="http://armedbear-j.sourceforge.net/doc/commands.html#p4Log">p4Log</a> has been added. It |
|---|
| 161 | runs the Perforce command "filelog -l" on the file associated with the |
|---|
| 162 | current buffer. |
|---|
| 163 | <p> |
|---|
| 164 | The command <a href="http://armedbear-j.sourceforge.net/doc/commands.html#p4Diff">p4Diff</a> now runs the |
|---|
| 165 | Perforce command "p4 diff -f -du", instead of "p4 diff -du". This change |
|---|
| 166 | means that <a href="http://armedbear-j.sourceforge.net/doc/commands.html#p4Diff">p4Diff</a> will display |
|---|
| 167 | potentially useful output even if the file associated with the current buffer |
|---|
| 168 | has not, in Perforce's opinion, been officially opened for editing. |
|---|
| 169 | <p> |
|---|
| 170 | J's ssh-related code now recognizes "Response:" as a password prompt, in |
|---|
| 171 | addition the to other password prompts it recognized already. |
|---|
| 172 | <p> |
|---|
| 173 | Compilation buffers are now supported on Windows NT 4. Thanks to Pete Kirkham |
|---|
| 174 | for pointing out that this was possible. |
|---|
| 175 | <p> |
|---|
| 176 | In previous versions of j, there was an incorrect optimization in the display |
|---|
| 177 | code which malfunctioned on very rare occasions and caused lines to disappear |
|---|
| 178 | from the display, even though they were still present in the buffer (there |
|---|
| 179 | was never any loss of data). This bug has been fixed by removing the |
|---|
| 180 | optimization in question. |
|---|
| 181 | <p> |
|---|
| 182 | There are a number of new features and minor improvements in Lisp mode and |
|---|
| 183 | in Lisp shells. Thanks to Sam Steingold for help with many of these. |
|---|
| 184 | <p> |
|---|
| 185 | This release includes version 0.0.4 of Armed Bear Common Lisp. ABCL 0.0.4 |
|---|
| 186 | passes 17778 out of 17942 tests in the GCL ANSI Common Lisp test suite, for a |
|---|
| 187 | nominal compliance of 99.0859%. The test suite is still not complete, |
|---|
| 188 | however, so ABCL's actual percentage of ANSI compliance, whatever that may |
|---|
| 189 | mean, is undoubtedly lower. In any case, version 0.0.4 represents a |
|---|
| 190 | substantial improvement over version 0.0.3, back when it was still called |
|---|
| 191 | Armed Bear Lisp, which passed 12986 out of 14127 tests (91.92%). |
|---|
| 192 | <p> |
|---|
| 193 | ABCL includes a compiler, written in Lisp, that generates JVM bytecode from |
|---|
| 194 | Lisp source. The compiler is not finished, and there are valid Lisp |
|---|
| 195 | constructs that it doesn't know how to compile. In most situations, when the |
|---|
| 196 | compiler encounters code that it can't compile correctly, it is smart enough |
|---|
| 197 | to leave the code alone so that it will continue to work correctly with the |
|---|
| 198 | interpreter. Compiled code and interpreted code can coexist happily in the |
|---|
| 199 | same running instance of ABCL. |
|---|
| 200 | <p> |
|---|
| 201 | The 0.21.0 binary distribution contains a compiled version of the Lisp |
|---|
| 202 | library code (i.e. a full set of .abcl and .cls files), as well as the Lisp |
|---|
| 203 | source files for the library code that is implemented in Lisp. If you build j |
|---|
| 204 | from source, using either configure/make or Ant, the Lisp library code will |
|---|
| 205 | be compiled as part of the build. There is no longer any need to do |
|---|
| 206 | COMPILE-SYSTEM manually. |
|---|
| 207 | <p> |
|---|
| 208 | ABCL 0.0.4 is better at some things than others. In particular, it's not very |
|---|
| 209 | good at CLOS. ABCL's CLOS correctness is reasonable, but its CLOS performance |
|---|
| 210 | is terrible (for one thing, the compiler doesn't even attempt to compile |
|---|
| 211 | generic functions). This deficiency is due more to simple neglect than to any |
|---|
| 212 | intrinsic limitation, and the CLOS implementation should improve in future |
|---|
| 213 | releases. |
|---|
| 214 | <p> |
|---|
| 215 | You can start ABCL from within j by doing Alt X, "abcl", or by selecting "Run |
|---|
| 216 | Lisp as Separate Process" from the Lisp menu. Note that the "Run Embedded |
|---|
| 217 | Lisp" menu selection opens a Lisp shell using an instance of ABCL that runs |
|---|
| 218 | in the editor process; it only makes sense to do this if you're planning to |
|---|
| 219 | interact with the running instance of j, which is not normally the case. If |
|---|
| 220 | you just want to experiment with ABCL, "Run Lisp as Separate Process" (or Alt |
|---|
| 221 | X, "abcl") is your friend. |
|---|
| 222 | <p> |
|---|
| 223 | If you're truly adventurous, you can also start ABCL from within j by doing |
|---|
| 224 | Alt X, "slime". J's version of slime is adapted from the "Superior Lisp |
|---|
| 225 | Interaction Mode for Emacs", originally written by Eric Marsden, Luke Gorrie |
|---|
| 226 | and Helmut Eller. Slime-for-j is less than a month old, so it is nowhere near |
|---|
| 227 | as robust or featureful as slime-for-emacs, but in principle it offers more |
|---|
| 228 | functionality than Alt X, "abcl". In particular, the tab key can be used for |
|---|
| 229 | symbol completion, function argument lists are displayed in the status bar |
|---|
| 230 | when you type a space, and Alt . should work to find function definitions (if |
|---|
| 231 | you've built ABCL from source). In addition, the evaluation of forms and |
|---|
| 232 | regions in Lisp source files makes an attempt to set *PACKAGE* to the right |
|---|
| 233 | thing first. I don't think any of these features works 100% correctly yet, |
|---|
| 234 | but even so, slime-for-j feels like an improvement over the basic Lisp shell |
|---|
| 235 | functionality available in previous versions of j. For more information, see |
|---|
| 236 | slime.lisp. |
|---|
| 237 | <p> |
|---|
| 238 | More (and more timely) details about recent changes in j and ABCL are |
|---|
| 239 | available on the J Development Mailing List, the archives of which are |
|---|
| 240 | <a href="http://sourceforge.net/mailarchive/forum.php?forum_id=9737">here</a> |
|---|
| 241 | (or on |
|---|
| 242 | <a href="http://news.gmane.org/thread.php?group=gmane.editors.j.devel">Gmane</a>). |
|---|
| 243 | <p> |
|---|
| 244 | The complete change log (back to the beginning of time) is available |
|---|
| 245 | <a href="http://armedbear-j.sourceforge.net/changelog.html">here</a>. |
|---|
| 246 | </dd> |
|---|
| 247 | </dl> |
|---|
| 248 | <p> |
|---|
| 249 | <font face="sans-serif" size="4"> |
|---|
| 250 | <b>Installation</b> |
|---|
| 251 | </font> |
|---|
| 252 | <dl> |
|---|
| 253 | <dd> |
|---|
| 254 | Java 1.4 or later is required. Java 1.5 is recommended. |
|---|
| 255 | <p> |
|---|
| 256 | <a href="http://java.sun.com/j2se/1.5.0/download.jsp">Sun Java 1.5</a> or |
|---|
| 257 | <a href="http://www.blackdown.org/java-linux/java2-status/jdk1.4-status.html">Blackdown Java 1.4.2-01</a> |
|---|
| 258 | is recommended for Linux. |
|---|
| 259 | <p> |
|---|
| 260 | <a href="http://java.sun.com/j2se/1.5.0/download.jsp">Sun Java 1.5</a> is recommended for |
|---|
| 261 | Windows. |
|---|
| 262 | <p> |
|---|
| 263 | Simply untar or unzip the binary distribution, cd into the j-0.21.0 |
|---|
| 264 | directory, and run the jar file: |
|---|
| 265 | <pre> |
|---|
| 266 | $ tar xvfz j-0.21.0-binary.tar.gz |
|---|
| 267 | $ cd j-0.21.0 |
|---|
| 268 | $ java -jar j.jar</pre> |
|---|
| 269 | <p> |
|---|
| 270 | Or for Windows: |
|---|
| 271 | <pre> |
|---|
| 272 | C:\> unzip j-0.21.0-binary.zip |
|---|
| 273 | C:\> cd j-0.21.0 |
|---|
| 274 | C:\j-0.21.0> java -jar j.jar</pre> |
|---|
| 275 | </dd> |
|---|
| 276 | </dl> |
|---|
| 277 | <p> |
|---|
| 278 | <font face="sans-serif" size="4"> |
|---|
| 279 | <b>Building the Source</b> |
|---|
| 280 | </font> |
|---|
| 281 | <dl> |
|---|
| 282 | <dd> |
|---|
| 283 | Instructions are provided in the file |
|---|
| 284 | <a href="http://armedbear-j.sourceforge.net/doc/building.html">building.html</a> in the doc directory of the |
|---|
| 285 | distribution. </dd> |
|---|
| 286 | </dl> |
|---|
| 287 | <A href="http://sourceforge.net"> <IMG src="http://sourceforge.net/sflogo.php?group_id=55057" width="105" height="31" border="0" alt="SourceForge Logo" align="right"></A> |
|---|
| 288 | </body> </html> |
|---|
