Skip to content

Commit

Permalink
Improve and update windows text in INSTALL.md
Browse files Browse the repository at this point in the history
  • Loading branch information
ChrisJefferson committed Jan 18, 2024
1 parent e94438a commit a6db6a5
Showing 1 changed file with 14 additions and 15 deletions.
29 changes: 14 additions & 15 deletions INSTALL.md
Original file line number Diff line number Diff line change
Expand Up @@ -558,28 +558,27 @@ This is a problem if you are running a keyboard driver for some non-english
languages. These drivers catch the ^ character to produce the French circumflex
accent and do not pass it properly to GAP. For macOS users, as a workaround
please refer to the section "GAP for macOS" below for information on
how to install readline and section 5 on how to recompile GAP, for windows no
how to install readline and section 5 on how to recompile GAP, for Windows no
fix is known. (One can type `POW(a,b)` for `a^b`.)

## Problems specific to Windows

### Cut and Paste does not work
The best way to use GAP in Windows is to use the "Windows Subsystem for Linux"
( https://learn.microsoft.com/en-us/windows/wsl/install ), also known as WSL.
This can be found in the "Microsoft Store" in Windows, and allows you to install
a full copy of Ubuntu. You can then follow the guidance for building and using
GAP in Linux inside WSL.

You might want to try different shells, using both of the two `.bat`
files in the `bin` directory: `gap.bat` and `gapcmd.bat`. Also,
<https://www.gap-system.org/Faq/faq.html#4> might give a remedy.
We also support building GAP using 'Cygwin', which is a UNIX wrapper for
Windows. Cygwin is used for making Windows release. Almost all packages are
supported in the Windows releases.

### GAP does not work in the remote desktop
By default the Windows release reads and writes files from the user's
"Documents" directory.

GAP cannot be started in the Windows Command Prompt shell (via `gapcmd.bat`)
in the remote desktop. To start GAP in the remote desktop, use the script
`gap.bat` which should work in such setting.

### You get an error message about the `cygwin1.dll`

GAP comes with a version of this dynamic library. If you have another
version installed (use "Find"), delete the older one (and probably copy the
newer one in both places).
The Windows release can be installed globally for all users, or just for the
current user. This is the best way to install GAP on a machine where you do
not have administrator access.

### Something else went wrong

Expand Down

0 comments on commit a6db6a5

Please sign in to comment.