← Back to branch summary

~ubuntu-branches/ubuntu/gutsy/icu/gutsy-updates

« back to all changes in this revision

Viewing changes to source/test/letest/readme.html

  • Committer: Package Import Robot
  • Author(s): Jay Berkenbilt
  • Date: 2005-11-19 11:29:31 UTC
  • mfrom: (1.1.2)
  • Revision ID: package-import@ubuntu.com-20051119112931-vcizkrp10tli4enw
Tags: 3.4-3
Explicitly build with g++ 3.4.  The current ICU fails its test suite
with 4.0 but not with 3.4.  Future versions should work properly with
4.0.

Show diffs side-by-side

added added

removed removed

Lines of Context:
source/test/letest/readme.html
1
 
<!DOCTYPE html PUBLIC "-//w3c//dtd html 4.0 transitional//en">
2
 
<html>
3
 
<head>
4
 
    
5
 
  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
6
 
    
7
 
  <meta name="Author" content="Eric Mader">
8
 
    
9
 
  <meta name="GENERATOR" content="Mozilla/4.72 [en] (Windows NT 5.0; U) [Netscape]">
10
 
  <title>Readme file for letest and gendata</title>
11
 
</head>
12
 
  <body>
13
 
  
14
 
<h2> What are letest and gendata?</h2>
15
 
 letest is a program you can use to verify that you have built and installed 
16
 
the ICU LayoutEngine correctly. The test is not comprehensive, it just verifies
17
 
that the results of laying out some Devanagari, Arabic and Thai text are
18
 
as expected. Once this test has passed, you can use the ICU LayoutEngine in
19
 
your application knowing that it has been correctly installed and that the
20
 
basic functionality is in place. 
21
 
<p>gendata is a program that is used by the ICU team to build the source file
22
 
testdata.cpp, which contains the expected results of running letest. Unless
23
 
you have changed your copy of the LayoutEngine and want to validate the changes
24
 
on other platforms, there's no reason for you to run this program. </p>
25
 
<p>(The ICU team first runs a Windows application which uses the ICU LayoutEngine 
26
 
to display the text that letest uses. Once it has been verified that the text
27
 
is displayed correctly, gendata is run to produce testdata.cpp, and then
28
 
letest is run on Windows to verify that letest still works with the new data.) 
29
 
<br>
30
 
&nbsp; </p>
31
 
<h2> How do I build letest?</h2>
32
 
 First, you need to build ICU, including the LayoutEngine. 
33
 
<p>On Windows, the layout project should be listed as a dependency of all, 
34
 
so layout will build when you build all. If it doesn't for some reason, just
35
 
select the layout project in the project toolbar and build it. </p>
36
 
<p>On UNIX systems, you need to add the "--enable-layout=yes" option when 
37
 
you invoke the runConfigureICU script. When you've done that, layout should 
38
 
build when you do "make all install" </p>
39
 
<p>To build letest on Windows, just open the letest project in &lt;icu&gt;\source\test\letest 
40
 
and build it. On UNIX systems, connect to &lt;top-build-dir&gt;/test/letest 
41
 
and do "make all" <br>
42
 
&nbsp; </p>
43
 
<h2> How do I run letest?</h2>
44
 
 Before you can run letest, you'll need to get the fonts it uses. For legal 
45
 
reasons, we can't include them with ICU, but you can get them for free from
46
 
the web. To do this, you'll need access to a computer running Windows. Here's
47
 
how to get the fonts: 
48
 
<p>Download the 1.3 version of the JDK from the <a href="http://www7b.boulder.ibm.com/wsdd/wspvtindex.html">
49
 
IBM WebSphere preview technologies</a> page. From this page, follow the "Download" 
50
 
link on the right had side. You'll need to register with them if you haven't 
51
 
downloaded before. Download and install the "Runtime Environment Package." 
52
 
You'll need three fonts from this package. If you've let the installer use
53
 
it's defaults, the fonts will be in C:\Program Files\IBM\Java13\jre\lib\fonts. 
54
 
The files you want are "LucidaSansRegular.ttf" and "Thonburi.ttf" Copy these
55
 
to the directory from which you'll run letest. </p>
56
 
<p>Next is the Hindi font. Go to the&nbsp; NCST site and download&nbsp;<a href="http://rohini.ncst.ernet.in/indix/download/font/raghu.ttf">
57
 
raghu.ttf</a>. Be sure to look at the&nbsp;<a href="http://rohini.ncst.ernet.in/indix/download/font/README">
58
 
README</a> file before you download the font. You can download raghu.ttf
59
 
into the directory from which you'll run letest.<br>
60
 
</p>
61
 
<p>There's still one more font to get. Go to the Microsoft <a href="http://www.microsoft.com/typography/fontpack/default.htm">
62
 
TrueType core fonts for the Web</a> page and download the "Times New Roman"
63
 
font. This will download an installer program, called "Times32.exe" which
64
 
will install the Times New Roman fonts in your fonts folder. (If you've already 
65
 
got these fonts in you fonts folder, you may want to move them to another 
66
 
folder before you install these fonts.) </p>
67
 
<p>NOTE: this installer will display an End User License Agreement (EULA) 
68
 
which you must accept before proceeding. Be sure that you read and understand 
69
 
this agreement before you install the font. </p>
70
 
<p>After you run the installer program, it will add the Times Roman fonts 
71
 
to your fonts folder. Open the fonts folder and copy the "Times New Roman" 
72
 
font (the file name will be "Times.TTF") to the directory from which you'll 
73
 
run letest. </p>
74
 
<p>That's it! Now all you have to do is run letest (CTRL+F5 in Visual C++, 
75
 
or "./letest" in UNIX) If&nbsp; everything's OK you should see something like
76
 
this: </p>
77
 
<blockquote><tt>Test 0, font = raghu.ttf... passed.</tt> <br>
78
 
  <tt>Test 1, font = Times.TTF... passed.</tt> <br>
79
 
  <tt>Test 2, font = LucidaSansRegular.ttf... passed.</tt> <br>
80
 
  <tt>Test 3, font = Thonburi.ttf... passed.</tt></blockquote>
81
 
  
82
 
  </body>
83
 
  </html>