aboutsummaryrefslogtreecommitdiffstats
path: root/developer.html
blob: c07e7f2a70f0803a2d3e1af5bd1cf664b5c52ba3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
        "http://www.w3.org/TR/html4/loose.dtd">

<html>
<head>
  <title>Build instructions for the Norwegian spell checking system</title>
  <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1">
  <link rev="made" href="mailto:i18n-no&#64;lister&#46;ping&#46;uio&#46;no">
  <link rel="top" href="http://no.speling.org/">
  <meta name="Language" content="en">
  <meta name="Author"
        content="Petter Reinholdtsen,Torstein Dybvad">
  <link rel="stylesheet" href="http://developer.skolelinux.no/skl-ren_css.css" type="text/css">
</head>

<body>

  <div class="hbar"></div>

  <div class="menu">
  <a href="#getsource">Getting source</a><br>
  <a href="#builddepend">Build dependencies</a><br>
  <a href="#building">Building data files</a><br>
  <a href="#disting">Building tarball</a><br>
  <br>
  <a href="/">spell-norwegian</a><br>
  </div>

  <div class="body">

  <h1>Build instructions for the Norwegian spell checking system</h1>

<a name="getsource"><h2>Getting the source</h2></a>

<p>A source tarball is available
<a href="https://alioth.debian.org/projects/spell-norwegian/">from
alioth</a>, and the latest development version is available from CVS.
See the Alioth project page for download instructions.</p>

<a name="builddepend"><h2>Build dependencies</h2></a>

<p>The build is using binaries from ispell to generate the list of
base words with affixes based on a list of words and frequency
information.  This is the source for the other spell checking systems.
To speed up this build, ssed is used instead of the slow GNU sed.</p>

<p>To generate aspell and myspell files, one first need ispell and
then aspell or myspell.</p>

<p>Other packages you need to build this package is: dev-myspell thescoder</p>
<a name="building"><h2>Building and installing the
ispell/aspell/myspell data files</h2></a>

<p>There are four useful 'top level' makefile targets; <tt>words</tt>,
<tt>ispell</tt>, <tt>myspell</tt> and <tt>aspell</tt>.  Each of these
have install targets as well; <tt>install-words</tt>,
<tt>install-ispell</tt>, <tt>install-myspell</tt> and
<tt>install-aspell</tt>.  In addition there are install targets for
the scripts (<tt>install-scripts</tt>) and documentation
(<tt>install-doc</tt>).  The <tt>DESTDIR</tt> variable is supposed for
convenience.  All of the build and install targets can be called with
nb and nn variants, for example <tt>install-ispell-nb</tt> to only
install the nb version.</p>

<p>So, to build and install the myspell dictionary, this is the
command:

<blockquote><pre>
make install-myspell DESTDIR=/some/path
</pre></blockquote>

<a name="disting"><h2>Making a new release, building the tarball and distribution files</h2></a>

<p>The tarball is generated using the <tt>dist</tt> makefile target.  It
is best to use the <tt>distcheck</tt> target instead to do a test
build of the generated tarball to check if all the required files are
included.

<blockquote><pre>
make distclean distcheck
</pre></blockquote>

<p>This target will also generate a package for OpenOffice.org
(<Tt>no_NO-<em>version</em>.zip</tt>) as well as the
<tt>spell-norwegian-<em>version</em>.tar.gz</tt> tarball.

<p>It might be a good idea to fetch the latest thesaurus file before
making the tarball and zip files.  This is done using the
<tt>thesaurus-nb.txt-update</tt> target.  There is no equivalent nn
target yet.

<blockquote><pre>
make thesaurus-nb.txt-update
</pre></blockquote>

When the files are tested and found to be working, the CVS tree used
to build the distribution should be tagged to document which version
of the files were used to make the release.  This is done by using
<tt>cvs tag <em>version-tag</em></tt> in the
<tt>src/spell-norwegian/</tt> directory.  Use <tt>cvs status -v
Makefile</tt> to see the name structure of the used tags.

<blockquote><pre>
cvs tag release_<em>version_with_underline</em>
</pre></blockquote>

<h2>Old instructions</h2>

<p>Short information for building the word list with cvs checkout.

<p>Steps for building wordlists.

<p>Download ispell.3.2.06<br>
Untar ispell package<br>
Patch with ispell patch from cvs<br>
copy files for cvs into languages/norsk folder inside ispell folder.<br>
build ispell. (ispell is a bit tricky to build some times, check out
the Readme file included in the ispell-tarball)<br>
go to languages/norsk folder<br>
make -f Makefile.new myspell-dist<br>
make -f Makefile.new aspell-dist<br>
the aspell tar.bz2 files are aspell wordlists<br>
and myspell files are there.<br>
<br>
To make the ispell files type<br>
<br>
make all<br>
<br>
this will make the nynorsk.hash and bokmal.hash ispell files.

  </div>

  <div class="hbar"></div>
</body>
</html>