If you have been coding C or Java in Emacs you probably already know about flymake which basically sends your buffer through a compiler and highlight the warning and errors.

The JDE documentation describes how to use the eclipse compiler (ECJ) to do just that with java files, but here is a few tricks to make it even more useful.

Tweaking ECJ options

There are some tweak you can do the ECJ configuration which can help you with two issues:

First, the default configuration would compile your buffer in a temporary directory and then forget about it. This is fine when working on just one file, but if your working on a project then you would be interested on how the changes you are making might effect other files. To do that you would have to give ECJ an output directory for the compiled classes which would be on top of you classpath.

Second, you can customize the warnings from ECJ with some flags.

To find what options are available, run ECJ from the command line:

java -cp /path/to/ecj.jar org.eclipse.jdt.internal.compiler.batch.Main -?
java -cp /path/to/ecj.jar org.eclipse.jdt.internal.compiler.batch.Main -?:warn

In Emacs, the options passed to ECJ can be customized using the jde-ecj-command-line-args variable.

For example i use something like the following in my project prj.el file:

'(jde-global-classpath (quote ("/my/project/flymake-build" "rest of the class path ...")))
'(jde-ecj-command-line-args '("-d" "/my/project/flymake-build" "-1.5" "-referenceInfo" "-enableJavadoc" "-warn:+over-ann,uselessTypeCheck,javadoc"))

Integrating flymake with other tools

Now you would say that IDEs don’t just perform syntax check (although here ECJ have some style checks as well), so what if you wanted to use an additonal tool for code style analysis?

Flymake itself is very simple, all it does is call a program and parse its output, so it doesn’t matter if that program is a compiler, a style checker, a spell checker, or a script that would launch all of the above …

For example, there is a small bash script that call both ECJ and CheckStyle (named java-check.sh)

#!/bin/bash
# Call ECJ compiler and CheckStyle
if [[ ! "$6" ]]; then
    echo "Missing some arguments."
    exit 1
fi
CLASSPATH="$1" #project classpath used for compilation, taken from jde classpath setting
ECJ_JAR="$2"
ECJ_OPTS="$3" #the customization we talked about earlier
CHECKSTYLE_JAR="$4"
CHECKSTYLE_CONFIG="$5" #this would at least contains -c /path/to/checks.xml with configures the checks to perform
TARGET="$6"
java -cp "${ECJ_JAR}:${CLASSPATH}" org.eclipse.jdt.internal.compiler.batch.Main -Xemacs ${ECJ_OPTS} ${TARGET} 2>&1 | awk '/:[0-9]+:/ {$3 = "ECJ: "$3;print}'
java -cp "${CLASSPATH}" -jar ${CHECKSTYLE_JAR} ${CHECKSTYLE_CONFIG} ${TARGET} | awk '/:[0-9]+:/ {$2 = "warning: CheckStyle: "$2 ; print}' | sed -e 's/:\([0-9]\+\):[0-9]\+:/:\1:/g'

The arguments will be passed by flymake later on, the awk scripts are mainly to make CheckStyle messages warnings instead of errors, and to add ECJ or CheckStyle tags in the messages so that you can know from which tool the warnings come from.

Now all we need to do is to call it from Emacs with the right arguments:

; for jde integration with ecj and flymake
(require 'jde-eclipse-compiler-server)
(require 'flymake)

;; flymake for java checkstyle
(defun flymake-java-ecj-checkstyle-init ()
  "Use ECJ and then CheckStyle to check the current java file."
  (if (not (object-of-class-p (jde-compile-get-the-compiler) 'jde-compile-ejc-server))
      (error "The ecj option for flymake can only be set when the jde-compiler is also set to ecj")
    (let* ((temp-file   (flymake-init-create-temp-buffer-copy
                         'jde-ecj-create-temp-file))
           (local-file  (file-relative-name
                         temp-file
                         (file-name-directory buffer-file-name))))
    (list "java-check.sh" (append
                                 ; jde classpath
                                 (cdr (jde-compile-classpath-arg (jde-compile-get-the-compiler)))
                                 ; ecj jar file
                                 (list
                                  (oref (jde-compile-get-ejc) path)
                                 ; all ecj options in one string
                                  (reduce #'(lambda (x y) (concatenate 'string x " " y)) jde-ecj-command-line-args)
                                 ; checkstyle jar
                                  "/path/to/checkstyle.jar"
                                 ; checkstyle options
                                  "-c /path/to/checks.xml"
                                 ; target
                                  local-file))))))

(add-to-list 'flymake-allowed-file-name-masks '("\\.java\\'" flymake-java-ecj-checkstyle-init))

The last line activates the custom checker for all .java files.

Note: here is a bug in CheckStyle regarding exceptions checks where it would throw a RuntimeError and stop process the file. Be sure to disable the RedundantThrows check in the checks.xml you are using.

Using flymake with BSH scripts

If you are working with BeanShell scripts you may have found that even the popular IDEs do not provide much in that area. It is actually very difficult to spot runtime errors in advance since you would use variables assigned in a servlet context.

There is however a basic syntax check that can be done:

;; flymake for BSH scripts
(require 'flymake)

(defun flymake-bsh-init ()
  "Use BSH to check the syntax of the current file."
  (let* ((temp (flymake-init-create-temp-buffer-copy 'flymake-create-temp-inplace))
     (local (file-relative-name temp (file-name-directory buffer-file-name))))
    (list "bsh-check.sh"
            (list local ))))

(add-to-list 'flymake-err-line-patterns
  '("^Exception in thread \"main\" In file: <\\(.*\\)> \\(.*\\) at line \\([0-9]+\\), column \\([0-9]+\\)" nil 3 2))

(add-to-list 'flymake-allowed-file-name-masks '("\\.bsh\\'" flymake-bsh-init))

And the bash script (named bsh-check.sh):

#!/bin/sh
java -cp /home/jeremy/programmation/opentaps-1.0-autocomplete-branch/framework/base/lib/scripting/bsh-2.0b4.jar bsh.Parser "$1" 2>&1 | head -n 1

Note that it is indeed basic and does not spot wrong class names or wrong method names but only syntax issues such as missing closing quotes or brackets …

After a few hours struggling with parenthesises, I finally managed to patch weblogger.el and xml-rpc.el to have those critical missing functionalities.

Now the default is to post as “Draft” when i use C-c C-n or C-c C-p so i can just prepare some text and save it for later. Changing publish state should be done explicitly with C-x C-s which calls the weblogger-publish-entry function, for not changing it C-c C-c.
Note that i said changing the published state, because at least on WordPress it switches from Draft to Published but also from Published to Draft with C-x C-s … i am unsure about the behaviour of other APIs.

I will have to do some work on this latter this week end …

Most importantly is the support for categories. It now display the categories in the header as “Keywords:” which you can set to one or many as a “, ” separated list. For example this post is “Keywords: Emacs, intarweb”.
The only thing i don’t see how to implement right now is auto-completion for the category names. Perhaps an emacs guru could have a look …

Another *minor* issue is that the API doesn’t provide any way to create new categories, which means that i *will* have to go on that slow web interface just for that. But how often do i need to change my categories anyway ?

Finally, on the would-be-nice list are clickable links in the header that open the preview page or post page. The URL is there, it just lack some hook in Emacs. Then attachment processing … the API seems to support it.

I also thought of markup support, but i guess it should just be installed in the blog site, processing “markup X” to HTML to “markup X” seems to be the perfect way to invoke Cthulhu bugs. So i would rather have mmm-mode support and use Emacs HTML capabilities.
I found that i almost don’t need HTML, at least on WordPress and for “just text” posts, because it formats paragraphs nicely without P tags.

This time the files are uploaded in my Emacs Hacks page.

Happy blogging !

However in Shanghai city nothing special happened. In fact there was bigger rain on Tuesday than on Wednesday and while everybody was fearing that the storm would hit us with more strength yesterday, there was little rain and maybe just stronger wind.

Indeed as the Associated Press reported, the typhoon seems to have hit China a bit south of Shanghai and lost most of its might overland before hitting Shanghai.

Apparently the broad annoncement on TV, radio, traffic signals, as well as closing schools and evacuating the part most at risk helped keeping the casualties low.
But in Shanghai yesterday it seemed that somehow the municipality did not think that “typhoon” and “torrential rains” would be a good enough reason to stop their road cleaning trucks to spray water over the roads.

Being a KDE user I naturally went to kde-apps and found KBlogger. This application is a Kicker applet which appears as a big “Blog” button.
Setting it up was not too difficult but I had to find out that the URL of the blog is not enough, it needs to be pointed to xmlrpc.php.

In term of features it offers:

• fetching categories
• fetching your post for edit or deletion
• posting as draft or published

Unfortunately I couldn’t stand with:

• the “Blog” button takes too much room in my task-bar
• have to right click to have the list of posts .. then wait will it downloads from the server
• there is no caching
• if I press ESC in a dialog it cannot re-open any dialog, I have to remove and add the applet again
• no spell checking (Qt spell checking is said to mess with the output)

Also since I just started to get along with Emacs, finally, I decided I would give at chance too. So I downloaded weblogger from savannah and applied to patches from emacswiki.

Unlike other Emacs features, this one was very easy to setup. The documentation on Emacs Wiki gives you the one or two commands you need and in 2 minutes I had all my entries fetched in Emacs.
So compared to KBlogger, it is very fast because it caches the posts and it supports Emacs spell checking. Since I am always in Emacs anyway writing a Blog post is just a shortcut away. It also makes posting code snippets or writing as you are coding very easy.

Unfortunately it doesn’t support categories yet, and attachments didn’t work …

Also the version I had didn’t work with WordPress very well, it could not upload the edited posts. I tracked down the issue to the format of the post date. Looks like WordPress is expecting a dateTime.iso8601 but receiving a string, a quick hack later and everything works as expected.

If I have time, I might just look into the category feature. It should not be too difficult anyway.

PS: I’ve attached the patched files. They include the patches from EmacsWiki that were needed, plus my own: dateTime format, and i escape strings in CDATA rather than url encoding (at first I thought the problem came from url encoding).

patched xml-rpc.el

patched weblogger.el

China takes a different approach by filtering Web content for specific keywords and selectively blocking Web pages [...] when the Chinese system detects a banned word in data traveling across the network, it sends a series of three “reset” commands to both the source and the destination.

And this works in a protocol agnostic way, so it may reset your DNS request, HTTP session, etc …

Because it filters ideas rather than specific Web sites, keyword filtering stops people from using proxy servers or “mirror” Web sites to evade censorship.

Encrypted content can’t be filtered, that’s why I previously mentioned Tor which has been “omitted” from the blacklist. Now it would not be that hard to filter the Tor network and web site, but just like Google Reader, they are missing the obvious.

But because it is not completely effective all the time, it probably acts partly by encouraging self-censorship, Barr said. When users within China see that certain words, ideas and concepts are blocked most of the time, they might assume that they should avoid those topics.

I suppose the average Chinese will use a Chinese search engine anyway (Baidu is very famous here) which will have its own politically correct “filters”, and even Google is complying with Chinese censorship … or trying.

In fact the networks in China so reliable that I guess the Chinese hitting a “banned” word would just assume that something went wrong with its connection. Getting a “timeout” error is quiet common, and it is not like they redirect you to a page with flashing warnings.

Overall the Great Firewall is just a source of frustration and lost time. Especially when it get overzealous on blocking content you want to access on a daily basis (like developer blogs for example). It is like having a 5cm wall on your way to work, you may trip on it if you don’t pay attention, but it is barely preventing you to do anything. (another analogy would be the lake wall in the Simpson movie, but i can’t get a pic right now).

I’ve chosen WordPress not because I think it is superior to other blog platforms, but simply because i know it will be accessible from “inside” China without having to use Tor …

I would have chosen Google Blogger since i already use many Google applications, but blogs hosted on blogspot.com are Firewalled® (but not the site http://www.blogspot.com).

Ironically Google Reader makes my life a lot easier by fetching the RSS Feeds of all those dissident web sites (a lot of KDE developers do not suspect they are political threats) from behind the “Great Firewall of China”©.

Or maybe those who hacked the Pentagon cannot implement a proper censorship…