As for Psi project, we in fact have some set of code style guidelines. But still sometimes we occasionally are looking at something that’s noticeably differs from our sense of perfection.

That’s where code beautifiers come into play.

Enter Artistic Style. Small, neat and cross-platform C, C++, C# and Java code beautifier.

Installing Artistic Style

UPDATE: As of astyle-1.20 release, building it on Mac OS X is simple with provided build/Makefile.

As there is Windows-binary available on the site and a Makefile is present in the source package, it doesn’t cleanly build itself on Mac OS X, because it doesn’t know about some of osx-specific compilation flags, so it just crashes on start. And here’s that flag, if you’re curious:

I have packaged both resulting Makefile and astyle.pro in one package.

Using Artistic Style

Pipe a file to the executable, or specify file name as the argument: result is the same — code is reformatted, and is either written to the stdout, or to the file. And it also dumps an advertisement to the stderr, so don’t forget to 2> /dev/null.

The following command line gives the result most closely resembling what we describe in the Psi Code Style Guidelines:

astyle --mode=c --indent=tab=4 --brackets=linux --brackets=break-closing --min-conditional-indent=0 --pad=oper --unpad=paren && echo ""

TextMate Command

And that’s not all! To reap all benefits without having to resort to fiddling with command line, I’ve prepared a super-special limited edition TextMate command. Grab it while it’s hot! Limited supply offer!

Long time, no posts, and truth to be said, I’ve been secretly working on Qt Bundle for TextMate all along, and now you can have your hands on it. Today I will discuss how to install it on your Mac. Description of what it actually does will follow, so explore it on your own and make suggestions.

Getting individual bundles together

As specified in official TextMate manual you can pull individual bundles from subversion repositories thought the world. In order to install Qt bundle, execute following commands:

mkdir -p /Library/Application\ Support/TextMate/Bundles
cd /Library/Application\ Support/TextMate/Bundles
svn co svn://dev.psi-im.org/mblsha/textmate/Qt.tmbundle

This way you’ll get only the bundles you want.

To update the bundle at a later time, create a simple shell script with these commands:

cd /Library/Application\ Support/TextMate/Bundles
svn up *.tmbundle
osascript -e 'tell application "TextMate" to reload bundles'

The more the merrier

If you absolutely want to have all the latest and greatest, you may opt to get all the bundles from TextMate’s repository, but be careful: there are so much, you’ll have to disable most of them by hand. This is simple.

mkdir -p /Library/Application\ Support/TextMate/
cd /Library/Application\ Support/TextMate/
svn --username anon --password anon co \ http://macromates.com/svn/Bundles/trunk/Bundles

Then you’ll have to add svn:extrenals property to Bundles directory in order to automatically update Qt bundle:

svn propset svn:externals 'Qt.tmbundle svn://dev.psi-im.org/mblsha/textmate/Qt.tmbundle' Bundles

But please be wary that if you already have some svn:externals set, you should use svn propedit command instead.

After this setup getting Qt bundle is just a simple matter of svn up Bundles.

Finishing touches

After initial check out you should perform a couple of small steps to enable quick documentation lookup:

1. Start Qt Assistant.
2. Open Index on the Sidebar and wait until the index is created.
3. Quit Qt Assistant.
4. Now the index is created and saved to disk.
5. Open Terminal and execute following commands:
   cd /Library/Application\ Support/TextMate/Bundles/Qt.tmbundle/Support/lib/assistant_search
qmake && make
6. Now Documentation for Word command will actually work.

What is Markdown? It’s yet another markup language for the web which has very nice syntax. With its help now I finally can read my blog’s posts’ text paragraphs with tons of links. Also, it’s possible to use a full power of HTML markup in Markdown — that’s very useful too. Now I like it even more than Textile.

Also, there’s SmartyPants — tool to enhance typography of web-published documents. Give it a try.

UPDATE: Just noticed a minor nuisance: if you’re using reference-style links, link labels for all links used prior to WordPress’ <!--more--> tag should also be placed prior that tag. By now I should’ve corrected all errors. BTW, because Markdown allows for seamless inclusion of HTML you don’t have to convert all old posts to Markdown format as I did — everything would just work.

If you’re interested how it looks like, here’s a screenshot of this post in TextMate. If you want a more complex example, look no further than Markdown’s Syntax in Markdown page by John Gruber himself.

If you’re using WordPress, there are plugins for both Markdown and SmartyPants: PHP Markdown and PHP SmartyPants. They’re easy and straightforward to install. There are also plugins for other blogging tools.

PS: I’m also interested in alternate markup solutions out there. How do you publish on the web?

Ночь шокирующих признаний:

ermine: так всё!
* ermine решил сегодня наконец честно признаться
geek: ermine: O_o
geek: ermine: я знал, я знал!
ermine: geek: да, я неудачно разыгрывал девушку…
geek: ermine: ну и как? разыграл? ;)
ermine: geek: теперь мне стыдно
geek: ermine: сильно?
ermine: стыдно за то, что обманывал надежды хороших холостых мужиков на приятные виды женитьбы на девушке-суперадминше
* ermine хряпнул четвертый стакан водки
geek: ладно. раз уж пошла такая пьянка
geek: на самом деле я не линуксоид. и гном терпеть не могу
geek: виндовс+кде наше фсио!
avzl: geek, то-то и оно (вспомнив твое высказывание про латентного вантузятника)
ermine: geek: давай сделаем сегодня день Раскаяния, брат?
geek: ermine: таффай
ermine: Бог любит дураков и не прощает лжецам
aleksey: буржуи странно шутят
aleksey: я с троими общаюсь в привате по поводу взлома j.r
geek: aleksey: фсбэшнеги?
aleksey: и не совсем понимаю поняли ли они шутку
ermine: aleksey: кто там еще ломает?! ведь только что отразили dos?
aleksey: ermine: попричитай в ejabberd@ про взлом :)

geek и mblsha против Dæstructor’а:

ermine: фря сюксб
geek: ermine: ляликс рулит?
ermine: geek: а хрен его знаит ,думаеш может рулить?
geek: ermine: не может. виндовс - наше фсио!
avzl: geek, латентный вантузятник - вот ты кто.
ermine: geek: боюс моя машинка не потянет виндовс
Dæstructor: geek: выньдовс - ось для выбивания бабок из юзера. linux - ось для того, чтоб ей пользовались.
geek: avzl: я и есть вантузятник. И вовсе не латентный
geek: херня ваш линукс
geek: кучу команд надо помнить
geek: а в виндовсе можно всё мышкой сделать
Dæstructor: geek: не нравятся команды - юзай gnome.
avzl: geek, и нефиг после этого Линуса обзывать классическим примером латентного вантузятника…
geek: Dæstructor: гном сакс. кде рулед
Dæstructor: geek: qt - сакс, dcop - сакс. => кде - сакс
geek: Dæstructor: qt - лучший тулкит в мире!
avzl: geek, угу, не случайно сегодня - день дурня…
geek: так сказал Тузег, а он очень умный!
Dæstructor: geek: qt - тормоз
avzl: geek, ты б еще Kes’а послушал…
geek: Dæstructor: gtk тормозит больше
Dæstructor: geek: дааа? А ты проверь сначала, прежде чем такое заявлять.
mblsha: version geek
sulci: mblsha: у geek клиент Gajim 0.10 - [unknown]
mblsha: [unknown] == WINDOWZEEEE!!!!
avzl: geek, новый GTK2 быстрее засчет Cairo (не путать с 2k).
geek: Dæstructor: проверял. Запусти gtkperf - и посмотри, как дико тормозит TextArea, когда больше 200 итераций add_text
Dæstructor: geek: хотя gtk2 и до cairo быстрее был.
geek: mblsha: uname -a
ntkernel localhost 5.2.0.0 #1 Sun Mar 12 02:18:28 MSK 2006 i686 Intel(R) Celeron(R) CPU 2.00GHz GenuineIntel EULA/Windows
geek: Dæstructor: c кайро вообще тормоз стал
Dæstructor: $ which gtkperf
which: no gtkperf in (/sbin:/bin:/usr/sbin:/usr/bin)
geek: Dæstructor: gtkperf.sf.net
geek: А qt работает почти так же быстро как и родные виджеты виндовса
geek: а виста воопще всех парвёт
avzl: geek, признайся честно, что ты сидишь под “позорным” линуксом, а версию скрываешь для того, чтобы про тебя бог знает что не подумали ))))))))))) Принимаю скриншоты как доказательства.
geek: avzl: я в виндовсе сижу!
mblsha: geek is using sexlinux 2006 professional editon!
geek: а скриншоты я выкладываю на www.microsoft.com
avzl: geek, тогда от модерства в linux@ и linux-talks@ можешь добровольно отказаться
avzl: geek, или сделай /ban на самого себя.
geek: avzl: а там на самом деле вантузятники тусуются. Просто мы маскируемся
Dæstructor: geek: vista винду похоронит.
avzl: Dæstructor, до тебя не дошло, что он придуривается? И день-то сегодня - подходящий…
geek: Dæstructor: виста похоронит линукс, бзд и все остальные “фофаны”
Dæstructor: geek: каким интересно образом? Учитывая то, что она после загрузки отжирает 700 метров памяти только на свою шкуру…
avzl: geek, BSD, кстати, УЖЕ сосет…
geek: Dæstructor: нет. это она просто своп в оперативку грузит. И за счет этого будет работать быстрее чем ХР. Веть любой дурак знает, что оперативка быстрее чем HDD
Dæstructor: geek: Ты не понимаешь смысла свопа.
Dæstructor: geek: понимал бы - ты б такое не сказал.
geek: Dæstructor: я всё понимаю. А вы со своими тормозящими фофанскими поделками так и будете всю жизнь сидеть без нормальных игрушек и MS ОФиса
mblsha: geek: кстати и то и то есть под Mac OS X
Dæstructor: geek: игрушек мне хватает, а MSOffice мне и даром не нужен (поскольку есть OOo2)
mblsha: geek: венда обречена!
Dæstructor: geek: Что ты понимаешь под нормальными игрушками?
Dæstructor: geek: А смысла свопа ты не понимаешь.
geek: Dæstructor: F.E.A.R
Dæstructor: geek: это не нормальная игрушка
mblsha: geek: а ты играл в игрушку F.U.D.? говорят что очень хорошая
geek: Dæstructor: а ещё последние тесты показали что VB.NET быстрее чем C
Dæstructor: geek: уж не мелкософт ли эти тесты проводил?
geek: Dæstructor: так что виста будет в два, нет - в пять раз быстрее чем XP потому что она на 90% написана на VB.NET
Dæstructor: geek: интерпретатор В ПРИНЦИПЕ не может быть быстрее компилятора.
geek: Dæstructor: нет, что ты. Независимые исследования
Dæstructor: geek: первоапрельская шутка, а не исследования. VB - интерпретируемый езыг. => быстро софт на нем не может работать по определению.
geek: Dæstructor: .NET - это не интерпретатор это компилятор в процессоро-независимый код, который может работать на любом процессоре. Поэтому виста будет работать везде
geek: мне знакомые хакиры уже обещали патч для запуска висты на КПК
Dæstructor: geek: процессорно-независимый код выполняется виртуальной машиной, а это тот же интерпретатор.
geek: правда на моём кпк мало оперативки, поэтому своп придется держать на флешке. Будет не так быстро работать, конечно…ну да ничего mblsha: geek: а правда что ут ебя ЗАУРУС?
Dæstructor: geek: я логи запощу в фидо, в RU.COMPUTER.HUMOR.
geek: Dæstructor: лучше в RU.WINDOWS
geek: Dæstructor: там ещё не знают о новых фичах висты
mblsha: Dæstructor: а на BOR кто постить будет? пушкин?
Bruce: я тута послушал вот хотел бы узнать а когда эта виста будет а то все говорят как будто уже она установленна
Dæstructor: Угу, чтоб в RU.WINDOWS все от смеха умерли
geek: Bruce: в ноябре будет. Но только для избранных
geek: mblsha: у меня ровер
geek: mblsha: а заурус - это что? там XP стоит?
mblsha: geek: мацось
mblsha: geek: вторая версия!
Dæstructor: geek: Sharp Zaurus - под линуксом.
geek: mblsha: ооо…мак это почти так же круто как виста
geek: Dæstructor: врешь ты всё. линукс жырный и в кпк не влезет
Bruce ушел (Replaced by new connection)
geek: сколько там ваш линукс занимает? 9 компакт-дисков? а вот виндовс на один влезает!
Dæstructor: geek: Ты дурак, либо очень хорошо притворяешься. Ядро легко упихать на дискету.
geek: Dæstructor: а что с этим ядром на дискете можно делать?
geek: Dæstructor: оно же ничего не умеет. Даже флешки не работают
Dæstructor: geek: Работают.
geek: и экран только черный с кучей непонятных буковок
zLon: geek, э-эх!
geek: а ещё в линуксе нет эксплорера
Dæstructor: geek: Маршрутизатор можно поднять. (если туда еще и busybox засунуть)
geek: Dæstructor: нефиг ронять маршрутизаторы - не придется и поднимать
Dæstructor: geek: Ты точно дурак. там браузеров больше, чем когда-либо было под винду написано.
geek: Dæstructor: угу. знаем. эти браузеры половину сайтов криво показывают
mblsha: Dæstructor: под линукс нет величайшего браузера всех вермен и народов — MOSAIC!
Dæstructor: geek: Приведи пример сайта, который Firefox 1.5 криво показывает.
geek: а модный нынче ajax кстати, в микрософте изобрели!
geek: Dæstructor: www.gay.ru
Dæstructor: geek: Нормально отображается.
mblsha: Dæstructor: а почему линуксом до сих пор никто не пользуется, раз он такой хороший?
* geek зопесал: Dæstructor посещает www.gay.ru
Dæstructor: version mblsha
sulci: Dæstructor: у mblsha клиент Psi 0.11-beta1 - Mac OS X
mblsha: Dæstructor: почему у каждой домохозяйки до сих пор стоит freebsd на роутере?
zLon: mblsha, МакОсь - BSD… А BSD - sux. Делаем выводы.
mblsha: zLon: какая BSD! там нет никакого BSD и в помине!
geek: zLon: ты что не знаешь? там ядро от виндовса
* Dæstructor зопейсал: англ. geek = лох
mblsha: Dæstructor: не лох а выродок
Dæstructor: mblsha: почти синонимы…
geek: zLon: ты ламир. Не знаешь, что Apple - подразделение микрософт, занимающееся перспективными разработками?
* geek .oO(кажется, я только что выдал коммерческую тайну)
zLon: geek, это ты - ламер-вантузятник…
Dæstructor: mblsha: Darwin сделан на основе ядра Mach, которое сделано на основе NeXTSTEP, который сделан на основе NetBSD.
mblsha: zLon: сам ты бимбо, пративный
geek: Dæstructor: бугога, повелся на дезу!
mblsha: Dæstructor: mach ни сделан ни на чьей основе! он един как и windows!
Dæstructor: Тьфу, попутал
geek: Dæstructor: mach - это микроядро NT!
Dæstructor: Darwin - помесь Mach и NeXTSTEP
mblsha: Dæstructor: NeXTSTEP была сотворена в темном сговоре IBM и MICROSOFT!!
Dæstructor: geek: Дурак. NT - монолитка, а не микроядро
Dæstructor: mblsha: NeXTSTEP был куплен Apple, а разработан таки на основе NetBSD
mblsha: Dæstructor: а NetBSD — это форк FreeBSD рожденный внутри IBM и КОРПОРАЦИИ МАЙКРОСОФТ
geek: Dæstructor: ничего подобного. Если б оно было монолитным - то драйвера от старых версий виндовс не подходи ли бы к новым. а так микроядро отдельно, HAL - отдельно и сверху драйвера
Dæstructor: mblsha: ты тоже дурак.
mblsha: с использованием технологии .NET
zLon: mblsha, идиот или прикидываешься?
mblsha: zLon: это наезд, да?
geek: zLon: ты что, не веришь старым профессионалам ?
zLon: mblsha, нет. Это истина.
Dæstructor: mblsha: FreeBSD появился значительно позже NetBSD
mblsha: zLon: а истина в том, что MICROSOFT всех купила!
zLon: geek, тебе - еретику и богохульнику - я точно не верю…
Dæstructor: mblsha: и разработан был в институте Беркли
mblsha: Dæstructor: они обкурились LSD и уже сами не помнят где что изобретали
Dæstructor: mblsha: А гейц сам винду не юзает.
mblsha: Dæstructor: гейц юзает микрокернель mach!
Dæstructor: mblsha: гейц юзает микрокернель Darwin. Он от mach ОООЧЕНЬ сильно отличается, хоть и потомок.
geek: Dæstructor: гейц давно уже юзает висту и говорит что это самая крутая ось в мире! А гейтс никогда не врёт!
mblsha: Dæstructor: да ладно? как он может отличаться?
Dæstructor: geek: ты имбецил в стадии дебильности.
geek: Dæstructor: справку напишешь? а то мне отпуск без справки не дадут

For a more complicated scenario: mblsha, Monster and mbl-revolution are all sitting in same room. If you write m and press Tab it will not result in any noticeable action. This is because there are multiple nicks that start with m, and you can either continue to Tab to loop through all nicks that start with m or write more letters until there is a unique completion. When you press the b button, and then press Tab it would complete to mbl. The more you use this feature, the more you are likely to come to like it and rely upon it. Try nick completion on someone and you’ll realise how powerful it is.

Enter the world of productive forum posting.

Probably many of you Mac OS X users out there ever heard of TextMate the text editor. But it’s most likely news to you, that it could be easily called from many native applications to edit their text. Safari is no exception — it’s possible to easily edit web forms in TextMate. You just have to enable “Edit in TextMate” input manager. Then it’s a simple matter of ⌃⌘E to load a forum post you’re editing in TextMate. Modify the post, ⌘S, ⌘W, voila! Updated post is shown in Safari’s edit field.

But probably this much integration is still not enough for truly productive post editing. Syntax highligting for BBCode and text completion are lacking.

I was frustrated enough that there were no public BBCode-bundles around, so I created it on my own. Download BBCode.tmbundle.

The bundle features two language syntaxes: BBCode and BBCode (Unclassified). The first one is generic version (suitable for PhpBB2), and the second one is recommended for use when editing posts in Unclassified NewsBoard, since it’s a bit incompatible in some places.

Also there are snippets provided for all most common tags, open Bundle Editor to explore them all.

The ones who have already tried Psi/Mac 0.11-beta1 probably noticed the sudden appearance of many little bothersome icons in all kinds of menus where they weren’t present in 0.10: icons in context menu, application menus and even in the menu bar itself! So it was decided that icons should not be able to live any longer.

With the help from kind engineers from Trolltech I discovered very handy one-liner that disables icons in the menu bar. I’m currently in a good mood so I will share it with you:

#ifdef Q_WS_MAC  
        qt_mac_set_menubar_icons(false);  
#endif

And the other half of the work — disabling icons in menus that are drawn by Qt — was done in a matter of minutes though overriding QMacStyle with my custom class.

And here is the sample screenshot from the running application:

Popup menus never looked this good before ;)

And the greatest feature of all: on my small desktop I can put my mouse under the PowerBook, and iCurve would work like palm rest area. Really cool, and saves precious space. Next thing I want on my table is one of these beauties. But for now I guess I’ll stick to my old and trusty monitor and diNovo keyboard. My productivity should be skyrocketed to the sky now.

P.S.: Big thanks to Remko for recommending this awesome thing.

So what’s so new and exciting? Well, several things, and I’m going to list all of them here:

1. Ctrl-C and Ctrl-Ins shortcuts used to copy text are now more intelligent: if you have selected some text in chat log, and no text is selected in chat edit, and focus is in chat edit widget, these shortcuts will select the text from chat view. Sounds a bit complicated, but in reality probably you will start to use Ctrl-C shortcut more often.
2. When you select a region of text, emotions are also correctly selected, as shown on provided screenshot.
3. Selection is not lost when new text is appended to chat log. Very useful in Groupchats.
4. Also finally emoticons are copied correctly when you you issue Copy command. No more empty space instead of copying emoticon’s text.
5. Quite minor, but could also be useful: in Groupchat dialog there’s a handy nick completion, and now Undo command behaves correctly after you try to complete nick.

P.S.: And in case you’re wondering: no, it’s not Mac OS X shown on above screenshot. It’s actually Linux with custom window theme and unimpressive fonts. Emoticon package is called puzazBox.

Why can’t you just simply gain access to all private instance and class variables and methods? Because compiler sees the private directive and restricts you. Well, it’s even very hard to get access to protected variables of an instance even if you create a subclass. But what if these nasty restricting directives weren’t there, so there would be nothing to complain about?

#define private public

Would it work? It seems so, because class data structure is arranged together, and access specifiers are not stored anywhere, and check is performed only during compile time.

How to use this technique? Plain simple, but it should always be considered only as last resort when no other solution works for you and you absolutely must gain access to that private instance variable. Recently I met a case that was nearly impossible to solve without using this dirty hack: I needed to create a QTextDocumentFragment from QTextCursor’s current selection. And guess what? It’s not possible to get hold of QTextDocumentFragment’s data structures (namely, QTextDocument of selected fragment itself, to iterate through its QTextFragments) in Qt 4.1.0! Very disappointing when you want to implement useful feature. So, here’s how I actually worked around it:

#define private public
#include <QTextDocumentFragment>
#undef private

And yes, this should be done at the very top of source file, to make sure that useful header wasn’t already #included somewhere.