hunspell(1)                                           hunspell(1)



NV
       hunspell - helyesrs-javt s sztvez program

TTEKINTS
       hunspell  [-1  -a -G -h -H -l -L -n -s -t] [-d sztr] [-p
       sajt_sztr] [llomny(ok)]

LERS
       A  hunspell  Ispell-szer  interaktv  s   csfellet   a
       (Magyar)   MySpell   fggvnyknyvtrhoz.    Felismeri  s
       javtja  az  eltseket  s  tpushibkat  sima  szveges,
       (La)TeX,  HTML,  s groff (kziknyv oldal) llomnyokban.
       A -s kapcsolval sztvez zemmdban fut (Hunstem).

       Ha nem adunk meg llomnynv  paramtert,  a  Hunspell  az
       Ispell  csfellethez hasonlan mkdik: a bemenet sorait
       szavakra bontja, s *, +, vagy - jellel  kezdd  kimeneti
       sorral jelzi, ha egy sz j, s # vagy & jellel, ha rossz.
       A csfellet parancsait  viszont  az  Ispellhez  hasonlan
       csak a -a kapcsol megadsval rtelmezi.

       llomnynv  paramter  esetn  elindul  egy az Ispellhez
       hasonl interaktv fellet.

       A program a kvetkez elnyket nyjtja a hasonl  clokat
       szolgl Ispell-lel szemben:

       -      Helyes javaslatok a tbb karakter vltozsval jr
              tipikus hibkra (j/ly, j/ijj, nyj/nny s mg  tbb
              tucatnyi  tveszts  megvizsglsval).   Az Ispell
              csak kt karakter felcserlse; vagy  egy  karakter
              hinya,   cserje,   illetve  felesleges  jelenlte
              esetn ad helyes javaslatot.

       -      Az  sszes  helyes  sszetett  sznak  ltsz,   de
              tipikus   hibval  elll  alak  tiltsa  (karvaj,
              sznt, slyt stb.)

       -      Javaslatok valsznsgi sorrendben   jelennek  meg
              (tipikus hibk, i/, o/, u/ tvesztsek stb.).

       -      sszetett szavak esetn  6-3-as szably alkalmazsa
              (helyesrs-ellenrz, gpkocsi-sszeszerels).

       -      Mozgszably   alkalmazsa   (kiviteli    engedly,
              kiviteliengedly-krs).

       -      A   magyar  nyelv  egyb  sszetteli  szablyainak
              alkalmazsa (pldul  hatlvet,  tizenkt  lvet,
              kthavi, kt hnapos, msodmagval).

       -      Leg-,  legesleg-  s  -bb  confixum helyes kezelse
              (nincs pl. legdes, csak legdesebb).

       -      Ragozhat tszfelvtel.  Megknnyti  egy  j  sz
              ragozott  vltozatainak  ellenrzst, feleslegess
              tve ezek kln-kln trtn  felvtelt  a  sajt
              sztrba.

       -      Javaslatok    mssalhangz-triplzsok    (sakkkr,
              baletttncos,   dzsesszszak)    esetn.     (Ispell
              helyesnek fogadja el ezeket.)

       -      Javaslatok sztagduplzsok (oktatats, igenenevet)
              esetn.

       -      Javaslatok      kezet       nlkli       szvegre
              (tukorfurogep->tkrfrgp).

       -      Ktjeles szavak kezelse (unos-untalan).

       -      Toldalkolt  szmok (1-jn, 11-n, 5.-et) kezelse.

       -      , %, s   jelek  (%-kal)  toldalkolt  alakjainak
              kezelse.

       -      Mozaikszavak (MV-osokat) kezelse.

       -      Y-ra vgzd szavak (boyjal, pennyvel) kezelse.

       -      Idegen     ejts     sztagra    vgzd    szavak
              (Anonymusszal, Voltaire-nek) kezelse.

       -      Kt szbl ll fldrajzi nevek  (San  Francisc-i)
              kezelse.

       -      Hibs    alakok    tiltsa    (Babitssal,    tanit,
              alkotmvsz stb.)

       -      Tiltsok jelzse a felhasznli felleten.

       -      Egyb (pldul az Ispell ragozott  utsz  esetben
              brmilyen  szsszettelt  elfogad:  macskatekerem,
              kutyakavarom, ezt a Hunspell nem teszi meg).

       -      Magyar nyelv (illetve locale (7) fgg) fellet.

       -      Hordozhat szveges  sztrllomnyok,  szemben  az
              Ispell  platform,  s  binris  Ispell  fordtstl
              fggen (nem) kezelhet adatllomnyaival.

KAPCSOLK
       -1     Specilis  formtum:  a  bemeneti  llomny  minden
              sorbl csak az els szt vizsglja meg.

       -a     Ispellhez  csfellet.  A  !,  +,  -,  @, #, vagy ^
              jellel  kezdd  sorok  a   csfellet   parancsai,
              jelentsket az Ispell kziknyvoldal rszletezi. A
              -a kapcsol hatsra a  kimenetben  a  j  szavakat
              csak   csillaggal  jelzi  a  Hunspell.  Ez  nagyobb
              kompatibilitst  biztost   az   Ispellt   hasznl
              programok  nmelyikvel (pldul a LyX-szel). Ekkor
              nem kell megadnunk a -a kapcsolt, mivel az Ispellt
              hasznl    programok    automatikusan    ezzel   a
              kapcsolval indtjk  el  az  Ispell  nevben  fut
              Hunspellt is.

       -d  sztr
              Meghatrozza     a    helyesrsi    sztrt.    Az
              alaprtelmezett              sztr               a
              /usr/share/hunspell/default.   A  megadott  tvonal
              lehet  abszolt  s  relatv  is.  Relatv  tvonal
              esetn     elszr     az    aktulis,    majd    a
              /usr/share/hunspell knyvtrban keresi a sztrt  a
              program. L.  PLDK.

       -G     A  -l,  s  -L  kapcsolkat  kiegszt kapcsol. A
              standard bemenetrl rkez  hibs  szavak,  illetve
              sorok  megjelentse  helyett  a  j  szavak  s  a
              hibtlan sorok megjelentst krhetjk vele.

       -h, --help
              A beptett lers megjelentse.

       -H     HTML bemeneti llomnyformtum  belltsa.  Ha  az
              llomny   nevnek   .html,   .htm,   vagy  .xml  a
              kiterjesztse, ez automatikusan bekvetkezik.

       -l     Csak a hibs szavakat rja ki a standard bemenetrl
              rkez  llomnybl.   Hasznlhat a -H, -t, -n, -1
              kapcsolkkal egytt is. A -G kapcsol megfordtja a
              Hunspell  mkdst:  csak  a  j  szavak  kerlnek
              kirsra.

       -L     Csak a hibs szavakat tartalmaz sorokat rja ki  a
              standard     bemenetrl     rkez     llomnybl.
              Hasznlhat a -H, -t, -n,  -1  kapcsolkkal  egytt
              is.  A  -G  kapcsol  megfordtja a mkdst: csak
              azok a sorok kerlnek kirsra, amelyek  egy  hibs
              szt sem tartalmaznak.

       -n     Nroff/troff  bemeneti  llomnyformtum belltsa,
              elssorban a kziknyvlapok ellenrzsre.

       -p  sajt_sztr
              A   felhasznl   sajt   sztrnak   belltsra
              szolgl.

              Az      alaprtelmezett      sajt     sztr     a
              $HOME/.hunspell_default llomny.  Ha  sztrat  is
              megadunk   a  -d  kapcsolval,  vagy  a  DICTIONARY
              krnyezeti   vltozval,   a   sajt    sztr    a
              $HOME/.hunspell_sztrnv  lesz.  Ha a sajt sztr
              nem ltezik, ltrehozza.

              Ha az aktulis knyvtrban is  van  egy  ugyanilyen
              nev  llomny, akkor annak tartalma is beolvassra
              kerl, mint sajt sztr,  s  az  jonnan  felvett
              szavak is ide kerlnek.

              A   -p   ,   vagy  a  WORDLIST  krnyezeti  vltoz
              megadsval j sajt sztrat jellnk ki. A  sajt
              sztrat   az  aktulis  knyvtrban,  s  a  sajt
              knyvtr gykerben ($HOME) keresi a  Hunspell.  Ha
              nem  tallhat,  akkor  az  jonnan  felvett szavak
              mentsnl ltrehozza a sajt knyvtr  gykerben.

       -s     Tokenizls  s  sztvek  ellltsa.  Amennyiben
              llomnyokat adunk meg paramterknt,  a  fjlnevek
              is megjelennek a kimenetben, lehetsget nyjtva az
              llomnyok indexelsre.  Ez utbbiban a makedb, s
              a lookdb parancsok segtenek.

              A tvez zemmd kimenete a kvetkez: egy bemeneti
              szhoz  tartozik  egy  normalizlt  szalak,   majd
              tovbbi sorokban a lehetsges tvek, vgl egy res
              sor. Az  ellenrz  ltal  nem  ismert  szavak  egy
              kettskereszttel   s   egy   szkzzel   bevezetve
              kerlnek a kimenetbe.

       -t     LaTeX bemeneti llomnyformtum belltsa.  Ha  az
              llomny   nevnek   .tex   a   kiterjesztse,   ez
              automatikusan bekvetkezik.

       -v     Verziszm.

       -vv    Verziszm (Ispell kompatibilits miatt).

INTERAKTV FELLET
       A fellet legfels sorban a hibs szalakot, s az  ppen
       vizsglt  llomny  nevt  ltjuk.  Amennyiben egy szalak
       sztri tilts miatt nem kerl elfogadsra,  a  bal  fels
       sarokban a TILTOTT!  (FORBIDDEN!) zenet is megjelenik. Ez
       az zenet arra utal,  hogy  nem  hinyos  szkincs,  hanem
       szndkos  tilts  miatt  nem kerlt a sz elfogadsra. Az
       els sor alatt az llomny hibs szt tartalmaz sort, s
       szvegkrnyezett    lthatjuk,   majd   ezt   kvetik   a
       javaslatok, ha vannak.

       A hasznlhat billentykombincik:

       Szkz Tovbblps javts nlkl a kvetkez hibs szra.

       Szmok A megfelel javaslat kivlasztsa.

       c      Csere.  A  hibs sz cserje a megadott szra, vagy
              szavakra.     Az    Escape    billenty    ktszeri
              lenyomsval megszakthatjuk a a csert.

       j      A    sz    elfogadsa    a    program    futsnak
              befejezdsig.

       f      A sz felvtele a sajt sztrba.

       k      A sz kisbetsknt val felvtele a sajt sztrba.

       t      Ragozott  tsz  felvtele. A ragozs a msodikknt
              megadott, mintul szolgl  sz  alapjn  trtnik.
              Ha   ez   a   sz   nincs  felvve  a  sztrba,  a
              tszfelvtelt ellrl kell kezdeni.

              Plda:  gyakran   hinyoznak   az   idegen   s   a
              mozaikszavak.  Vegyk  fel  a hinyz OTP szt a tv
              kznvi mozaiksz  toldalkaival!   Lenyomjuk  a  t
              billentyt, berjuk, hogy OTP, Enter, berjuk, hogy
              tv, s Enter. A  tv  sz  ugyanis  mr  szerepel  a
              sztrban,  s  ragozsa  mondja  meg a programnak,
              hogy az OTP szt  milyen  toldalkokkal  szeretnnk
              ltni,  pl.  OTP-hez, OTP-met stb. a tv-hez, tv-met
              mintjra.  A  -val/-vel,  -v/-v  toldalkokat  a
              ktjellel kapcsolt toldalk szavak esetben kln
              kell felvenni, de mg gy is sokkal knyelmesebb  a
              specilis  tfelvtel, mint minden (akr tbb szz)
              toldalkos alakot kln-kln felvenni.

              Egy kis  segtsg  a  minta  kivlasztshoz:  els
              menetben  a  hangrend szmt. Pl. mozaikszavaknl a
              mly hangrend j szavak felvtelnl hasznlhatjuk
              a  MV  szt pldaknt, ajakrses magas hangrendnl
              pedig  az  emltett  tv-t.  Ajakkerektses   magas
              hangrend esetben a HK szt hasznlhatjuk (amg t
              nem lesz javtva a helyes hk-re). Ha a hinyz sz
              nem  mozaiksz,  hanem  pldul tulajdonnv, a Pl,
              Pter,  rs  szavakat  adhatjuk  meg   pldnak   a
              hangrendtl  fggen. Ha meg egyszer kznvrl van
              sz, akkor  hasznljuk  az  ok,  k,  k  szavakat.
              Igknl  ll,  vl,  l, ikes igknl zik, vrzik,
              nzik  lehet  a  plda  (remlhetleg  a  kvetkez
              vltozatokban egyszersdik ez a tfelvtel).

              Az    Escape    billenty   ktszeri   lenyomsval
              megszakthatjuk ezt a mveletet.

              Az  itt  felvett  szavak  automatikusan   a   sajt
              sztrba kerlnek. Ha ezt innen trlni szeretnnk,
              a  programbl   kilpve   a   sajt   sztr   kzi
              tszerkesztsvel tehetjk meg.


       m      Kilps  a  vltoztatsok mentse nlkl. A program
              vltoztats meglte esetn megerstst kr.

       v      Az   llomny   ellenrzsnek    megszaktsa    a
              vltoztatsok    mentsvel.   Ha   van   kvetkez
              llomny, akkor a program annak ellenrzst  kezdi
              el.

       ?      Segtsg.  Hasonl  rvid  lers  megjelentse  a
              billentyparancsokrl.

CSFELLET
       A MIspell   soronknt  dolgozza  fel  az  llomnyokat,  a
       helyes  szavakat  *  (tsz),  -  (sszetett  sz), vagy +
       (ragozott  sz)  karakterrel  jelli,  a  helyteleneket  #
       (nincs  javaslat) , vagy & (van javaslat) karakterrel. A +
       jelet a kimenetben kveti mg a szt.  A  #  jel  utn  a
       hibs  sz,  s kezdpozcija van feltntetve.  A & jelet
       kveti a hibs  sz;  a  javaslatok  szma;  a  hibs  sz
       kezdpozcija;   majd   kettspont   utn  a  javaslatok,
       vesszvel elvlasztva:

              macska
              *
              macskabajusz
              -
              macskk
              + macska
              mcsk
              # mcsk 0
              macka
              & macka 7 0: macska, maca, racka, packa, vacka, 
marka, mack

PLDK
       hunspell -d en_US english.html
              Az amerikai angol helyesrsi  sztr  kivlasztsa
              (aktulis,  vagy a /usr/share/hunspell knyvtrbl.

       hunspell -d /opt/OpenOffice.org1.0.1/share/dict/ooo/de_DE
              A nmet helyesrsi sztr kivlasztsa a  megadott
              abszolt    tvonalrl,    a    standard    bemenet
              feldolgozsval.

       hunspell *.html
              Az  aktulis  knyvtrban  tallhat  sszes   HTML
              llomny interaktv ellenrzse.

       hunspell -l szveg.html
              A megadott llomny hibs szavainak kirsa.

       hunspell -r *.html
              Az   aktulis  knyvtrban  tallhat  sszes  HTML
              llomny  szavainak,  s   a   szavak   sztveinek
              kirsa.

KRNYEZET
       DICTIONARY
              A   sztr  helynek  megadsra  szolgl.  Szerepe
              megegyezik a -d kapcsolval.

       WORDLIST
              A sajt sztr helynek megadsra szolgl. Szerepe
              megegyezik a -p kapcsolval.

LLOMNYOK
       /usr/share/default.aff    Az    alaprtelmezett   ragozsi
       tblzat. Lsd hunspell(4).

       /usr/share/default.dic Az alaprtelmezett sztr az  elz
       ragozsi       tblzathoz.        Lsd       hunspell(4).
       $HOME/.hunspell_default Az alaprtelmezett  sajt  sztr.
       Az  llomnyt  ltrehozza a Hunspell, ha nem ltezik. Lsd
       ispell(1).

LSD MG
       hunspell (4), hunstem (1), makedb (1), lookdb (1),  ispell
       (1), ispell (4), Magyar Ispell dokumentci.

SZERZ
       A Hunspell az International Ispell lnyegi rsznek C++-os
       jramegvalstsnak,  a  MySpell  fggvnyknyvtrnak   a
       bvtse.    Nemcsak  fellet  a  knyvtrhoz,  hanem  egy
       jelents bvts is a magyar nyelv vonatkozsban  (Magyar
       MySpell).

       A  mintaknt  szolgl International Ispell szerzje Geoff
       Kuenning,  sok  ms  eldje  munkjra   tmaszkodva   (l.
       ispell(1)).

       A MySpellt Kevin Hendricks ksztette a kivl s ingyenes
       OpenOffice.org     (eredetileg     StarOffice)      irodai
       programcsomaghoz 2001-2002-ben.

       A  Magyar  MySpellt,  illetve  a Hunspell felletet Nmeth
       Lszl <nemethl@gyorsposta.hu> ksztette 2002-2003-ban.

       2003 mrciustl a fejlesztst a Szszablya projekt  viszi
       tovbb  egy  nyitott  forrskd magyar morfolgiai elemz
       elksztsnek irnyba.

       A Hunspell a Magyar Ispell projekt  eredmnyt,  a  magyar
       Ispell/MySpell helyesrsi sztrmodult hasznlja a magyar
       nyelv   szvegek   ellenrzsekor.    A   Magyar   Ispell
       levelezlista    a    magyarispell@yahoogroups.com   cmen
       tallhat.  Vrunk  minden  olyan   szrevtelt,   illetve
       segtsget,    ami   jobb   teheti   a   Magyar   MySpell
       helyesrs-ellenrzt, s a Magyar Ispell sztrmodult.

       Az International Ispell-nek, s gy a MySpellnek is magyar
       vonatkozsa    is    van.     A    programokban   szerepl
       affixumtmrts a Dmlki-algoritmuson alapszik,  Dmlki
       Blint  egyik 60-as vekben publiklt algoritmusn, amit a
       magyar  M3-as,  az  els  hazai  elektronikus   szmtgp
       megptst   kveten,   nyelvszeti   jelleg  kutatsok
       kapcsn dolgozott ki.

HIBK
       A sajt sztr mrete jelenleg 1000 szban van korltozva.
       A forrsban a MAXUSERWORD makr belltsval llthat be
       a kvnt rtk.

       Az  UTF-8,   vagy   UTF-16   karakterkdols   llomnyok
       ellenrzst mg nem tmogatja.

       A  sorok  maximlis  mrete nincs korltozva, de a 8 kB-os
       hatrokon tvesen  hibt  jelezhet  a  program.  A  szkz
       lenyomsval ugorjuk t a tves hibajelzst!

       Az  e-mail  cmek, URL-ek, s egyb tvonalak ellenrzst
       elkerlhetjk, ha ezeket a javasolt mdon; HTML esetben a
       <var>tvonal</var>,  LaTeX esetben \url{tvonal} formban
       adjuk meg. (A cmek elvlasztst  is  lehetv  tev  \url
       LaTeX   parancs   az   url   csomagban   tallhat,  teht
       hasznlathoz  a  \usepackage{url}  parancs  kiadsra  is
       szksg van a preambulumban.)




                         2003. jnius 13.             hunspell(1)
