Improve documentation on urxvt #121

Closed
fedemp opened this Issue Jan 24, 2013 · 2 comments

3 participants

@fedemp

Update: There is a mention on Font patching. Maybe add a link to it in the installation section. 😄

Update 2: urxvt is compiled with unicode3 in ubuntu but even so unpatched fonts won't work with it.

rxvt-unicode does not seem to honour fontconfig configurations so normal (unpatched) fonts do not use powerlinesymbols as fallback. See screenshot using regular Ubuntu Mono on the left.

urxvt

Patched fonts (such as those from https://github.com/Lokaltog/powerline-fonts) work as expected.

My proposal is to update documentation to include an explanation on how urxvt is an expection and that patched fonts are needed. This would prevent users' frustation while trying to make new powerline work with rxvt. This seem to also apply to xterm.

Note: This is not only my case. See also Fontconfig fallback fonts are not used on a rxvt mailing list and Applications without fontconfig support.

@Lokaltog
Powerline member

Allright, I'll make this even clearer in the docs. I think the docs have to be restructured a bit too, since it seems that almost every terminal emulator has implemented its own way of handling fonts and the unicode Private Use Area.

@Lokaltog Lokaltog added a commit that closed this issue Jan 24, 2013
@Lokaltog Lokaltog Restructure and improve installation docs
The installation docs have been split into separate guides for OS X and
Linux, with OS-specific troubleshooting as part of the installation
guide.

Terminal emulator support tables have been added to both guides.

Closes #121.
6ac9f0d
@Lokaltog Lokaltog closed this in 6ac9f0d Jan 24, 2013
@vincentbernat

Another note about uxrvt. I have observed that when patching "DejaVu Sans Mono", the resulting font does not have a good hinting. To avoid this, I have used the new font as a fallback of the regular font.

URxvt.font: xft:DejaVu Sans Mono-8,xft:DejaVu Sans Mono for Powerline-8

To decrease memory usage, I have also removed most glyphs from the patched font. Only some glyphs are left to allow urxvt to do boxsize computation:

      # Remove most glyphs
      for glyph in target_font.glyphs():
              if glyph.unicode not in range(32,64):
                      target_font.removeGlyph(glyph)

Maybe this could be added as an option of the patcher script?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment