Skip to content

Commit

Permalink
Update copyright dates, add section to Help for popup windows.
Browse files Browse the repository at this point in the history
  • Loading branch information
jjjordan committed Mar 8, 2016
1 parent 974922c commit 486272a
Show file tree
Hide file tree
Showing 2 changed files with 42 additions and 14 deletions.
54 changes: 41 additions & 13 deletions docs/windows.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,19 +12,6 @@ in the editor) to copy into/paste from the Windows clipboard.
You can drag files from Windows explorer onto JOE, and it will open those
files.

### Shell windows

Shell windows work, but with some limitations. Programs that interact
directly with the console interface (e.g., PowerShell) do not work and will
appear to hang when run. You may be able to stop them by moving the cursor
away from the end of file and pressing ^C to terminate. If that doesn't
work, try task manager.

Some programs can be made to work, for example Python will behave if given
the "-i" switch. The shell windows interact with applications similarly to
the way that mintty does. If there is a workaround for mintty, it will
likely work for JOE.

### Appearance

JOE for Windows comes with several builtin color schemes, which are more
Expand All @@ -37,6 +24,47 @@ be changed there.
You can toggle fullscreen mode with Alt-Enter to relive the old days. Even
better, find a CP437 font!

### Pop-up terminals

JOE 4.0 introduced pop-up virtual terminals accessible via the `F1`-`F4` keys.
These terminals are improved over the previous type (which were invoked with
`^K '`) in that they interpret ANSI codes and can update any part of the
screen. This is (partially) supported in the Windows version with the help
of [winpty](https://github.com/rprichard/winpty) (by Ryan Prichard).

By default, the standard Windows command interpreter (`cmd`) is loaded when you
start a new virtual terminal, but this is configurable by modifying the
`vt.bat` script. It can be made to run Powershell or Cygwin out-of-the-box, or
another shell with a little modification. Powershell and `cmd` both require
winpty (which screen-scrapes a hidden console), whereas Cygwin can be used
more <i>directly</i> through a pseudo terminal with the help of the `socat`
package. (`socat` does not come installed by default on Cygwin, so if you plan
to use it you should install it.)

Generally, you should copy the `vt` directory to your local user directory and
modify `vt.bat` to choose your shell (instructions can be found at the top of
that file).

xcopy /S /I "C:\Program Files (x86)\JoeEditor\vt" "%LOCALAPPDATA%\JoeEditor\vt"
joe "%LOCALAPPDATA%"\JoeEditor\vt\vt.bat

There is currently a bug in winpty that does not propagate `^C` to some programs
(most notably, the shell). Attempts to fix this delayed a couple of releases,
so as of now it is currently broken. This, however, does not apply to Cygwin.

### Old-style shell windows

Shell windows made with `^K '` work, but with some limitations. Programs that
interact directly with the console interface (e.g., PowerShell) do not work
and will appear to hang when run. You may be able to stop them by moving the
cursor away from the end of file and pressing ^C to terminate. If that doesn't
work, try task manager.

Some programs can be made to work, for example Python will behave if given
the "-i" switch. The shell windows interact with applications similarly to
the way that mintty does. If there is a workaround for mintty, it will
likely work for JOE.

### File locations

JOE for Windows uses a different (but similar) file layout than JOE for
Expand Down
2 changes: 1 addition & 1 deletion windows/src/build/version.py
Original file line number Diff line number Diff line change
Expand Up @@ -82,7 +82,7 @@ def main(version, outfile_h, outfile_wxi, designation):
#define JW_VERSION_STR """ + "\"" + '.'.join(vparts) + """\"
#define JW_VERSION_DESC """ + "\"" + desc + """\"
#define JW_COPYRIGHT \"""" + ("Copyright \\xa9 %d John J. Jordan, and others (see About...)" % (year)) + """\"
#define JW_COPYRIGHT \"""" + ("Copyright \\xa9 2015-%d John J. Jordan, and others (see About...)" % (year)) + """\"
#define JW_SHORTVERSION \"""" + version + """\"
Expand Down

0 comments on commit 486272a

Please sign in to comment.