[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] 43/352: Englanninkielinen kuvaus ja koodin kommentit funktiolle w
From: |
Stefan Monnier |
Subject: |
[elpa] 43/352: Englanninkielinen kuvaus ja koodin kommentit funktiolle wcheck-mode |
Date: |
Mon, 07 Jul 2014 14:01:52 +0000 |
monnier pushed a commit to branch master
in repository elpa.
commit f11e7b49a4815b0e4dc63d5025d88578c6bffd48
Author: Teemu Likonen <address@hidden>
Date: Sun May 17 20:38:34 2009 +0000
Englanninkielinen kuvaus ja koodin kommentit funktiolle wcheck-mode
Samalla myös pientä hienosäätöä muuttujan wcheck-language-data
kuvaukseen.
---
wcheck-mode.el | 69 +++++++++++++++++++++++++++++++++++++++++--------------
1 files changed, 51 insertions(+), 18 deletions(-)
diff --git a/wcheck-mode.el b/wcheck-mode.el
index 5f01d42..e79d223 100644
--- a/wcheck-mode.el
+++ b/wcheck-mode.el
@@ -29,7 +29,8 @@
(defcustom wcheck-language-data nil
- "Wcheck-mode language configuration.
+ "Wcheck mode language configuration.
+
Elements of this alist are of the form:
(LANGUAGE (KEY . VALUE) [(KEY . VALUE) ...])
@@ -260,76 +261,108 @@ interactively) then change the default language for new
buffers."
(define-minor-mode wcheck-mode
- "Sanojen tarkistus, oikoluku."
+ "Interface for external spell-checkers and filtering programs.
+
+Wcheck is a minor mode for automatically marking words or other
+text pieces in Emacs buffer. Wcheck sends (parts of) buffer's
+content to an external text-filtering program and, based on its
+output, decides if some parts of text should be marked.
+
+Wcheck can be used with spell-checker programs such as Ispell,
+Aspell and Enchant. Then the semantics of operation is that the
+words returned from a spelling checker are spelling mistakes and
+are marked as such in Emacs buffer.
+
+The mode can also be useful with other kind of external tools.
+Any tool that can receive text stream from standard input and
+send text to standard output can be used. User is free to
+interpret the semantics. In Wcheck configuration different
+semantical units are called \"languages\".
+
+See the documentation of variable `wcheck-language-data' for
+information on how to configure Wcheck mode. Interactive command
+`wcheck-change-language' is used to switch languages."
+
:init-value nil
:lighter " Wck"
:keymap wcheck-mode-map
(if wcheck-mode
- ;; Oikoluku päälle mutta ensin pari tarkistusta:
+ ;; Turn on Wcheck mode, but first some checks...
+
(cond
((minibufferp (current-buffer))
- ;; Kyseessä on minibuffer, joten ei kytketä päälle
+ ;; This is a minibuffer; stop here.
(wcheck-mode 0))
((not (wcheck-language-valid-p wcheck-language))
- ;; Kieli ei ole toimiva
+ ;; Not a valid language.
(wcheck-mode 0)
- (message (format "Sopimaton kieli \"%s\", ei kytketä oikolukua"
+ (message (format "Language \"%s\" is not valid"
wcheck-language)))
((not (wcheck-program-executable-p
(wcheck-query-language-data wcheck-language 'program)))
- ;; Ohjelmaa ei löydy tai sillä ei ole suoritusoikeuksia
+ ;; The program does not exist or is not executable.
(wcheck-mode 0)
- (message (format "Kielen \"%s\" ohjelma \"%s\" ei ole ajettava"
+ (message (format "Language \"%s\": program \"%s\" is not executable"
wcheck-language
(wcheck-query-language-data wcheck-language
'program))))
(t
- ;; Käynnistetään "oikoluku"
+ ;; We are ready to really turn on the mode.
- ;; Puskurikohtaiset koukut
+ ;; Add buffer-local hooks. These ask for updates for the buffer
+ ;; or may sometimes automatically turn off the mode.
(add-hook 'kill-buffer-hook 'wcheck-hook-kill-buffer nil t)
(add-hook 'window-scroll-functions 'wcheck-hook-window-scroll nil t)
(add-hook 'after-change-functions 'wcheck-hook-after-change nil t)
(add-hook 'change-major-mode-hook
'wcheck-hook-change-major-mode nil t)
- ;; Globaalit koukut. Riittää, että nämä lisää vain kerran, mutta
- ;; varmuuden vuoksi ajetaan seuraavat komennot joka kerta, kun
- ;; wcheck-tila kytketään päälle.
+ ;; Add global hooks. It's probably sufficient to add these only
+ ;; once but it's no harm to ensure their existence every time.
(add-hook 'window-size-change-functions
'wcheck-hook-window-size-change)
(add-hook 'window-configuration-change-hook
'wcheck-hook-window-configuration-change)
+ ;; Add this buffer to the bookkeeper.
(wcheck-update-buffer-process-data (current-buffer) wcheck-language)
+ ;; Start idle timer if it's not already started. The timer runs
+ ;; a function which updates buffers which have requested for
+ ;; that.
(unless wcheck-timer
(setq wcheck-timer
(run-with-idle-timer wcheck-timer-idle t
'wcheck-timer-event)))
+ ;; Request update for this buffer.
(wcheck-timer-read-request (current-buffer))))
- ;; Oikoluku pois
- (setq wcheck-returned-words nil)
+ ;; Turn off the mode.
+
+ ;; We clear overlays form the buffer, remove the buffer from
+ ;; bookkeeper's data and clear the variable holding words received
+ ;; from external process.
(wcheck-remove-overlays)
(wcheck-update-buffer-process-data (current-buffer) nil)
+ (setq wcheck-received-words nil)
+ ;; If there are no buffers using Wcheck mode anymore, stop the idle
+ ;; timer and remove global hooks.
(when (and (not wcheck-buffer-process-data)
wcheck-timer)
(cancel-timer wcheck-timer)
(setq wcheck-timer nil)
- ;; Globaalit koukut poistetaan vasta, kun ajastinkin poistetaan
- ;; eli kun mikään puskuri ei enää tarvitse oikolukua.
+
(remove-hook 'window-size-change-functions
'wcheck-hook-window-size-change)
(remove-hook 'window-configuration-change-hook
'wcheck-hook-window-configuration-change))
- ;; Puskurikohtaiset koukut
+ ;; Remove buffer-local hooks.
(remove-hook 'kill-buffer-hook 'wcheck-hook-kill-buffer t)
(remove-hook 'window-scroll-functions 'wcheck-hook-window-scroll t)
(remove-hook 'after-change-functions 'wcheck-hook-after-change t)
- [elpa] 33/352: wcheck-language-valid-p tiiviimpään and-rakennemuotoon, (continued)
- [elpa] 33/352: wcheck-language-valid-p tiiviimpään and-rakennemuotoon, Stefan Monnier, 2014/07/07
- [elpa] 34/352: Tyhmän moka r2652:ssa rikkoi oletuskielen määrittelyn, korjataan, Stefan Monnier, 2014/07/07
- [elpa] 28/352: Sammutetaan globaalit koukut vasta, kun oikolukua ei tarvita, Stefan Monnier, 2014/07/07
- [elpa] 36/352: Muuttujalle wcheck-language-data kuvaus ja customize-määritys, Stefan Monnier, 2014/07/07
- [elpa] 35/352: wcheck-make-overlayn parametriksi puskuri, ei ikkuna, Stefan Monnier, 2014/07/07
- [elpa] 38/352: Laitetaan oletusasetukset näkymään customizeen, Stefan Monnier, 2014/07/07
- [elpa] 39/352: Funktion wcheck-change-language kuvaus englanniksi, Stefan Monnier, 2014/07/07
- [elpa] 40/352: Muutetaan oletuskielen tunnistusta varmatoimisemmaksi, Stefan Monnier, 2014/07/07
- [elpa] 41/352: Poistetaan customizesta vaatimus, että ohjelman täytyy olla olemassa, Stefan Monnier, 2014/07/07
- [elpa] 37/352: Lisätään muuttujan wcheck-language-date esimerkkiin regexp-discard, Stefan Monnier, 2014/07/07
- [elpa] 43/352: Englanninkielinen kuvaus ja koodin kommentit funktiolle wcheck-mode,
Stefan Monnier <=
- [elpa] 48/352: Siirretään oikolukupyyntölistan muokkaus aiemmaksi, Stefan Monnier, 2014/07/07
- [elpa] 46/352: Tehdään maalausajastimesta nimetty funktio (ei lambda), Stefan Monnier, 2014/07/07
- [elpa] 50/352: Käännetään ajastinfunktiot englanniksi, Stefan Monnier, 2014/07/07
- [elpa] 44/352: Lisätään asennusohjeet wcheck-mode.el-tiedoston alkuun, Stefan Monnier, 2014/07/07
- [elpa] 42/352: Tehdään oletuskielestä customize-muuttuja, Stefan Monnier, 2014/07/07
- [elpa] 52/352: Uusi tapa lukea tekstiä ikkunasta, Stefan Monnier, 2014/07/07
- [elpa] 49/352: Siirretään maalauspyyntölistan muokkaus aiemmaksi, Stefan Monnier, 2014/07/07
- [elpa] 45/352: Tarkistetaan prosessi funktion wcheck-program-executable-p avulla, Stefan Monnier, 2014/07/07
- [elpa] 47/352: Muutetaan funktion nimeä: wcheck-timer-event -> wcheck-timer-read-event, Stefan Monnier, 2014/07/07
- [elpa] 51/352: Lasketaan uuden ajastimen käynnistysviive edellisestä eteenpäin, Stefan Monnier, 2014/07/07