-------------------

-- ReadManiac ---

-------------------

A library in the pocket

-------------------

Version 1.4
Copyright (C) 2003 by Roman Lut.


This is a help file for ReadManiac 1.4.
Press right menu key to access main menu.

-------------------

Contents

-------------------

1. Introduction

2. Installation

3. Menu

3.1. File menu

3.2. Options menu

3.3. Fonts menu

3.3.1. User font installation

3.4. Formatting menu

3.5. Codepage menu

3.6. Layout menu

3.7. Bookmarks menu

3.8. Slide show

4. How to register



-------------------

1. Introduction.

-------------------

 With this midlet you can read large text files on all 
Siemens java-enabled phones. Midlet has the following features: 

- Text file size is limited only by available space on MMC card(sl45i) 
  or storage memory;

- ReadManiac comes with 4 small fonts for comfortable reading on small 
  phone screen;

- Program has powerfull options for text formating, allowing to use  
  small phone screen in full;
  
- ReadManiac works as fast as it can be on this platform;

- ReadManiac can download new books from internet - and this makes it 
  a true library in the pocket;

- User can install its own fonts;

- Bookmarks and search features are supported;


-------------------

2. Installation.

-------------------

 Unzip "ReadManiac.zip" package. Connect your phone to PC and 
copy "ReadManiac\" directory to "java\jam\" directory on your phone.

 If you do not have cable or cradle, you can download ReadManiac from a 
web page. Please configure your phone for WAP usage. Goto phone's WAP menu
and enter 

"www.deep-shadows.com/hax/downloads/readmaniac.jad". 
 (use small lettes) 

 If everything are configured fine, you will see a prompt for midlet 
downloading. After midlet installation, run it and download on your 
phone any text you want.

 You also can ask your friend to beam midlet throught IR port.

-------------------

3. Menu

-------------------

   When reading text, press right menu key to access main menu, or
left menu key to acess Bookmarks menu. 
   Navigate menu with Up and Down keys. Select menu item with right menu 
key or pick up button; cancel with left menu key or hold button. 
   By default, top label on the right part of menu screen shows an action for
right menu key, and bottom label - for left menu key.

-------------------

3.1. File menu

-------------------

   File menu has "Open...", "Get HTTP..." items and a list of 
recently opened files. If there is no required file in the list, choose 
"Open.." and enter file name directly. ".txt" is default extension. 

  When you choose "Get HTTP..." option, ReadManiac shows URL input screen
and searches for URL names on the current page (or first page if there is 
no URLs on current page). You can access multiple URL names by pressing 
left menu key. This feature makes file downloading very easy, 
because you can create simple index file with list of URLs and book names, 
and than download books in just a few key presses. Note, that you must 
configure your phone internet settings for Java applications.
  While downloading, ReadManiac removes all HTML tags, so even general
HTML pages are readable.

 If you need more free space, select file and press "5" key to erase it. 

-------------------

3.2. Options menu

-------------------

 Here you can change font, text formating rules, file encoding, layout 
and the following options:

Light - force back light always on;

Sleep - a period of inactivity (minutes) to pass before midlet exits. This
will prevent complelete discharge of phone battery if you left phone
with midlet running on it;

Eye guard - a period of time to pass before midlet asks you to take a break.
Reading with small fonts for a long time can cause headache and eyesight 
problems. ReadManiac will vibrate and show a message every time this
perriod passes (You don't want to wear a glasses, isn't you ?).

-------------------

3.3. Fonts menu

-------------------

 Here you can select from 4 standard fonts, 4 build-in fonts
and up to 10 user-installed fonts.

 "Std XXX" are phone's standard fonts. 

 "5x3", "5x4" and "6x4 CYR" are RadManiac fonts with "Windows: Cyrilic" charset. 

 "6x4 CE" is ReadManiac font with "Windows: Central europe" charset.

-------------------

3.3.1. User font installation

-------------------

  ReadManiac comes with program for converting Windows fonts into format 
suitable for ReadManiac. On converting fonts, please read documentaion 
for that  program. You should place resulting "*.fnt" files into 
"ReadManiac\storage" directory on MMC card and create text file 
named "fontlist.dat" with the list of file names of user-installed fonts. 
Each line of the file should contain one file name, for example:

FontList.dat:

------ cut ------
myfont5x4.fnt<CR>
smallfont.fnt<CR>
-----------------

* <CR> means new line - do not enter <CR> chars into file


-------------------

3.4. Formatting menu

-------------------

 Here you can change the following options:

Trim CR - remove subsequent line break;

Trim " " - remove subsequent spaces; 

Trim "-" - remove world breaks on line boundaries;

Cuts - break worlds on line boundaries (note that due to program simplicity, 
this will not always be grammatically correct);

Spacing - amount of empty space to add between lines of text (in pixels).

 All this options should be "ON" for optimal usage of small screen space.


-------------------

3.5. Codepage menu

-------------------

 Here you can change CODEPAGE of file encoding. This is usefull only for
standart fonts; Build-in and User-installed font use direct 
[Text file byte] -> [Characted code] encoding (as an exception, DOS-CYRILIC 
can encode for Build-in and User fonts too).


-------------------

3.6. Layout menu

-------------------

 There are two options here:

 Scroller - display scrooll bar on the text page;

 Status - display status bar at bottom of page. 


-------------------

3.7. Bookmarks menu

-------------------

 Here you can set up to 5 bookmarks. If bookmark is set, a "star" symbol
appears at the right side of it. 

 Additional options are:

Goto page... - jump to specified page;

Search... - search for specified string. Search is not case sensetive.
When string is found, select this option second time to continue
search for further occurances.

Furthest - jump to the furthest ever loaded page. This is usually means the
furthest page you read.

Note, that you can access Bookmarks menu directly with left menu key.

-------------------

3.8. Slide show

-------------------

 ReadManiac can turn pages automatically. Keys from 1 to 4 enable
"Slide show" mode with one of the four speeds. Speed 4 is fastest.
Press any other key to turn off "Slide show" mode. 

 If you need additional time to finish reading curent page, 
press "8" to add more 3 seconds for current page's show period.



-------------------

Conclusion

-------------------

  If you have comments, ideas or find bugs in this software, please submit 
them on the following page:
 
http://www.deep-shadows.com/hax/ReadManiac.html


Roman Lut
hax@deep-shadows.com
http://www.deep-shadows.com/hax


 

