Re: code critique requested

[Lennart Borgman (gmail)]

metaperl.com wrote:
> Hi, any feedback on improving this is appreciated. I have been getting
> some reports with warnings on byte-compilation. I'm mainly interested
> in GNU Emacs correctness, but if I can support both major emacsen
> without too much hassle, then I will do it.
>
> ;;; asciidoc.el --- asciidoc text file development support
...
> ;;; Description:
>
> ;; Suggested (but entirely optional) add-ons:
> ;; doc-mode: font-locking for asciidoc buffers
> ;; http://xpt.sourceforge.net/tools/doc-mode/
> ;; - connect asciidoc.el to doc-mode as follows:
> ;;   (autoload 'doc-mode "doc-mode" nil t)
> ;;   (add-to-list 'auto-mode-alist '("\\.adoc$" . doc-mode))
> ;;   (add-hook 'doc-mode-hook
> ;;        '(lambda ()
> ;;           (turn-on-auto-fill)
> ;;           (require 'asciidoc)))
>
> ;; Author extends thanks to:
> ;; Steve Youngs (JackaLX on irc://irc.freenode.net/xemacs)
> ;; bpalmer, twb
> ;; Alexander Kinzer - byte-compile bug reports

It would be nice if the description said something more about what the 
file does or where to get more info.