Difference between revisions of "Yi/FAQ"

From HaskellWiki
< Yi
Jump to navigation Jump to search
(15 intermediate revisions by 10 users not shown)
Line 1: Line 1:
−
== Installation ==
 +
=== Installation ===
   
 
*How do I install Yi?
  
*How do I install Yi?
 
:get it from Hackage. Configure, compile and install Yi as you would do for any other Cabal package.
  
:get it from Hackage. Configure, compile and install Yi as you would do for any other Cabal package.
−  
−
*Setup.hs does not compile!
  
−
:You need to use Cabal version 1.2.3. To make sure you use it, do:
  
−  
−
ghc -package Cabal-1.2.3.0 --make Setup.hs
  
−
./Setup configure ...
  
   
 
*Setup configure fails with
 
*Setup configure fails with
−
"Setup.hs: Package yi-0.3 can't be built on this system."
 +
Setup.hs: Package yi-0.4 can't be built on this system.
 
:It means that you have no UI package available. You need VTY or GTK2hs installed. Get them from Hackage.
  
:It means that you have no UI package available. You need VTY or GTK2hs installed. Get them from Hackage.
   
  +
*cabal install yi fails with dependency errors, eg:
  +
$ cabal install yi
  +
Resolving dependencies...
  +
cabal.exe: dependencies conflict: ghc-6.8.3 requires bytestring ==0.9.0.1.1
  +
however
  +
bytestring-0.9.0.1.1 was excluded because bytestring-0.9.0.1 was selected
  +
instead
  +
bytestring-0.9.0.1.1 was excluded because yi-0.3 requires bytestring =0.9.0.1
  +
:Try removing all your old yi packages, and do
  +
cabal update
  +
before attempting to install.
  +
  +
*cabal install -fghcAPI fails
  +
:If you want GHC API special capabilities, you have to download, configure, build and copy separately:
  +
cd yi
  +
cabal configure -fghcAPI
  +
cabal build
  +
cabal copy
  +
  +
* Compilation fails with a message about <tt>alex</tt> not being available?
  +
: Currently, Cabal doesn't track programs, just libraries, so it won't warn you if you are missing Alex (as many people are). The solution here is to just <tt>cabal install alex</tt> first. (Yi uses Alex to generate code for parsing stuff with syntax, like Haskell source.)
  +
  +
* I can't install <tt>yi-gtk</tt> or <tt>yi-vty</tt>! It wants <tt>sourceview</tt> or something.
  +
: As the Hackage descriptions say, yi-gtk and yi-vty are ''only'' for versions of older than Yi 0.3. You really should be running the latest development (Darcs) or stable (Hackage) versions of Yi, so ''don't'' try to install these two packages. Yi supports VTY and Gtk2hs directly in the <tt>yi</tt> package now.
 
*On Mac OS X if you get an error message similar to this:
  
*On Mac OS X if you get an error message similar to this:
 
yi: can't load .so/.DLL for: gthread-2.0 (dlopen(libgthread-2.0.dylib, 10): image not found)
  
yi: can't load .so/.DLL for: gthread-2.0 (dlopen(libgthread-2.0.dylib, 10): image not found)
Line 23: Line 41:
 
:(Adjust the specific path to your system. You can find the right location using <tt>locate libgthread</tt>)
  
:(Adjust the specific path to your system. You can find the right location using <tt>locate libgthread</tt>)
   
  +
*On Mac OS 10.6 (Snow Leopard) if you get the following error:
−
*ByteString problems: Yi as of 27 January 2008 cannot use the most recent ByteString library (because of the regexp libraries) which is 0.9.0.4 - it needs a version like 0.9 or 0.9.0.1. You may have the correct ByteString library installed, but still see an error like:
  
  +
Loading package cairo-0.11.1 ... <command line>: can't load .so/.DLL for: pixman-1 (dlopen(/opt/local/lib/libpixman-1.dylib, 9): no suitable image found. Did find:
  +
/opt/local/lib/libpixman-1.dylib: mach-o, but wrong architecture)
  +
cabal: Error: some packages failed to install:
  +
yi-0.6.2.4 failed during the building phase. The exception was:
  +
ExitFailure 1
  +
  +
:then the problem is that GHC currently only supports linking against i386 libraries, and your ports are compiled for x86_64. To fix, recompile your ports with the +universal variant like so:
  +
  +
port install installed +universal
  +
  +
* Compilation fails with errors about template-haskell or data-accessor:
  +
Add constraints about which release of those libraries to use.
  +
$ cabal install yi --constraint="data-accessor < 0.2.1" --constraint="template-haskell < 2.4"
  +
  +
  +
=== Default key bindings ===
  +
  +
==== CUA key bindings ====
  +
  +
===== File operations =====
  +
{|
  +
| Ctrl-o
  +
| Open file.
  +
|-
  +
| Ctrl-s
  +
| Save the current file.
  +
|-
  +
| Ctrl-q
  +
| Quit the editor.
  +
|}
  +
  +
===== Cursor/selection movement =====
  +
{|
  +
| &rarr;
  +
| Move cursor forward one character.
  +
|-
  +
| &larr;
  +
| Move cursor back one character.
  +
|-
  +
| &darr;
  +
| Move cursor down one line.
  +
|-
  +
| &uarr;
  +
| Move cursor down one line.
  +
|-
  +
| Shift+&rarr;
  +
| Extend selection forward one character.
  +
|-
  +
| Shift+&larr;
  +
| Extend selection back one character.
  +
|-
  +
| Shift+&darr;
  +
| Extend selection down one line.
  +
|-
  +
| Shift+&uarr;
  +
| Extend selection up one line.
  +
|-
  +
| Ctrl-&rarr;
  +
| Move cursor forward one word.
  +
|-
  +
| Ctrl-&larr;
  +
| Move cursor back one word.
  +
|-
  +
| Home
  +
| Move cursor to beginning of line.
  +
|-
  +
| End
  +
| Move cursor to end of line.
  +
|-
  +
| Ctrl-Home
  +
| Move cursor to beginning of document.
  +
|-
  +
| Ctrl-End
  +
| Move cursor to end of document.
  +
|}
  +
  +
===== Miscellaneous operations =====
  +
  +
{|
  +
| Ctrl-f
  +
| Incremental search.
  +
|-
  +
| Ctrl-x
  +
| Cut the selected area and save it to the clipboard
  +
|-
  +
| Ctrl-c
  +
| Copy the selected area to the clipboard
  +
|-
  +
| Ctrl-v
  +
| Paste contents of clipboard at cursor.
  +
|-
  +
| Ctrl-z
  +
| Undo last operation.
  +
|-
  +
| Ctrl-y
  +
| Redo last operation.
  +
|}
  +
  +
==== Vim key bindings ====
  +
==== Emacs key bindings ====
  +
  +
=== Development ===
  +
  +
*How do I install Yi for development?
  +
:Fork the repository on GitHub, then clone your version to your machine. Push to your repo on GitHub, and then make merge requests.
  +
  +
*What are some of the dependancies?
  +
:There is a rather long list of dependencies for Yi, check the yi.cabal file for a list.
  +
  +
::If you are on Mac OS X and are using MacPorts, then these will not be included in the GHC in that distribution. Many of the dependancies are in MacPorts (for example: ghc, ghc-devel, alex, and gtk2hs). However, you may have some trouble building with Cabal-1.5.2, since it is a development version of Cabal. To work around these issues, you might have to add the line "Build-Type: Simple" to the .cabal files in the above required packages.
  +
  +
=== Configuration ===
  +
  +
==== How to Configure Yi ====
   
  +
You can find configuration file examples in the 'examples/' directory, or online at [http://code.haskell.org/yi/examples/ http://code.haskell.org/yi/examples/].
−
<blockquote>Yi/UI/Vty.hs:342:48:<br>
  
−
Couldn't match expected type<br> `bytestring-0.9.0.4:Data.ByteString.Internal.ByteString'<br>
  
−
against inferred type `B.ByteString'<br>
  
−
In the second argument of `renderBS', namely `(B.pack str)'<br>
  
−
In the expression: renderBS (styleToAttr sty) (B.pack str)<br>
  
−
In the definition of `withStyle':<br>
  
−
withStyle sty str = renderBS (styleToAttr sty) (B.pack str)</blockquote>
  
   
  +
A good way to start is to copy yi.hs in your ~/.yi directory (create it if needed), and hack as needed.
−
:This is because versions of ByteString often aren't compatible, and in this case, the VTY library was compiled with a different version.
  
  +
=== Usage ===
  +
==== GError on startup ====
  +
I get the error message "yi.exe: <<System.Glib.GError.GError>>" when I try to run yi.
   
  +
Sometimes this is a result of yi not being able to find the contents of the art directory when trying to start in graphical mode (e.g. Gtk or Pango). Check that the install has be done correctly or use the VTY mode (<tt>$ yi -f vty</tt>).
−
*I get "No instance for (RegexLike Regex B.ByteString)"
  
−
:It *could* be that the regex-instance in your ByteString package, there is only an instance for the newer regex-package. That is, your newly installed regex-posix-0.72.0.2 doesn't "see" the ByteString instance, because it was only defined for the regex-posix-0.93.1 package that ByteString knew about when it was built. This is yet another aspect of a known, tricky Cabal bug.
  
   
  +
For more detail on the error, modify main in Yi/Main.hs to catch GError:
−
== Configuration ==
  
  +
<pre>
  +
Right finalCfg -> do catchGError (do
  +
when (debugMode finalCfg) $ initDebug ".yi.dbg"
  +
startEditor finalCfg state) (\(GError dom code msg) -> fail msg)
  +
</pre>
   
  +
Note that more recent versions of Yi (e.g. from the darcs repo) no longer simply display the anonymous GError but instead provide a more detailed error message (making the above code snippet unnecessary).
−
== Usage ==
  

Revision as of 16:34, 7 August 2012

Installation

  • How do I install Yi?
get it from Hackage. Configure, compile and install Yi as you would do for any other Cabal package.
  • Setup configure fails with
Setup.hs: Package yi-0.4 can't be built on this system.
It means that you have no UI package available. You need VTY or GTK2hs installed. Get them from Hackage.
  • cabal install yi fails with dependency errors, eg:
$ cabal install yi
Resolving dependencies...
cabal.exe: dependencies conflict: ghc-6.8.3 requires bytestring ==0.9.0.1.1
however
bytestring-0.9.0.1.1 was excluded because bytestring-0.9.0.1 was selected
instead
bytestring-0.9.0.1.1 was excluded because yi-0.3 requires bytestring =0.9.0.1
Try removing all your old yi packages, and do
cabal update

before attempting to install.

  • cabal install -fghcAPI fails
If you want GHC API special capabilities, you have to download, configure, build and copy separately:
cd yi
cabal configure -fghcAPI
cabal build
cabal copy
  • Compilation fails with a message about alex not being available?
Currently, Cabal doesn't track programs, just libraries, so it won't warn you if you are missing Alex (as many people are). The solution here is to just cabal install alex first. (Yi uses Alex to generate code for parsing stuff with syntax, like Haskell source.)
  • I can't install yi-gtk or yi-vty! It wants sourceview or something.
As the Hackage descriptions say, yi-gtk and yi-vty are only for versions of older than Yi 0.3. You really should be running the latest development (Darcs) or stable (Hackage) versions of Yi, so don't try to install these two packages. Yi supports VTY and Gtk2hs directly in the yi package now.
  • On Mac OS X if you get an error message similar to this:
yi: can't load .so/.DLL for: gthread-2.0 (dlopen(libgthread-2.0.dylib, 10): image not found)
then your dynamic library search path variable is probably not set correctly. You can set it (in Bash) using:
export DYLD_LIBRARY_PATH=/opt/local/lib
(Adjust the specific path to your system. You can find the right location using locate libgthread)
  • On Mac OS 10.6 (Snow Leopard) if you get the following error:
 Loading package cairo-0.11.1 ... <command line>: can't load .so/.DLL for: pixman-1 (dlopen(/opt/local/lib/libpixman-1.dylib, 9): no suitable image found.  Did find:
       /opt/local/lib/libpixman-1.dylib: mach-o, but wrong architecture)
 cabal: Error: some packages failed to install:
 yi-0.6.2.4 failed during the building phase. The exception was:
 ExitFailure 1
then the problem is that GHC currently only supports linking against i386 libraries, and your ports are compiled for x86_64. To fix, recompile your ports with the +universal variant like so:
 port install installed +universal
  • Compilation fails with errors about template-haskell or data-accessor:

Add constraints about which release of those libraries to use. 

 $ cabal install yi --constraint="data-accessor < 0.2.1" --constraint="template-haskell < 2.4"


Default key bindings

CUA key bindings

File operations
Ctrl-o Open file.
Ctrl-s Save the current file.
Ctrl-q Quit the editor.
Cursor/selection movement
→ Move cursor forward one character.
← Move cursor back one character.
↓ Move cursor down one line.
↑ Move cursor down one line.
Shift+→ Extend selection forward one character.
Shift+← Extend selection back one character.
Shift+↓ Extend selection down one line.
Shift+↑ Extend selection up one line.
Ctrl-→ Move cursor forward one word.
Ctrl-← Move cursor back one word.
Home Move cursor to beginning of line.
End Move cursor to end of line.
Ctrl-Home Move cursor to beginning of document.
Ctrl-End Move cursor to end of document.
Miscellaneous operations
Ctrl-f Incremental search.
Ctrl-x Cut the selected area and save it to the clipboard
Ctrl-c Copy the selected area to the clipboard
Ctrl-v Paste contents of clipboard at cursor.
Ctrl-z Undo last operation.
Ctrl-y Redo last operation.

Vim key bindings

Emacs key bindings

Development

  • How do I install Yi for development?
Fork the repository on GitHub, then clone your version to your machine. Push to your repo on GitHub, and then make merge requests.
  • What are some of the dependancies?
There is a rather long list of dependencies for Yi, check the yi.cabal file for a list.
If you are on Mac OS X and are using MacPorts, then these will not be included in the GHC in that distribution. Many of the dependancies are in MacPorts (for example: ghc, ghc-devel, alex, and gtk2hs). However, you may have some trouble building with Cabal-1.5.2, since it is a development version of Cabal. To work around these issues, you might have to add the line "Build-Type: Simple" to the .cabal files in the above required packages.

Configuration

How to Configure Yi

You can find configuration file examples in the 'examples/' directory, or online at http://code.haskell.org/yi/examples/.

A good way to start is to copy yi.hs in your ~/.yi directory (create it if needed), and hack as needed.

Usage

GError on startup

I get the error message "yi.exe: <<System.Glib.GError.GError>>" when I try to run yi.

Sometimes this is a result of yi not being able to find the contents of the art directory when trying to start in graphical mode (e.g. Gtk or Pango). Check that the install has be done correctly or use the VTY mode ($ yi -f vty).

For more detail on the error, modify main in Yi/Main.hs to catch GError: 

 Right finalCfg -> do catchGError (do
                                   when (debugMode finalCfg) $ initDebug ".yi.dbg" 
                                   startEditor finalCfg state) (\(GError dom code msg) -> fail msg)

Note that more recent versions of Yi (e.g. from the darcs repo) no longer simply display the anonymous GError but instead provide a more detailed error message (making the above code snippet unnecessary).

Retrieved from "https://wiki.haskell.org/index.php?title=Yi/FAQ&oldid=48020"